@craft-ts/mcp 0.7.0-beta.13 → 0.7.0-beta.16

package/dist/mcp-server.js

@@ -1,3 +1,11 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { findPage, pageUrl, searchPages } from './catalog.js';
@@ -121,8 +129,77 @@ export function createCraftMcpServer(resources) {
             url: `${pageUrl(page.path)}.md`,
         })),
     }));
+    registerStyleTools(server);
     return server;
 }
+const DEFAULT_STYLE_DUMP = 'tmp/craft-style-graph.json';
+const STYLE_REPORT_MODULE = '@craft-ts/dev-tools/style-report';
+const styleReport = async () => {
+    // Resolved at call time, through a specifier this package's own build does
+    // not need to see: `@craft-ts/dev-tools` is a peer of the workspace, not of
+    // the published bundle. An installation without it fails here, with a
+    // message, rather than failing to start.
+    const loaded = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ STYLE_REPORT_MODULE)).catch(() => {
+        throw new Error(`The style tools need '${STYLE_REPORT_MODULE}'. Install @craft-ts/dev-tools alongside this server, or use \`craft-graph --style-matrix\` from the repository instead.`);
+    }));
+    return loaded;
+};
+const DUMP_INPUT = {
+    dumpPath: z
+        .string()
+        .optional()
+        .describe(`Path to the style dump the build plugin writes. Defaults to ${DEFAULT_STYLE_DUMP}.`),
+};
+/**
+ * The style questions, read-only, answered from the emitted dump.
+ *
+ * They call the same functions the CLI calls rather than reimplementing the
+ * queries: one question must not have two answers depending on who asked. The
+ * import is dynamic so that opening the server does not pull the graph
+ * machinery into memory for an agent that only wanted the documentation.
+ */
+function registerStyleTools(server) {
+    const loadDump = async (dumpPath) => {
+        const path = dumpPath ?? DEFAULT_STYLE_DUMP;
+        const { readFile } = await import('node:fs/promises');
+        try {
+            return JSON.parse(await readFile(path, 'utf8'));
+        }
+        catch {
+            throw new Error(`No style dump at '${path}'. It is written by the build plugin: give craftStyle({ dumpPath }) a path and run a build, or pass dumpPath.`);
+        }
+    };
+    server.registerTool('style_impact', {
+        description: 'Which sheet classes a change to one or more CSS custom properties can be seen in. Use it before rerunning a visual suite: changing one token should recapture what reaches it, not everything. Answers `narrowed: false` when a name is unknown to the graph, in which case the answer is the whole application on purpose.',
+        inputSchema: {
+            changed: z
+                .array(z.string().min(1))
+                .min(1)
+                .describe('Custom property names, e.g. --ds-accent'),
+            ...DUMP_INPUT,
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    }, async ({ changed, dumpPath }) => {
+        const { styleImpact } = await styleReport();
+        return toolResult(styleImpact(await loadDump(dumpPath), changed));
+    });
+    server.registerTool('style_matrix', {
+        description: 'What the application costs to capture: the number of visual states per sheet class, the total, the median and the largest. The median and the largest are the two numbers that decide whether matrix reduction is worth opening at all.',
+        inputSchema: { ...DUMP_INPUT },
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    }, async ({ dumpPath }) => {
+        const { styleMatrix } = await styleReport();
+        return toolResult(styleMatrix(await loadDump(dumpPath)));
+    });
+    server.registerTool('style_debt', {
+        description: 'What the style system is owed: escape hatches taken with their stated reason, context obligations required and discharged nowhere, variables declared and never read, and the components no sheet is known to style. Read `extractionGaps` first — the rest is only worth its answer on a complete graph.',
+        inputSchema: { ...DUMP_INPUT },
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    }, async ({ dumpPath }) => {
+        const { styleDebt } = await styleReport();
+        return toolResult(styleDebt(await loadDump(dumpPath)));
+    });
+}
 function serializePage(page) {
     return {
         path: page.path,
@@ -135,9 +212,7 @@ function serializePage(page) {
 }
 function toolResult(result) {
     return {
-        content: [
-            { type: 'text', text: JSON.stringify(result, null, 2) },
-        ],
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
         structuredContent: { result },
     };
 }

package/dist/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,YAAY,GAEb,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,oBAAoB,CAAC,SAA4B;IAC/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAErE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,uQAAuQ;QACzQ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,IAAI,EAAE,CACT,UAAU,CAAC;QACT,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,kMAAkM;QACpM,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACnE,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;iBAC9D,QAAQ,EAAE;iBACV,QAAQ,CACP,sFAAsF,CACvF;YACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACtD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAClC,UAAU,CAAC;QACT,KAAK;QACL,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAC9D,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,6IAA6I;QAC/I,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,qDAAqD,CAAC;SACnE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,UAAU,CAAC;gBAChB,KAAK,EAAE,4BAA4B,IAAI,oCAAoC;aAC5E,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,mHAAmH;QACrH,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACtD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CACzB,UAAU,CAAC;QACT,KAAK;QACL,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE;YACxC,OAAO,EAAE,UAAU;YACnB,KAAK;SACN,CAAC;KACH,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,0LAA0L;QAC5L,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,IAAI,EAAE,CACT,UAAU,CAAC;QACT,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YACnE,IAAI;YACJ,WAAW;YACX,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SACpC,CAAC,CAAC;KACJ,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,oIAAoI;QACtI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,iFAAiF,CAClF;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,mCAAmC,CAAC;SACjD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,UAAU,CAAC;gBAChB,KAAK,EAAE,kBAAkB,IAAI,sBAAsB;gBACnD,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,UAAU,CAAC;gBAChB,KAAK,EAAE,UAAU,IAAI,uBAAuB,SAAS,IAAI;gBACzD,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;aACzC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,0LAA0L;QAC5L,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,IAAI,EAAE,CACT,UAAU,CAAC;QACT,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,iBAAiB;QAC9B,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;SAChC,CAAC,CAAC;KACJ,CAAC,CACL,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,SAAS,aAAa,CAAC,IAAa;IAClC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QACvC,QAAQ,EAAE,IAAI,CAAC,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAe;IACjC,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACjE;QACD,iBAAiB,EAAE,EAAE,MAAM,EAAE;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-ts/mcp",
-  "version": "0.7.0-beta.13",
+  "version": "0.7.0-beta.16",
   "description": "MCP server, Agent Skills, and LLM files for coding agents using @craft-ts/core",
   "author": "Romain Geffrault",
   "license": "MIT",
@@ -32,9 +32,10 @@
     "bundle-docs": "node scripts/bundle-docs.mjs",
     "build": "node scripts/build.mjs",
     "start": "npm run build && node dist/main.js",
-    "test": "vitest run"
+    "test": "vitest run --config vitest.config.mts"
   },
   "dependencies": {
+    "@craft-ts/dev-tools": "^0.7.0-beta.0",
     "@modelcontextprotocol/sdk": "1.26.0",
     "zod": "4.3.6"
   },

package/skills/craft-ts/SKILL.md

@@ -19,7 +19,20 @@ required and must not be introduced just to solve a Craft problem.
    - `craft-ts-routes` — type-safe routes and DI checks
    - `craft-ts-service-migration` — Angular services → `craftService`
    - `migrate-to-craft-ts` — run `craft-migrate`, then finish diagnostics
-   - `craft-ts-effect-v4` — use Effect v4 services, Layers and `queryEffect`
+   - `craft-ts-effect-v4` — use Effect v4 services, Layers, `queryEffect`, and
+     the synchronous-member declaration (`SyncOp` / `computedEffect`)
+   - `craft-ts-style` — the typed design system: sheets, axes, the visual
+     matrix, context obligations
+   - `craft-ts-i18n` — typed catalogues, locale parity, semantic tokens
+
+For a project created by `craft create`, keep the generated development
+surface enabled. Run `npm run logs:server` for the local JSONL ingestion
+server and `npm run registry:mcp` for the browser page MCP bridge; the
+generated `.mcp.json` also registers the Craft guidance and log-reader MCP
+servers. Use Craft `Console.*` for entries that must be searchable through
+`npm run logs:mcp`; raw `console.*` calls stay in the browser or server
+process console. These facilities are development-only and must not be added
+to a production provider graph.
 
 If MCP is not configured, read https://ng-angular-stack.github.io/craft/llms.txt and the `AGENTS.md` snippet in this package (`content/agents.md`).
 
@@ -36,8 +49,22 @@ If MCP is not configured, read https://ng-angular-stack.github.io/craft/llms.txt
   required, and `hydrateCraft` when hydration must be forced or customized.
 - Use `renderCraft` for one isolated SSR request. Create a new render per
   request; never reuse its injector, platform, primitive registry, or history.
-- Keep SSR data behavior explicit with `pendingBlock({ ssr: 'block' | 'fallback' | 'client' })`
+- Keep SSR data behavior explicit with `pendingNode({ ssr: 'block' | 'fallback' | 'client' })`
   or a route-level `ssr` policy. Do not let a suspended source reach SSR
   without a policy.
+- Visual rules live in a `*.style.ts` sheet. Static variation becomes a class
+  the emitter wrote; dynamic variation goes through a typed custom property.
+  Never assemble a class string at render time — the template sets one constant
+  class and a `data-*` attribute. `@craft-ts/style` is a **build step**: without
+  `craftStyle()` from `@craft-ts/style/vite` in the Vite config, the sheets
+  typecheck and emit nothing. Load `craft-ts-style` before touching one.
+- Translations live in a `@craft-ts/i18n` catalogue: `defineCatalog` + `msg` for
+  the reference locale, `defineLocaleLike` for every other one, so a missing key
+  is a compile error. `@craft-ts/i18n` has no framework and no Effect import;
+  use `@craft-ts/i18n-effect` only inside an Effect program. Load
+  `craft-ts-i18n` before adding a key, a locale or a token.
 - Run existing architecture tests. Do not add an architecture rule for the feature.
+- Keep `npm run typecheck` in the project CI; for generated projects this is
+  already wired into `.github/workflows/ci.yml` alongside the architecture
+  and build checks.
 - Confirm symbols against the installed `node_modules/@craft-ts/core`.

package/skills/craft-ts-effect-v4/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: craft-ts-effect-v4
-description: Build Effect v4 integrations in framework-independent CraftTS applications with typed services, Layers, queryEffect and Effect diagnostics. Use when a project selected EffectTS during craft create or when editing Effect domain code.
+description: Build Effect v4 integrations in framework-independent CraftTS applications with typed services, Layers, queryEffect, methodEffect, synchronous members (SyncOp / computedEffect / syncEffect) and Effect diagnostics. Use when a project selected EffectTS during craft create or when editing Effect domain code.
 ---
 
 # CraftTS + Effect v4
@@ -16,6 +16,20 @@ examples copied from older documentation.
   the Craft app config.
 - UI data loading uses `queryEffect`; do not call `Effect.runPromise` from a
   component or bypass the Craft reactive lifecycle.
+- `Effect<A, E, R>` does not say whether running it suspends, and a service
+  member hides it further: a `Layer` closes over its dependencies, so a network
+  call and a pure calculation both surface as `R = never`. Declare the members
+  that never suspend by putting `SyncOp` in their requirements — in the shape
+  when it is written by hand, with `yield* SyncOp` when `R` is inferred.
+- A declared-synchronous Effect is the only one allowed where Craft runs the
+  synchronous driver. Use `computedEffect` for a derived value (the Effect
+  counterpart of `craftComputed`) and `methodEffect` for a callable method (the
+  Effect counterpart of `craftMethod`). Use `syncEffect(...)` directly in a
+  `params`, a `craftMethod` or a `state` updater. Anything that suspends belongs
+  to a `loader`.
+- Never declare `SyncOp` on a member that can suspend. The claim is checked by
+  `craft-ts/sync-effect-body` on the body and by `Effect.runSyncExitWith` at
+  runtime, which throws `CraftEffectNotSynchronous` on the first call.
 - Install `installCraftEffectBridge()` once during bootstrap.
 - Run the Effect diagnostics command from `package.json` after changing an
   Effect generator, service, schema or Layer.

package/skills/craft-ts-i18n/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: craft-ts-i18n
+description: Build and review type-safe internationalisation in a CraftTS project with @craft-ts/i18n — closed key unions, locale parity, typed message parameters, per-locale plural categories, semantic tokens, the reactive translator, and the @craft-ts/i18n-effect adapter. Use when adding a translation, a locale, a token, or when a translation typecheck or i18n:check fails.
+---
+
+# CraftTS type-safe i18n
+
+`@craft-ts/i18n` has **no CraftTS, Angular or Effect import**. The catalogue is
+a plain TypeScript value and the runtime works in a browser, a server, a worker
+or a test without a framework. Do not reach for Effect to translate a string.
+
+The contract it enforces, all at typecheck time:
+
+1. the set of keys is a **closed union** — an unknown key does not compile;
+2. every locale has the **same keys with the same parameters**;
+3. message parameters are **typed by their token**, so a date cannot be passed
+   where a currency amount belongs;
+4. a plural message must carry **every category the locale requires** — Polish
+   needs `one`, `few`, `many`, `other`; French needs `one` and `other`.
+
+## Writing a catalogue
+
+```ts
+import { defineCatalog, defineLocale, defineLocaleLike, money, msg, number, plural } from '@craft-ts/i18n';
+
+const amount = money('amount', undefined, { currency: 'EUR' });
+const count = number('count');
+
+const en = defineLocale('en-US', defineCatalog({
+  order: {
+    total: msg`Order total ${amount}.`,
+    items: plural(count, {
+      one: msg`${count} item is in the order.`,
+      other: msg`${count} items are in the order.`,
+    }),
+  },
+}));
+
+const fr = defineLocaleLike(en, 'fr-FR', { order: { /* same shape */ } });
+```
+
+`msg` is a **tagged template**: the interpolations are tokens, and the params
+type of the message is derived from them. `defineLocale` is for the reference
+locale; every other locale uses `defineLocaleLike(reference, id, catalog)`,
+which is what turns a missing or renamed key into a compile error instead of a
+runtime fallback. Keys nest freely; a key is the dotted path.
+
+## Tokens
+
+Shipped, semantic, and locale-aware through `Intl`: `number`, `integer`,
+`percent`, `compactNumber`, `money`, `dateShort`, `dateLong`, `dateTime`,
+`relativeTime`. Each is a factory — `factory(name, adapter?, options?)` — where
+`name` becomes the parameter name.
+
+For a business value, `defineToken({ name, kind, tokenId, validate, format })`;
+for a family of them, `defineTokenFactory({ kind, format })`. Keep business
+vocabulary in the project, in `src/i18n/project-tokens.ts`, not in the shared
+library.
+
+## The runtime
+
+```ts
+const i18n = createI18nRuntime({ locales, defaultLocale: 'en-US' });
+i18n.t('order.total', { amount: 1234.5 });
+```
+
+- `t` is `translate`; both take the key and, when the message has parameters, a
+  typed params object.
+- `strict` defaults to **on**: every catalogue is validated and every locale is
+  checked for parity against the first one at construction.
+- `setLocale(id)` throws `I18nRuntimeError('LOCALE_NOT_LOADED')` for a locale
+  that was never loaded. Note the current limit: `setLocale` and `loadLocale`
+  are keyed on the ids in `locales`, and a locale listed there already counts as
+  loaded — so list every locale, and treat `createI18nLoader` as the retry-safe
+  cache (it evicts failed loads) rather than as a fully lazy catalogue.
+- `timeZone` belongs on the runtime, not on each call site.
+
+### Reactive translation
+
+`runtime.bind(dependency)` returns a translator whose result re-reads when the
+dependency changes. The dependency is a Craft reader — typically the `state`
+holding the current locale — so a component consumes one service rather than
+building a local binding:
+
+```ts
+return { language, setLocale: language.setLocale, translate: runtime.bind(language) };
+```
+
+`bind(...)('key', params)` returns a generator the template yields, like any
+other Craft reader.
+
+## With Effect
+
+`@craft-ts/i18n-effect` is the adapter, and only the adapter:
+
+- `provideI18nRuntime(runtime)` → `Layer.Layer<I18nEffectService>`;
+- `translateEffect(key, params)` →
+  `Effect.Effect<string, never, I18nEffectService>`.
+
+Same keys, same params, same result as `runtime.t`. Use it inside an Effect
+program; in plain component code, call `t` directly.
+
+**`translateEffect` cannot infer the locales.** It has no value parameter
+carrying them, so called bare its key parameter resolves to `never` and even a
+valid key is rejected. Either pass the type arguments —
+`translateEffect<typeof locales, 'order.total'>(…)` — or bind them once in a
+project-local wrapper, which is the pattern in `/guide/i18n/effect`.
+
+## Checks
+
+- `npm run i18n:check` — catalogue validity and locale parity, outside the
+  typechecker.
+- `npm run i18n:test` — the runtime behaviour.
+
+Run both after touching `src/i18n/`. A failing parity check names the key and
+the locale; add the key rather than loosening the catalogue type.
+
+Full guide: `/guide/i18n/`, `/guide/i18n/catalog`, `/guide/i18n/tokens`,
+`/guide/i18n/runtime`, `/guide/i18n/effect`.

package/skills/craft-ts-style/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: craft-ts-style
+description: Build and review the typed design system of a CraftTS project with @craft-ts/style — palettes, axes, typed custom properties, sheets, context obligations, the visual matrix, and the style_impact / style_matrix / style_debt MCP tools. Use when adding or changing visual rules, a variant, a theme, dark mode, or a visual test.
+---
+
+# CraftTS typed styles
+
+`@craft-ts/style` makes a component's visual surface **derivable** rather than
+guessed: what the exhaustive set of visual states is, which are impossible, and
+whether the context a rule needs exists — all from the same values the CSS is
+emitted from.
+
+## First: is it wired at all?
+
+The system is a **build step**, not a runtime library. Before writing a rule,
+confirm three things exist; without them the sheets typecheck and emit nothing.
+
+1. `@craft-ts/style` in `dependencies`, `@craft-ts/style-testing` in
+   `devDependencies`.
+2. `craftStyle()` from `@craft-ts/style/vite` in the Vite `plugins` array, with
+   a `dumpPath`. The dump is what the graph and the MCP tools below read; no
+   `dumpPath`, no answers.
+3. `import 'virtual:craft-style.css'` once, at the app entry.
+
+A project created by `craft create` already has all three.
+
+## Hard rules
+
+- **Static variation goes to a class the emitter wrote; dynamic variation goes
+  through a typed custom property.** No class is ever assembled in the browser.
+- **A variant is an axis, never a class name.** The template sets one constant
+  class and a `data-*` attribute. `class:` bound to a string, a template
+  literal or a function is a visual state nothing recorded — `no-raw-class`
+  reports it in every file that imports `@craft-ts/style`.
+- **A `*.style.ts` imports vocabulary and nothing else.** That is what makes it
+  safe for the plugin to import it in Node. `style-file-boundary` enforces it.
+- **Components read theme variables, never palette tokens.** The theme is the
+  one place that decides what a variable holds in light and in dark, which is
+  what makes dark mode one rule instead of one per component.
+- **No value is a string.** `space(4)`, `unit.rem(1.5)`, `palette.text.strong` —
+  never `'12px'`. The scales are closed; when a step is missing, add it to the
+  scale. `no-raw-css-value` reports the rest.
+- **`overflow` is not in the property table.** The only road to
+  `overflow-block: auto` is `provides(scrollPort.block)`.
+- **`:has()` is not free-form.** `no-free-has` reports a hand-written one; use
+  the `descendant` axis.
+- Escape hatches — `unsafeLength(value, reason)`, `unsafeAssume(id, reason)` —
+  compile and propagate `unproven` to the graph, where the debt is counted.
+  Take one only with a reason a reader can act on.
+
+## Where things are declared
+
+| you need              | call                                        |
+| --------------------- | ------------------------------------------- |
+| colours               | `definePalette({ group: { token: { light, dark } } })` |
+| viewport breakpoints  | `defineBreakpoints({ md: at.minInlineSize(unit.rem(48)) })` |
+| a state variant       | `defineStateAxis('tone', ['neutral', 'danger'])` |
+| an axis that may only write one kind | `defineAxis(name, values, onlyVarsOfKind(kind.color))` |
+| the size of a box     | `defineContainer({ name, type }, points)`    |
+| typed custom properties | `cssVars('prefix', { ink: kind.color(token) })` |
+| the rules themselves  | `craftStyles('name', { root: [...] }, { axes: [...] })` |
+
+`scheme`, `motion`, `forcedColors`, `contrast`, `scrollState` and `descendant`
+ship with the package and need no declaration.
+
+Two details the types cannot enforce and the browser does:
+
+- a registered `initial-value` must be computationally independent —
+  `kind.length(unit.px(16))`, never `unit.rem(1)`, or the browser drops the
+  `@property` rule silently;
+- `inherits: true` belongs to theme variables and to nothing else.
+
+## Context obligations
+
+`requires(scrollPort.block)` on a class travels up the tree until a
+`provides(...)` answers it, and becomes an error only where a component seals
+(`{ seals: [true] }`) or `seal(node)` closes it. Put the provider on the layout
+component that owns the area — an `overflow` on the direct parent creates a
+second scroll port and moves the bug instead of fixing it.
+
+Level 3 is a **per-route** guarantee. One component in the path handing back a
+loosely typed subtree stops the requirement travelling, and a partial adoption
+gives zero of the guarantee, not most of it.
+
+## Testing
+
+```ts
+import { applyScenario, visualMatrix } from '@craft-ts/style-testing';
+
+for (const scenario of visualMatrix(sheet)) {
+  await applyScenario(page, scenario);
+  await expect(page).toHaveScreenshot(`${scenario.id}.png`);
+}
+```
+
+`visualMatrix` takes **sheets**, not a component. `assertExhaustiveVisualMatrix`
+fails in both directions: a baseline nothing produces any more is as wrong as a
+missing one.
+
+## Asking the graph
+
+Three MCP tools read the dump, so you do not have to write a script:
+
+- `style_impact` — which classes a change to given custom properties reaches.
+  Run it before rerunning a visual suite; changing one token should not
+  recapture everything.
+- `style_matrix` — what the app costs to capture, with the median and the
+  largest. Those two numbers decide whether matrix reduction is worth opening.
+- `style_debt` — escape hatches with their reasons, obligations discharged
+  nowhere, variables never read, components no sheet is known to style. Read
+  `extractionGaps` first; the rest is only meaningful on a complete graph.
+
+An empty `style_matrix` is the signature of a missing `dumpPath`.
+
+Full guide: `/guide/style/setup`, `/guide/style/define`, `/guide/style/tokens`,
+`/guide/style/variants`, `/guide/style/obligations`, `/guide/style/testing`.