feat(web): adopt native tooling and Intent skills

.changeset/fresh-ui-intent.md

@@ -0,0 +1,7 @@
+---
+"@inkcre/ui-web": minor
+---
+
+Give the web package first-class Oxc and native TypeScript development
+workflows, and replace the non-discoverable `agent-skills/` folders with the
+installed, validated `@inkcre/ui-web#ui-web` TanStack Intent skill.

.gitignore

@@ -6,9 +6,10 @@ yarn.lock
 
 # IDE files
 .vscode/*
-!.vscode/*.example.jsonc
-!.vscode/*.code-snippets
-!.vscode/extensions.json
+!.vscode/*.example.jsonc
+!.vscode/*.code-snippets
+!.vscode/extensions.json
+!.vscode/settings.json
 
 # temp files
 tmp
@@ -29,4 +30,4 @@ coverage/
 
 # images
 *.png
-*.jpg
+*.jpg

.vscode/extensions.json

@@ -1,11 +1,11 @@
 {
     "recommendations": [
         "Vue.volar",
-        "esbenp.prettier-vscode",
+        "oxc.oxc-vscode",
         "mrmlnc.vscode-scss",
         "lokalise.i18n-ally",
         "antfu.iconify",
         "antfu.unocss",
         "vitest.explorer"
     ]
-}
+}

.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.oxc": "explicit"
+  },
+  "js/ts.tsdk.path": "node_modules/typescript/lib",
+  "js/ts.tsdk.promptToUseWorkspaceVersion": true,
+  "oxc.fixKind": "safe_fix",
+  "oxc.requireConfig": true
+}

package.json

@@ -8,7 +8,7 @@
     "build": "pnpm --filter @inkcre/ui-web build",
     "build-tokens": "tsx scripts/build-tokens.ts",
     "build-package-metadata": "tsx scripts/build-package-metadata.ts",
-    "build-skills": "tsx scripts/build-agent-skills.ts",
+    "build-skills": "pnpm --filter @inkcre/ui-web skill:generate",
     "generate": "pnpm build-tokens && pnpm build-package-metadata && pnpm build-skills",
     "check:generated": "tsx scripts/check-generated.ts",
     "check:stories": "tsx scripts/check-story-coverage.ts",
@@ -21,10 +21,11 @@
     "test": "pnpm --filter @inkcre/ui-web test",
     "story": "pnpm --filter @inkcre/ui-web story:build",
     "story:dev": "pnpm --filter @inkcre/ui-web story:dev",
-    "format": "oxfmt .oxfmtrc.json package.json pnpm-workspace.yaml tsconfig.json scripts packages/web/package.json packages/web/component-manifest.json packages/web/component-manifest.schema.json packages/web/tsconfig.json packages/web/tsconfig.check.json packages/web/tsconfig.exports.json packages/web/vite.config.js packages/web/vite.subpaths.config.js packages/web/vitest.config.ts packages/web/histoire.config.ts packages/web/stories .github/workflows/*.yml README.md",
-    "format:check": "pnpm format --check",
-    "lint": "oxlint --quiet scripts packages/web/src packages/web/stories packages/web/histoire.config.ts packages/web/vite.config.js packages/web/vite.subpaths.config.js packages/web/vitest.config.ts",
-    "check": "pnpm format:check && pnpm lint && pnpm check:generated && pnpm check:stories && pnpm check:token-workflow && pnpm type-check && pnpm test && pnpm build && pnpm check:package && pnpm story",
+    "check:skills": "pnpm --filter @inkcre/ui-web skill:generate:check && pnpm --filter @inkcre/ui-web skill:validate",
+    "format": "oxfmt .oxfmtrc.json package.json pnpm-workspace.yaml tsconfig.json scripts .github/workflows/*.yml README.md && pnpm --filter @inkcre/ui-web format",
+    "format:check": "oxfmt --check .oxfmtrc.json package.json pnpm-workspace.yaml tsconfig.json scripts .github/workflows/*.yml README.md && pnpm --filter @inkcre/ui-web format:check",
+    "lint": "oxlint --deny-warnings scripts && pnpm --filter @inkcre/ui-web lint",
+    "check": "pnpm format:check && pnpm lint && pnpm check:generated && pnpm check:skills && pnpm check:stories && pnpm check:token-workflow && pnpm type-check && pnpm test && pnpm build && pnpm check:package && pnpm story",
     "changeset": "changeset",
     "changeset:add": "changeset add",
     "changeset:version": "changeset version && pnpm build-package-metadata",

packages/web/.oxfmtrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../node_modules/oxfmt/configuration_schema.json",
+  "ignorePatterns": [
+    "src/components.d.ts",
+    "src/public-components.ts",
+    "src/version.ts",
+    "styles/tokens/**",
+    "styles/uno/preset-ink.ts"
+  ]
+}

packages/web/.oxlintrc.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "../../node_modules/oxlint/configuration_schema.json",
+  "plugins": ["eslint", "oxc", "typescript", "unicorn", "vue", "vitest"],
+  "options": {
+    "denyWarnings": true,
+    "reportUnusedDisableDirectives": "error"
+  },
+  "overrides": [
+    {
+      "files": ["src/components/inkPicker/inkPicker.vue"],
+      "rules": {
+        "vue/valid-define-emits": "off",
+        "vue/valid-define-props": "off"
+      }
+    }
+  ]
+}

packages/web/MIGRATION.md

@@ -24,6 +24,27 @@ peer for `InkJsonEditor`; consumers do not import it directly, but their
 package manager must resolve it in the installation graph. Execution 06 must
 verify this through the committed consumer lockfile and frozen installation.
 
+## Installed Agent Skill
+
+The non-discoverable `agent-skills/` documentation path is replaced by one
+TanStack Intent skill at `skills/ui-web`. No compatibility mirror is shipped:
+known consumers did not use the old path, and preserving it would double the
+generated stale-output surface without creating an Intent contract.
+
+Consumers that want agent guidance explicitly allowlist the trusted package:
+
+```json
+{
+  "intent": {
+    "skills": ["@inkcre/ui-web"]
+  }
+}
+```
+
+Then load the installed skill with
+`intent load @inkcre/ui-web#ui-web`. This changes packaged documentation only;
+it does not add a runtime JavaScript export.
+
 ## Compatibility and rollback
 
 - `@inkcre/web-design@1.2.2` is the immutable rollback artifact. It will not be

packages/web/README.md

@@ -14,12 +14,12 @@ pnpm add @inkcre/ui-web
 
 ```typescript
 // main.ts
-import { createApp } from 'vue'
-import InKCreUIWeb from '@inkcre/ui-web'  // optional
-import "@inkcre/ui-web/styles" // must
+import { createApp } from "vue";
+import InKCreUIWeb from "@inkcre/ui-web"; // optional
+import "@inkcre/ui-web/styles"; // required once
 
-const app = createApp(App)
-app.use(InKCreUIWeb)
+const app = createApp(App);
+app.use(InKCreUIWeb);
 ```
 
 ```scss
@@ -59,11 +59,15 @@ export default defineConfig({
 
 ### Use routing
 
-InkHeader and some other components can integrate with your router. See `agent-skills/router/SKILL.md` for setup instructions.
+InkHeader and other components can consume a router adapter. Load
+`@inkcre/ui-web#ui-web` through TanStack Intent and read
+`references/integration.md` for the package boundary.
 
 ### Use internationalization (i18n)
 
-The design system supports internationalization. See `agent-skills/i18n/SKILL.md` for setup instructions with vue-i18n.
+The design system supports internationalization through the same adapter
+boundary. The installed UI skill documents the provider contract and locale
+subpath.
 
 ## Features
 
@@ -77,6 +81,24 @@ The design system supports internationalization. See `agent-skills/i18n/SKILL.md
 
 ## Agent Skills
 
-The package includes [Agent Skills](https://agentskills.io) - standardized packages of domain expertise that AI agents can discover and load dynamically. Located in `agent-skills/`, component skills are automatically generated from source code during the build process.
+The package ships one progressively disclosed Agent Skill under
+`skills/ui-web`. Consumers explicitly trust the package through
+`package.json#intent.skills`, then discover and load it with the pinned
+[TanStack Intent](https://tanstack.com/intent) CLI:
 
-Skills work with Claude Code, GitHub Copilot, and other AI agents supporting the agentskills.io standard.
+```json
+{
+  "intent": {
+    "skills": ["@inkcre/ui-web"]
+  }
+}
+```
+
+```bash
+intent list
+intent load @inkcre/ui-web#ui-web
+```
+
+The generated component facts come from the public component manifest and
+source/story contracts. Selection and composition guidance is reviewed in
+`skill.seed.json`.