Initial commit: GitHub TypeScript composite action

- Complete action.yml with all github-script passthrough inputs
- Biome configuration for linting and formatting
- Comprehensive README with usage examples
- CI workflow with self-testing
- Example scripts for basic usage and utils integration

Author: tkstang

.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Run Biome
+        run: pnpm run check
+
+  test-action:
+    name: Test Action
+    runs-on: ubuntu-latest
+    needs: lint
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Create test script
+        run: |
+          mkdir -p .github/scripts
+          cat > .github/scripts/test.ts << 'EOF'
+          export default async function run({ core, context, args }) {
+            core.info('Test script running!');
+            core.info(`Context: ${context.eventName}`);
+            core.info(`Args: ${JSON.stringify(args)}`);
+            return {
+              success: true,
+              eventName: context.eventName,
+              args
+            };
+          }
+          EOF
+
+      - name: Test the action
+        id: test
+        uses: ./
+        with:
+          ts-file: .github/scripts/test.ts
+          args: '{"message":"Hello from test!","timestamp":"${{ github.event.head_commit.timestamp || github.run_id }}"}'
+
+      - name: Verify result
+        run: |
+          echo "Action result: ${{ steps.test.outputs.result }}"
+          # Parse and verify the JSON result contains expected fields
+          echo '${{ steps.test.outputs.result }}' | jq -e '.success == true'
+          echo '${{ steps.test.outputs.result }}' | jq -e '.eventName'
+          echo '${{ steps.test.outputs.result }}' | jq -e '.args.message == "Hello from test!"'

.gitignore

@@ -0,0 +1,42 @@
+# Dependencies
+node_modules/
+pnpm-lock.yaml
+
+# Build outputs
+dist/
+.github-script-build/
+
+# Runtime/cache
+.cache/
+tmp/
+temp/
+
+# IDE
+.cursor/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Coverage reports
+coverage/
+*.lcov
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local

.nvmrc

@@ -0,0 +1 @@
+22

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tkstang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.