v1 rewrite: context-first GSAP integration for modern Angular

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint, test, build
+        run: pnpm nx run-many -t lint test build

.github/workflows/deploy-docs.yml

@@ -0,0 +1,54 @@
+name: Deploy docs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build docs
+        run: pnpm nx build docs
+        env:
+          DOCS_BASE: /angular-gsap/
+
+      - name: SPA fallback
+        run: cp dist/apps/docs/analog/public/index.html dist/apps/docs/analog/public/404.html
+
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: dist/apps/docs/analog/public
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,9 +1,9 @@
-# See http://help.github.com/ignore-files/ for more about ignoring files.
+# See https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files for more about ignoring files.
 
 # compiled output
 dist
 tmp
-/out-tsc
+out-tsc
 
 # dependencies
 node_modules
@@ -39,4 +39,18 @@ testem.log
 Thumbs.db
 
 .nx/cache
+.nx/workspace-data
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md
+
 .angular
+.claude/settings.local.json
+.claude/worktrees
+.playwright-mcp
+
+vite.config.*.timestamp*
+vitest.config.*.timestamp*
+
+.nx/polygraph
+.nx/self-healing
+.nx/migrate-runs

.prettierignore

@@ -2,4 +2,7 @@
 /dist
 /coverage
 /.nx/cache
+/.nx/workspace-data
 .angular
+
+.nx/self-healing

.verdaccio/config.yml

@@ -0,0 +1,28 @@
+# path to a directory with all packages
+storage: ../tmp/local-registry/storage
+
+# a list of other known repositories we can talk to
+uplinks:
+  npmjs:
+    url: https://registry.npmjs.org/
+    maxage: 60m
+
+packages:
+  '**':
+    # give all users (including non-authenticated users) full access
+    # because it is a local registry
+    access: $all
+    publish: $all
+    unpublish: $all
+
+    # if package is not available locally, proxy requests to npm registry
+    proxy: npmjs
+
+# log settings
+log:
+  type: stdout
+  format: pretty
+  level: warn
+
+publish:
+  allow_offline: true # set offline to true to allow publish offline

.vscode/extensions.json

@@ -3,6 +3,7 @@
     "nrwl.angular-console",
     "esbenp.prettier-vscode",
     "dbaeumer.vscode-eslint",
+    "ms-playwright.playwright",
     "firsttris.vscode-jest-runner"
   ]
 }

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug api with Nx",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": ["nx", "serve", "api"],
+      "env": {
+        "NODE_OPTIONS": "--inspect=9229"
+      },
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": ["<node_internals>/**"],
+      "sourceMaps": true,
+      "outFiles": [
+        "${workspaceFolder}/apps/api/dist/**/*.(m|c|)js",
+        "!**/node_modules/**"
+      ]
+    }
+  ]
+}

AGENTS.md

@@ -0,0 +1,10 @@
+# angular-gsap: agent notes
+
+Nx monorepo, pnpm 11 (corepack). Two projects:
+
+- `libs/core`: the published package `@angular-gsap/core`. Principle: own lifecycle (scope, cleanup, signals, SSR), never wrap the GSAP API itself.
+- `apps/docs`: docs/examples app (Analog): `pnpm nx serve docs`.
+
+Commands: `pnpm nx run-many -t lint test build` (what CI runs), `pnpm nx test core`.
+
+Conventional Commits (`feat(core): …`); releases via `nx release`.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to angular-gsap
+
+Thanks for helping out! This is an Nx monorepo managed with pnpm.
+
+## Setup
+
+```sh
+corepack enable        # or install pnpm 11 yourself
+pnpm install
+```
+
+## Layout
+
+| Path        | What it is                                      |
+| ----------- | ----------------------------------------------- |
+| `libs/core` | The published package, `@angular-gsap/core`     |
+| `apps/docs` | Docs & examples app, built with Analog (`pnpm nx serve docs`) |
+
+## Everyday commands
+
+```sh
+pnpm nx serve docs              # run the docs/examples app (Analog)
+pnpm nx test core               # unit tests (vitest)
+pnpm nx build core              # build the publishable package
+pnpm nx run-many -t lint test build   # what CI runs
+```
+
+## Guidelines
+
+- The core principle of this library: **own lifecycle, never wrap GSAP's API.**
+  PRs that re-expose `gsap.to`/`from`/`timeline` as directives or wrappers will
+  be declined; that pattern goes stale against GSAP's release cadence.
+- Keep `libs/core` free of dependencies beyond `@angular/*`, `gsap`, and `tslib`.
+- Every behavior change needs a spec in `libs/core/src/lib/*.spec.ts`.
+- Commit messages follow [Conventional Commits](https://www.conventionalcommits.org)
+  (`feat(core): …`, `fix(docs): …`). Releases and changelogs are generated from them.
+
+## Releasing (maintainers)
+
+Versioning, changelog, and publishing are handled by [`nx release`](https://nx.dev/docs/features/manage-releases):
+
+```sh
+pnpm nx release --dry-run   # preview version bump + changelog
+pnpm nx release             # version, changelog, tag, publish to npm
+```
+
+Publishing requires an npm token with access to the `@angular-gsap` scope.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luis Castro and angular-gsap contributors
+
+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.