@astralkit/mcp 1.4.0 → 1.6.0

package/dist/api.d.ts

@@ -51,6 +51,14 @@ export declare function listComponents(params?: {
     offset?: number;
 }): Promise<ComponentListResponse>;
 export declare function getComponent(slug: string, framework?: string): Promise<ComponentDetailResponse>;
+export interface CategoryListResponse {
+    categories: {
+        slug: string;
+        name: string;
+        count: number;
+    }[];
+}
+export declare function getCategories(): Promise<CategoryListResponse>;
 export declare function listBoosters(params?: {
     framework?: string;
     search?: string;

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAMA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,QAkB7D;AAED,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AAsDD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAEtD;AAED,wBAAsB,cAAc,CAAC,MAAM,GAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQtC;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAgB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAE9G;AAED,wBAAsB,YAAY,CAAC,MAAM,GAAE;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,GAAG,CAAC,CAKpB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,CAEzF"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAMA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,QAkB7D;AAED,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AAsDD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAEtD;AAED,wBAAsB,cAAc,CAAC,MAAM,GAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQtC;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAgB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAE9G;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAEnE;AAED,wBAAsB,YAAY,CAAC,MAAM,GAAE;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,GAAG,CAAC,CAKpB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,CAEzF"}

package/dist/api.js

@@ -35,8 +35,8 @@ async function request(path) {
     const url = `${apiBase}${path}`;
     const headers = {
         'Accept': 'application/json',
-        'User-Agent': '@astralkit/mcp/1.0.0',
-        'X-AstralKit-CLI': 'mcp-1.0.0',
+        'User-Agent': '@astralkit/mcp/1.6.0',
+        'X-AstralKit-CLI': 'mcp-1.6.0',
     };
     if (apiKey) {
         headers['x-api-key'] = apiKey;
@@ -98,6 +98,9 @@ export async function listComponents(params = {}) {
 export async function getComponent(slug, framework = 'react') {
     return request(`/api/cli/components/${encodeURIComponent(slug)}?framework=${encodeURIComponent(framework)}`);
 }
+export async function getCategories() {
+    return request('/api/cli/categories');
+}
 export async function listBoosters(params = {}) {
     const qs = new URLSearchParams();
     if (params.framework)

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,IAAI,OAAO,GAAW,gBAAgB,CAAC;AAEvC,MAAM,UAAU,SAAS,CAAC,GAAkB,EAAE,OAAgB;IAC5D,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,WAAW,GACf,MAAM,CAAC,QAAQ,KAAK,WAAW;gBAC/B,MAAM,CAAC,QAAQ,KAAK,WAAW;gBAC/B,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC;YAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC;gBAClF,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;gBAC/F,OAAO;YACT,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAChC,MAAM,OAAO,GAA2B;QACtC,QAAQ,EAAE,kBAAkB;QAC5B,YAAY,EAAE,sBAAsB;QACpC,iBAAiB,EAAE,WAAW;KAC/B,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;IAChC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAEzE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,QAAQ,CAAC,2CAA2C,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,gEAAgE,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;IAC3G,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,sEAAsE,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;IACnH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,qEAAqE,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IACjH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAErF,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,WAAW,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACxG,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,GAAG,mBAAmB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAwCD,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAMjC,EAAE;IACJ,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,QAAQ;QAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,SAAS;QAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM;QAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,KAAK;QAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM;QAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,YAAoB,OAAO;IAC1E,OAAO,OAAO,CAAC,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAG/B,EAAE;IACJ,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS;QAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM;QAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,YAAoB,QAAQ;IACzE,OAAO,OAAO,CAAC,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAC7G,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/data/build-standards.d.ts

@@ -0,0 +1,5 @@
+export declare const BUILD_STANDARDS: Record<string, string>;
+export declare const BUILD_STANDARD_TOPICS: string[];
+/** Build the get_build_standards response. No topic -> an index of all topics. */
+export declare function buildStandardsGuide(topic?: string): string;
+//# sourceMappingURL=build-standards.d.ts.map

package/dist/data/build-standards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-standards.d.ts","sourceRoot":"","sources":["../../src/data/build-standards.ts"],"names":[],"mappings":"AAqKA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlD,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAA+B,CAAC;AAYlE,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAa1D"}

package/dist/data/build-standards.js

@@ -0,0 +1,190 @@
+// Structural & non-visual build standards served by the get_build_standards tool
+// and the astralkit://standards resource. The sibling of rules.ts (visual rules):
+// rules.ts covers tokens/colors/spacing/icons; this covers ARCHITECTURE and the
+// states/error/responsive/radix correctness that make an app "built well" vs messy.
+//
+// Source: docs/CODE_ARCHITECTURE_GUIDE.md, docs/empty-states-guide.md,
+// docs/empty-states-engagement-guide.md, docs/error-handing.md, the radix-research
+// bank, and src/sdk/astralkit/ai-rules.md. Principles kept verbatim; every code
+// example is written in AstralKit conventions (ak-* tokens, Phosphor icons,
+// the existing atoms/empty-state.tsx) so this never contradicts get_coding_standards.
+const ARCHITECTURE = `# Architecture & Separation of Concerns
+
+The golden test for every file/function/component: "Can I describe what this does in ONE sentence WITHOUT using 'and'?" If not, split it.
+
+## Atomic design (and the import rule)
+- atoms — smallest building blocks, zero business logic, self-contained (Button, Input, Badge, Spinner, Avatar). Import NOTHING.
+- molecules — 2-4 atoms forming one unit (SearchInput, FormField, NavLink). Import atoms only.
+- organisms — full sections (Header, Sidebar, DataTable, PricingCard, LoginForm). Import atoms + molecules.
+- templates — page layout with slots, no real data.
+- pages — route files (Next.js app/), wire data to templates/organisms.
+RULE: never skip levels upward. An atom CANNOT call an API. An organism is NOT composed entirely of other organisms — prefer composition of smaller parts.
+
+## Separation of concerns — data flows in ONE direction
+Routes -> Services -> Repositories -> Database. Components -> Hooks -> Services. Never sideways, never upward.
+- page.tsx is THIN (wire data + compose; aim < 50 lines). It does not hold business logic.
+- Hooks hold logic, never return JSX. Extract a hook when useState+useEffect do one "thing", logic is reusable, or the file grows from logic (not JSX).
+- Services hold business rules; they call repositories, never the DB/Prisma directly; framework-agnostic (no React).
+- Repositories are the ONLY place DB calls happen; one per entity; map DB types to your own types at the boundary (don't let Prisma types leak through the app).
+- utils are PURE functions (same input -> same output, no side effects), categorized by kind (formatters/validators/transformers/helpers) — never a junk-drawer utils.ts.
+
+## Composition over inheritance
+Build complex UI by combining simple parts, not a god-component with 8 boolean props. Prefer compound components (Card + Card.Header + Card.Content) and asChild composition over prop explosions.
+
+## Presentational vs container
+Presentational (dumb): all data via props, no fetching, no business logic, only UI state (isOpen). Container/hook (smart): fetch, manage state, handle logic, pass down. This is what makes a component reusable and testable.
+
+## File-size limits (hard)
+component 150 · hook 100 · service 200 · repository 150 · utility 100 · ANY file 300 = STOP and refactor now. Approaching a limit means a sub-component, a hook, or a util wants to be extracted.
+
+## Naming & imports
+PascalCase components; 'use' prefix hooks; 'Service'/'Repository' suffixes; SCREAMING_SNAKE constants; 'handle' event handlers; is/has/can/should booleans. Import order: framework -> third-party -> '@/' aliases -> relative -> types. Barrel-export each component folder (index.ts) and import from the barrel, never reach into internals.`;
+const REFACTORING = `# Refactoring a Messy App (do this, don't rewrite)
+
+The #1 way AI makes things worse: rewriting a working file "more cleanly" and changing behavior. Don't.
+
+## Golden rules
+- MOVE code, don't REWRITE it. Copy-paste EXACT blocks into new files.
+- Small bites. ONE area at a time. Verify before moving on.
+- Do NOT rename, "optimize", or "clean up" while moving. Do NOT refactor multiple areas at once.
+
+## The incremental process
+1. SURVEY — list every area that needs work, group into scopes, estimate complexity. Don't start yet.
+2. PRIORITIZE — start with scopes that have NO dependencies on others; save the interconnected pieces for last.
+3. REFACTOR ONE SCOPE — analyze (list concerns + line numbers), extract one concern at a time (exact copy + only necessary imports), verify it still works.
+4. CHECKPOINT — stop, report what moved, confirm it works, then continue.
+
+## What a "scope" is
+The smallest independently-refactorable unit: "the top nav bar", "the user avatar dropdown", "one form", "one data table", "one service". NOT "the entire header" or "all the modals". If a scope has > 3 components, > 2 hooks, > 200 lines, or > 5 new files — split it further.
+
+## Must stay identical while refactoring
+Function signatures, component props + types, state logic, API patterns, error handling, the rendered JSX, classNames/styling, conditional logic. If you're changing any of these, you're rewriting, not refactoring — stop.
+
+## Red flags (stop if you catch yourself)
+Rewriting a function "more efficiently", changing state management, altering prop shapes, "improving" patterns, or touching something unrelated. When two scopes seem tightly coupled or a scope is bigger than expected — pause and ask.
+
+End state: when you need to change how something works, you touch ONE file.`;
+const STATE_LIFECYCLE = `# The Four-State Contract
+
+EVERY component that renders data (a list, table, feed, card-grid, detail view) must handle all four states. This is the single biggest "looks unfinished / looks broken" tell.
+
+1. LOADING — a skeleton that matches the shape of the real content (not a centered spinner for page content).
+2. EMPTY — a real empty state (see the empty-states topic), never blank space.
+3. ERROR — a recovery UI with an action (see the error-handling topic), never a raw error or a white screen.
+4. POPULATED — the data.
+
+Build the EMPTY and ERROR states FIRST, before the populated state — they are part of the component's contract, not an afterthought.
+
+The shape, every time:
+    if (isLoading) return <Skeleton />
+    if (isError)   return <ErrorState onRetry={refetch} />
+    if (!data?.length) return <EmptyState ... />
+    return <List data={data} />
+
+Anti-pattern (the "Ghost"): {data.length > 0 && <List/>} with no else branch — the user sees blank space and assumes the app is broken. Always render an explicit empty/loading branch.`;
+const EMPTY_STATES = `# Empty States
+
+An empty state is a UX moment, not a placeholder. It answers: what's happening, why, and what to do next.
+
+## Five types — never reuse one design for all
+1. First-use (zero data) — your onboarding moment. Frame as "ready to begin", not "no data".
+2. User-cleared — they removed everything. Celebrate completion or offer undo.
+3. No results — search/filter returned nothing. MUST echo the query ("No results for 'invoic'", not "Nothing here").
+4. Error — data should exist but failed. Icon (not illustration), and ALWAYS a recovery action.
+5. Conditional/positive — "No issues found", "All caught up" — a good thing; say so.
+
+## Anatomy (centered in its container, max-w ~28rem text)
+visual (icon or illustration) -> title (what's happening) -> description (why + what to do) -> primary CTA -> optional secondary. Reuse the existing component: src/components/atoms/empty-state.tsx.
+
+## Messaging
+Formula: title = state what's empty; description = why OR what to do + the benefit; CTA = verb + object ("Create project", not "Click here"). Be human, helpful, specific, encouraging, action-oriented. Headline can carry light brand personality; description stays informative.
+
+## Voice — match the emotional temperature
+Don't use the same cheerfulness for an error and a celebration. First-use = warm/encouraging; no-results = neutral/helpful; error = calm/reassuring ("your work is safe, this is on our end"); all-done = briefly celebratory.
+
+## Visual
+Illustration for first-use and positive/celebration and full-page states; icon-only for errors, table/inline empties, and states the user sees often. Keep it on-brand (ak-* colors, no new palette). Subtle entrance animation signals "intentional, not broken" — honor prefers-reduced-motion.
+
+## Seven anti-patterns to avoid
+- Naked Empty: "No data" with no context or path. - Apologizer: "Oops! So sorry!". - Blamer: "You haven't added anything yet". - Dead End: states the problem, no CTA. - Novel: a wall of text. - Confuser: "Error 500 / ECONNREFUSED". - Ghost: rendering nothing at all when empty.`;
+const ERROR_HANDLING = `# Error Handling
+
+Three principles: never show raw errors to users; always provide a path forward; fail gracefully and recover automatically where possible. Every error must answer the user's three questions: what happened, is it my fault, what do I do now.
+
+## Classify, then map to a recovery
+- Network/offline -> "You're offline. Check your connection." -> Retry.
+- Timeout / 5xx / 503 -> "Taking longer than expected / temporarily unavailable." -> auto-retry with exponential backoff (1s -> 2s -> 4s, max 3), then a Retry button + status link.
+- 401 / session expired -> redirect to login (preserve the intended destination).
+- 403 -> "You don't have permission." -> go back / contact admin.
+- 404 (user action) -> "This item doesn't exist or was removed." -> go back / search.
+- 400 / validation -> inline field errors (NOT a toast).
+- 429 -> "Slow down — too many requests." -> countdown.
+
+## Boundaries (Next.js App Router)
+Error boundary hierarchy: Root -> Layout -> Page -> Section -> Component — a broken chart must NEVER crash the nav. Every route ships error.tsx + loading.tsx (and not-found.tsx where relevant). Isolate non-critical sections in their own boundary with a fallback so the rest of the page keeps working.
+
+## Rules
+- Never an empty catch: catch (e) {} is forbidden — every catch logs AND updates the UI.
+- Never alert() — use a toast (react-hot-toast / Sonner / Radix Toast). Error toasts do NOT auto-dismiss (manual close); success/info auto-dismiss ~4s; max ~3 at once.
+- Retry network/5xx, NEVER 4xx.
+- Forms: inline errors with aria-invalid + aria-describedby; on submit failure, focus the first error field; preserve the user's input; prevent double-submit.
+- Error UI anatomy: title (plain) + description (is it my fault?) + primary action + optional error ID for support. Use role="alert" / aria-live for dynamic errors.
+
+Empty state vs error state: empty = no data yet, encouraging/forward-looking. Error = data should exist but failed, calm/recovery-focused. Don't confuse them.`;
+const RESPONSIVE = `# Responsive & Mobile Navigation
+
+Mobile-first: unprefixed classes are the mobile base; add complexity upward with md:/lg:. Type scales UP, never down. 48px touch targets (min-h-ak-control-lg). No horizontal scroll on mobile. Test at 375 / 390 / 768 / 1280.
+
+## The AstralKit layout-primitive trap
+ak-stack / ak-cluster / ak-grid / ak-switcher already set display. A naive md:hidden / md:flex on top of them fights the primitive. Wrap-then-toggle the wrapper, don't toggle display on the primitive itself.
+
+## Navigation by breakpoint (every nav needs a mobile answer)
+- Top bar: desktop = inline links. Mobile = a hamburger that opens a drawer. The desktop links MUST be hidden behind it (e.g. nav links 'hidden md:flex', hamburger 'md:hidden'). A top bar with desktop links and NO mobile menu is the most common responsiveness bug.
+- Mobile menu: a Radix Dialog used as a sheet (w-[85vw] max-w-sm, slides from the side), not a fragile custom dropdown. Trap focus, close on route change and Escape.
+- Mega-menu: full panel on desktop; collapse to a stacked accordion (<details> or a Radix Accordion) inside the mobile drawer.
+- Sidebar: persistent on desktop; on mobile it becomes the drawer (full replacement), toggled by the hamburger.
+
+Confirm the mobile menu actually exists and is reachable — most AI-built navs ship desktop-only.`;
+const RADIX = `# Radix UI Correctness
+
+AstralKit overlays/menus/forms build on Radix primitives. The common failures:
+
+- asChild / Slot: use asChild to merge a primitive's behavior onto YOUR styled element (e.g. <DialogTrigger asChild><Button>…</Button></DialogTrigger>) — exactly one child, which must forward props/ref. Don't double-wrap (a styled button inside a styled button).
+- Dialog/AlertDialog a11y: every Dialog needs a Title (visually-hidden if there's no visible heading) and a description or aria-describedby — otherwise screen readers announce nothing and Radix warns.
+- Focus management: Radius traps focus inside an open overlay and restores it on close. Don't fight it; use onOpenAutoFocus / onCloseAutoFocus to retarget focus deliberately, not to disable it. Keep visible focus rings.
+- Portal + theme: Radix renders overlays in a Portal at <body>, OUTSIDE your themed tree — so the AstralKit theme/dark-mode class may not reach it. Wrap portalled content in the theme context (or apply the data-ak-theme on the portal container) or dropdowns/dialogs render unthemed.
+- Styling: style by state with data-[state=open]/data-[state=checked] attributes, not by toggling classes in JS.
+- Versions: keep all @radix-ui/* (or the unified radix-ui) on one resolved version — mismatched primitive + react versions cause focus/dismiss bugs.`;
+export const BUILD_STANDARDS = {
+    architecture: ARCHITECTURE,
+    refactoring: REFACTORING,
+    'state-lifecycle': STATE_LIFECYCLE,
+    'empty-states': EMPTY_STATES,
+    'error-handling': ERROR_HANDLING,
+    responsive: RESPONSIVE,
+    radix: RADIX,
+};
+export const BUILD_STANDARD_TOPICS = Object.keys(BUILD_STANDARDS);
+const TOPIC_BLURBS = {
+    architecture: 'atomic design, separation of concerns, layers, file-size limits, naming',
+    refactoring: 'the safe incremental process for cleaning up a messy app (move, don\'t rewrite)',
+    'state-lifecycle': 'the loading/empty/error/populated contract every data component must handle',
+    'empty-states': 'the 5 empty-state types, messaging, voice, and 7 anti-patterns',
+    'error-handling': 'error classification, boundaries, toasts, retries, never-empty-catch',
+    responsive: 'mobile-first rules + the mobile-menu / mega-menu navigation patterns',
+    radix: 'correct Radix usage: asChild, focus, portal theming, a11y, versions',
+};
+/** Build the get_build_standards response. No topic -> an index of all topics. */
+export function buildStandardsGuide(topic) {
+    if (topic && BUILD_STANDARDS[topic])
+        return BUILD_STANDARDS[topic];
+    const index = BUILD_STANDARD_TOPICS.map(t => `- ${t} — ${TOPIC_BLURBS[t]}`).join('\n');
+    const unknown = topic ? `\n\n(No topic "${topic}". Returning the index.)` : '';
+    return (`# AstralKit Build Standards\n\n` +
+        `Structural & correctness rules that make an app "built well", not just visually polished. ` +
+        `Call get_build_standards with one topic to get that section:\n\n${index}\n\n` +
+        `These complement get_coding_standards (visual rules) and polish_ui (visual revamp). ` +
+        `For per-screen-type guidance (dashboard, nav, pricing, auth…) use get_screen_blueprint. ` +
+        `To audit existing code against these rules, use review_app.${unknown}`);
+}
+//# sourceMappingURL=build-standards.js.map

package/dist/data/build-standards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-standards.js","sourceRoot":"","sources":["../../src/data/build-standards.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,gFAAgF;AAChF,oFAAoF;AACpF,EAAE;AACF,uEAAuE;AACvE,mFAAmF;AACnF,gFAAgF;AAChF,4EAA4E;AAC5E,sFAAsF;AAEtF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gVA8B2T,CAAC;AAEjV,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;4EAwBwD,CAAC;AAE7E,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;wLAiBgK,CAAC;AAEzL,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;sRAwBiQ,CAAC;AAEvR,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;+JAuBwI,CAAC;AAEhK,MAAM,UAAU,GAAG;;;;;;;;;;;;;iGAa8E,CAAC;AAElG,MAAM,KAAK,GAAG;;;;;;;;;qJASuI,CAAC;AAEtJ,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,YAAY,EAAE,YAAY;IAC1B,WAAW,EAAE,WAAW;IACxB,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,YAAY;IAC5B,gBAAgB,EAAE,cAAc;IAChC,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAElE,MAAM,YAAY,GAA2B;IAC3C,YAAY,EAAE,yEAAyE;IACvF,WAAW,EAAE,iFAAiF;IAC9F,iBAAiB,EAAE,6EAA6E;IAChG,cAAc,EAAE,gEAAgE;IAChF,gBAAgB,EAAE,sEAAsE;IACxF,UAAU,EAAE,sEAAsE;IAClF,KAAK,EAAE,qEAAqE;CAC7E,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAEnE,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,KAAK,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,CACL,iCAAiC;QACjC,4FAA4F;QAC5F,mEAAmE,KAAK,MAAM;QAC9E,sFAAsF;QACtF,0FAA0F;QAC1F,8DAA8D,OAAO,EAAE,CACxE,CAAC;AACJ,CAAC"}

package/dist/data/rules.d.ts

@@ -1,2 +1,2 @@
-export declare const CODING_STANDARDS = "# AstralKit Coding Standards\n\n## Setup\n- Package: `astralkit` (npm)\n- CSS: `@import \"astralkit/theme\"; @import \"astralkit/utilities\";` (after Tailwind imports)\n- Tailwind v3 plugin: `require('astralkit/tailwind.cjs')` in tailwind.config\n- Tailwind v4: `@import \"astralkit/theme-v4\"; @import \"astralkit/utilities\";`\n- Icons: `@phosphor-icons/react` exclusively. Never Lucide, Heroicons, or inline SVGs.\n- Fonts: Inter (body), DM Serif Display (display), JetBrains Mono (code)\n\n## Token-First Rule\nALWAYS use `ak-*` tokens. NEVER use arbitrary bracket values.\n```tsx\n// CORRECT\n<div className=\"p-ak-3 gap-ak-2 text-ak-base rounded-ak-lg\">\n// WRONG \u2014 arbitrary values silently collapse in Tailwind v4\n<div className=\"p-[1.5rem] gap-[1rem] text-[16px] rounded-[0.75rem]\">\n```\n\n## Semantic Colors \u2014 No Raw Tailwind\n```tsx\n// CORRECT: bg-ak-surface, text-ak-text, border-ak-border, bg-ak-primary\n// WRONG:   bg-gray-50, text-gray-900, border-gray-200, bg-blue-600\n```\n\n## Typography \u2014 16px Floor\n- Body text, descriptions, nav items, table cells: `text-ak-base` (16px) minimum\n- UI text: `font-medium` minimum \u2014 `font-normal` is for long-form prose only\n- Labels/badges: `text-ak-sm` (14px) or `text-ak-xs` (12px uppercase) acceptable\n- Helper/error text: `text-ak-sm` (14px) is the only exception\n\n## Spacing \u2014 ak-* Tokens Only\n```tsx\n// CORRECT: p-ak-3, gap-ak-2, mb-ak-1_5\n// WRONG:   p-6, gap-4, mb-3\n```\n\n## Icons \u2014 Phosphor Only\n```tsx\nimport { House, Gear } from '@phosphor-icons/react'\n<House size={20} aria-hidden=\"true\" />\n```\n\n## No Inline Styles\nUse Tailwind classes. `style={{}}` only for CSS variables with no Tailwind equivalent.\n\n## No Shadows on Panels/Dropdowns \u2014 Borders Only\nUse `border border-ak-border`. Reserve shadows for modals and elevated cards.\n\n## Motion \u2014 Framer Motion + CSS + Lenis (GSAP not allowed)\nFramer Motion (the MIT `motion` package) IS allowed. Prefer the AstralKit presets from\n`astralkit/motion` (tuned to the motion tokens, reduced-motion-safe). CSS animations are\nalso fine (durations/easings via `duration-ak-*`, `ease-ak-spring`/`bounce`). Use Lenis for\nsmooth scroll. ALWAYS honor `prefers-reduced-motion`. **GSAP is NOT allowed** (license).\n```tsx\nimport { motion, useReducedMotion } from 'motion/react'\nimport { fadeInUp, withReducedMotion } from 'astralkit/motion'\nconst reduced = useReducedMotion()\n<motion.div initial=\"hidden\" animate=\"show\" variants={withReducedMotion(fadeInUp, reduced)} />\n```\n\n## Premium Polish \u2014 Use the Effect Toolkit (with taste)\nAstralKit ships CSS-only premium effects \u2014 reach for them so screens feel designed, not generic:\n- Depth/glow: `ak-card-glow`, `ak-ambient-glow`, `ak-spotlight-card`, `ak-gradient-border`, `ak-text-glow`, `ak-surface-raised`\n- Backgrounds: `ak-mesh-light` / `ak-mesh-dark` / `ak-mesh-astral` (mesh gradients)\n- Motion accents (CSS): `ak-float`, `ak-scroll-fade`, `ak-section-fade`, `ak-sheen`, `ak-press` (tap feedback)\n- Color: tasteful accent (60-30-10); colorful charts use `ak-chart-1`..`ak-chart-6`; curated palettes via `astralkit/palettes`\n- Icons: Phosphor `weight=\"duotone\"` reads richer for feature/marketing icons\n\n### Effect guardrails (use the RIGHT effect on the RIGHT surface)\n- **Glows need dark surfaces.** `ak-text-glow`, `ak-ambient-glow`, and `ak-card-glow` read correctly as LIGHT-on-DARK. On a light background with dark text they look like a muddy smudge \u2014 **do NOT put text-glow on dark text / light backgrounds.**\n- **For dramatic/marketing heroes, go dark.** Add the `dark` class to the section root + `ak-mesh-dark` (tokens auto-flip to dark), light text, and a gradient accent word. This reads more premium than a light hero.\n- **Gradient text accent** (instead of glow): `<span className=\"bg-gradient-to-r from-ak-primary to-ak-info bg-clip-text text-transparent\">word</span>`.\n- Don't stack many effects on one element; one accent treatment per focal point.\n\n## Layout primitives \u2014 don't fight responsive display\n`ak-stack`, `ak-cluster`, `ak-grid`, `ak-switcher` SET `display` (flex/grid) and are unlayered, so they OVERRIDE Tailwind's responsive display utilities (`md:hidden`, `lg:block`, `sm:hidden`). Putting a responsive display toggle on the SAME element silently fails (e.g. a mobile accordion stays visible on desktop):\n```tsx\n// WRONG \u2014 ak-stack's display:flex beats md:hidden, so it never hides\n<div className=\"md:hidden ak-stack\">\u2026</div>\n// RIGHT \u2014 wrap: toggle on the outer element, primitive inside\n<div className=\"md:hidden\"><div className=\"ak-stack\">\u2026</div></div>\n// or use plain flex/grid when you need to toggle visibility\n<div className=\"md:hidden flex flex-col\">\u2026</div>\n```\n\n## Charts \u2014 readable AND rendered (recipe)\nUse the colorful `ak-chart-*` tokens with solid fills (not faint `ak-primary` tints). **Percentage bar heights only resolve if the container has a DEFINITE height** \u2014 a common bug is `min-height` + `items-end`, which collapses the bars to zero. Use this pattern:\n```tsx\n{/* DEFINITE height (h-56) + stretched columns so %-height bars resolve */}\n<div className=\"flex h-56 items-stretch gap-ak-1\">\n  {data.map((v, i) => (\n    <div key={i} className=\"group flex flex-1 flex-col justify-end gap-ak-1\">\n      <div\n        className={(i === data.length - 1 ? 'bg-ak-primary' : 'bg-ak-chart-1') + ' w-full rounded-ak-md'}\n        style={{ height: `${Math.round((v / max) * 100)}%` }}  /* sanctioned data-driven inline style */\n        role=\"img\" aria-label={`${labels[i]}: ${v}`}\n      />\n      <span className=\"text-ak-xs text-ak-text-muted\">{labels[i]}</span>\n    </div>\n  ))}\n</div>\n```\n\n## Touch Targets \u2014 48px Minimum\n- Buttons: `min-h-[3rem]` + `cursor-pointer`\n- Form inputs: `h-14` (56px)\n\n## Empty States \u2014 Every Data Container\nEvery list, table, or feed must handle: Loading \u2192 Error \u2192 Empty \u2192 Data.\nEmpty states need: icon, title, description, CTA.\n\n## Error Handling \u2014 Never Show Raw Errors\nUser-facing errors need: title (jargon-free), description, action (Retry/Go Back).\n\n## cn() Utility\n```tsx\nimport { cn } from '@/lib/utils'\n<div className={cn(\"p-ak-3\", isActive && \"bg-ak-primary\")}>\n```\n";
+export declare const CODING_STANDARDS = "# AstralKit Coding Standards\n\n## Setup\n- Package: `astralkit` (npm)\n- CSS: `@import \"astralkit/theme\"; @import \"astralkit/utilities\";` (after Tailwind imports)\n- Tailwind v3 plugin: `require('astralkit/tailwind.cjs')` in tailwind.config\n- Tailwind v4: `@import \"astralkit/theme-v4\"; @import \"astralkit/utilities\";`\n- Icons: `@phosphor-icons/react` exclusively. Never Lucide, Heroicons, or inline SVGs.\n- Fonts: Inter (body), DM Serif Display (display), JetBrains Mono (code)\n\n## Token-First Rule\nALWAYS use `ak-*` tokens. NEVER use arbitrary bracket values.\n```tsx\n// CORRECT\n<div className=\"p-ak-3 gap-ak-2 text-ak-base rounded-ak-lg\">\n// WRONG \u2014 arbitrary values silently collapse in Tailwind v4\n<div className=\"p-[1.5rem] gap-[1rem] text-[16px] rounded-[0.75rem]\">\n```\n\n## Semantic Colors \u2014 No Raw Tailwind\n```tsx\n// CORRECT: bg-ak-surface, text-ak-text, border-ak-border, bg-ak-primary\n// WRONG:   bg-gray-50, text-gray-900, border-gray-200, bg-blue-600\n```\n\n## Typography \u2014 16px Floor\n- Body text, descriptions, nav items, table cells: `text-ak-base` (16px) minimum\n- UI text: `font-medium` minimum \u2014 `font-normal` is for long-form prose only\n- Labels/badges: `text-ak-sm` (14px) or `text-ak-xs` (12px uppercase) acceptable\n- Helper/error text: `text-ak-sm` (14px) is the only exception\n\n## Spacing \u2014 ak-* Tokens Only\n```tsx\n// CORRECT: p-ak-3, gap-ak-2, mb-ak-1_5\n// WRONG:   p-6, gap-4, mb-3\n```\n\n## Icons \u2014 Phosphor Only\n```tsx\nimport { House, Gear } from '@phosphor-icons/react'\n<House size={20} aria-hidden=\"true\" />\n```\n\n## No Inline Styles\nUse Tailwind classes. `style={{}}` only for CSS variables with no Tailwind equivalent.\n\n## No Shadows on Panels/Dropdowns \u2014 Borders Only\nUse `border border-ak-border`. Reserve shadows for modals and elevated cards.\n\n## Motion \u2014 Framer Motion + CSS + Lenis (GSAP not allowed)\nFramer Motion (the MIT `motion` package) IS allowed. Prefer the AstralKit presets from\n`astralkit/motion` (tuned to the motion tokens, reduced-motion-safe). CSS animations are\nalso fine (durations/easings via `duration-ak-*`, `ease-ak-spring`/`bounce`). Use Lenis for\nsmooth scroll. ALWAYS honor `prefers-reduced-motion`. **GSAP is NOT allowed** (license).\n```tsx\nimport { motion, useReducedMotion } from 'motion/react'\nimport { fadeInUp, withReducedMotion } from 'astralkit/motion'\nconst reduced = useReducedMotion()\n<motion.div initial=\"hidden\" animate=\"show\" variants={withReducedMotion(fadeInUp, reduced)} />\n```\n\n## Premium Polish \u2014 Use the Effect Toolkit (with taste)\nAstralKit ships CSS-only premium effects \u2014 reach for them so screens feel designed, not generic:\n- Depth/glow: `ak-card-glow`, `ak-ambient-glow`, `ak-spotlight-card`, `ak-gradient-border`, `ak-text-glow`, `ak-surface-raised`\n- Backgrounds: `ak-mesh-light` / `ak-mesh-dark` / `ak-mesh-astral` (mesh gradients)\n- Motion accents (CSS): `ak-float`, `ak-scroll-fade`, `ak-section-fade`, `ak-sheen`, `ak-press` (tap feedback)\n- Color: tasteful accent (60-30-10); colorful charts use `ak-chart-1`..`ak-chart-6`; curated palettes via `astralkit/palettes`\n- Icons: Phosphor `weight=\"duotone\"` reads richer for feature/marketing icons\n\n### Effect guardrails (use the RIGHT effect on the RIGHT surface)\n- **Glows need dark surfaces.** `ak-text-glow`, `ak-ambient-glow`, and `ak-card-glow` read correctly as LIGHT-on-DARK. On a light background with dark text they look like a muddy smudge \u2014 **do NOT put text-glow on dark text / light backgrounds.**\n- **For dramatic/marketing heroes, go dark.** Add the `dark` class to the section root + `ak-mesh-dark` (tokens auto-flip to dark), light text, and a gradient accent word. This reads more premium than a light hero.\n- **Gradient text accent** (instead of glow): `<span className=\"bg-gradient-to-r from-ak-primary to-ak-info bg-clip-text text-transparent\">word</span>`.\n- Don't stack many effects on one element; one accent treatment per focal point.\n\n## Layout primitives \u2014 don't fight responsive display\n`ak-stack`, `ak-cluster`, `ak-grid`, `ak-switcher` SET `display` (flex/grid) and are unlayered, so they OVERRIDE Tailwind's responsive display utilities (`md:hidden`, `lg:block`, `sm:hidden`). Putting a responsive display toggle on the SAME element silently fails (e.g. a mobile accordion stays visible on desktop):\n```tsx\n// WRONG \u2014 ak-stack's display:flex beats md:hidden, so it never hides\n<div className=\"md:hidden ak-stack\">\u2026</div>\n// RIGHT \u2014 wrap: toggle on the outer element, primitive inside\n<div className=\"md:hidden\"><div className=\"ak-stack\">\u2026</div></div>\n// or use plain flex/grid when you need to toggle visibility\n<div className=\"md:hidden flex flex-col\">\u2026</div>\n```\n\n## Charts \u2014 readable AND rendered (recipe)\nUse the colorful `ak-chart-*` tokens with solid fills (not faint `ak-primary` tints). **Percentage bar heights only resolve if the container has a DEFINITE height** \u2014 a common bug is `min-height` + `items-end`, which collapses the bars to zero. Use this pattern:\n```tsx\n{/* DEFINITE height (h-56) + stretched columns so %-height bars resolve */}\n<div className=\"flex h-56 items-stretch gap-ak-1\">\n  {data.map((v, i) => (\n    <div key={i} className=\"group flex flex-1 flex-col justify-end gap-ak-1\">\n      <div\n        className={(i === data.length - 1 ? 'bg-ak-primary' : 'bg-ak-chart-1') + ' w-full rounded-ak-md'}\n        style={{ height: `${Math.round((v / max) * 100)}%` }}  /* sanctioned data-driven inline style */\n        role=\"img\" aria-label={`${labels[i]}: ${v}`}\n      />\n      <span className=\"text-ak-xs text-ak-text-muted\">{labels[i]}</span>\n    </div>\n  ))}\n</div>\n```\n\n## Touch Targets \u2014 48px Minimum\n- Buttons: `min-h-[3rem]` + `cursor-pointer`\n- Form inputs: `h-14` (56px)\n\n## Empty States \u2014 Every Data Container\nEvery list, table, or feed must handle: Loading \u2192 Error \u2192 Empty \u2192 Data.\nEmpty states need: icon, title, description, CTA.\n\n## Error Handling \u2014 Never Show Raw Errors\nUser-facing errors need: title (jargon-free), description, action (Retry/Go Back).\n\n## cn() Utility\n```tsx\nimport { cn } from '@/lib/utils'\n<div className={cn(\"p-ak-3\", isActive && \"bg-ak-primary\")}>\n```\n\n## Theming Grammar \u2014 M3 Role System (60-30-10)\nEvery fill must use a ROLE, never resolve \"what color is this\" yourself:\n- **CTAs + binary on-states** (buttons, checked checkbox, toggle-ON): `bg-ak-primary text-ak-on-primary hover:bg-ak-primary-hover` \u2014 NEVER `bg-ak-text` for interactive fills.\n- **Selection-among-options** (active tab/segment/chip/nav item): `bg-ak-secondary text-ak-on-secondary`; subtle selected rows/nav: `bg-ak-secondary-container text-ak-on-secondary-container`.\n- **Selected-not-pressed cards**: `bg-ak-primary-container border-ak-primary`.\n- **Inverted/dark panels** (terminals, dark rails, dark tooltips, promo cards): `bg-ak-inverse-surface text-ak-inverse-on-surface` \u2014 NEVER `bg-ak-text`, `bg-ak-neutral-900 text-white`, or raw `bg-black`/hex.\n- **Surfaces**: page canvas `bg-ak-surface` \u2192 paper cards/inputs `bg-ak-surface-container-lowest` (or legacy `bg-ak-bg`/`bg-ak-elevated`) \u2192 wells/tracks `bg-ak-surface-container` (`-high`/`-highest` deeper). Borders: `border-ak-outline-variant` (hairline) / `border-ak-outline`.\n- **Overlays**: `bg-ak-scrim`. **Status**: `ak-error(-container)`/`ak-success`/`ak-warning`/`ak-info` + their `-text`/`on-` partners.\n- Non-interactive emphasis ink pills may keep `bg-ak-text text-ak-bg`. Opacity washes (`bg-ak-text/10`) stay neutral. Content colors (palette swatches, chart data) are exempt.\nDefault theme: primary is black, secondary falls back to primary \u2014 monochrome by default, fully colorable by any theme.\n";
 //# sourceMappingURL=rules.d.ts.map

package/dist/data/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/data/rules.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,ytMAwH5B,CAAC"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/data/rules.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,gtPAmI5B,CAAC"}

package/dist/data/rules.js

@@ -1,122 +1,133 @@
-export const CODING_STANDARDS = `# AstralKit Coding Standards
-
-## Setup
-- Package: \`astralkit\` (npm)
-- CSS: \`@import "astralkit/theme"; @import "astralkit/utilities";\` (after Tailwind imports)
-- Tailwind v3 plugin: \`require('astralkit/tailwind.cjs')\` in tailwind.config
-- Tailwind v4: \`@import "astralkit/theme-v4"; @import "astralkit/utilities";\`
-- Icons: \`@phosphor-icons/react\` exclusively. Never Lucide, Heroicons, or inline SVGs.
-- Fonts: Inter (body), DM Serif Display (display), JetBrains Mono (code)
-
-## Token-First Rule
-ALWAYS use \`ak-*\` tokens. NEVER use arbitrary bracket values.
-\`\`\`tsx
-// CORRECT
-<div className="p-ak-3 gap-ak-2 text-ak-base rounded-ak-lg">
-// WRONG — arbitrary values silently collapse in Tailwind v4
-<div className="p-[1.5rem] gap-[1rem] text-[16px] rounded-[0.75rem]">
-\`\`\`
-
-## Semantic Colors — No Raw Tailwind
-\`\`\`tsx
-// CORRECT: bg-ak-surface, text-ak-text, border-ak-border, bg-ak-primary
-// WRONG:   bg-gray-50, text-gray-900, border-gray-200, bg-blue-600
-\`\`\`
-
-## Typography — 16px Floor
-- Body text, descriptions, nav items, table cells: \`text-ak-base\` (16px) minimum
-- UI text: \`font-medium\` minimum — \`font-normal\` is for long-form prose only
-- Labels/badges: \`text-ak-sm\` (14px) or \`text-ak-xs\` (12px uppercase) acceptable
-- Helper/error text: \`text-ak-sm\` (14px) is the only exception
-
-## Spacing — ak-* Tokens Only
-\`\`\`tsx
-// CORRECT: p-ak-3, gap-ak-2, mb-ak-1_5
-// WRONG:   p-6, gap-4, mb-3
-\`\`\`
-
-## Icons — Phosphor Only
-\`\`\`tsx
-import { House, Gear } from '@phosphor-icons/react'
-<House size={20} aria-hidden="true" />
-\`\`\`
-
-## No Inline Styles
-Use Tailwind classes. \`style={{}}\` only for CSS variables with no Tailwind equivalent.
-
-## No Shadows on Panels/Dropdowns — Borders Only
-Use \`border border-ak-border\`. Reserve shadows for modals and elevated cards.
-
-## Motion — Framer Motion + CSS + Lenis (GSAP not allowed)
-Framer Motion (the MIT \`motion\` package) IS allowed. Prefer the AstralKit presets from
-\`astralkit/motion\` (tuned to the motion tokens, reduced-motion-safe). CSS animations are
-also fine (durations/easings via \`duration-ak-*\`, \`ease-ak-spring\`/\`bounce\`). Use Lenis for
-smooth scroll. ALWAYS honor \`prefers-reduced-motion\`. **GSAP is NOT allowed** (license).
-\`\`\`tsx
-import { motion, useReducedMotion } from 'motion/react'
-import { fadeInUp, withReducedMotion } from 'astralkit/motion'
-const reduced = useReducedMotion()
-<motion.div initial="hidden" animate="show" variants={withReducedMotion(fadeInUp, reduced)} />
-\`\`\`
-
-## Premium Polish — Use the Effect Toolkit (with taste)
-AstralKit ships CSS-only premium effects — reach for them so screens feel designed, not generic:
-- Depth/glow: \`ak-card-glow\`, \`ak-ambient-glow\`, \`ak-spotlight-card\`, \`ak-gradient-border\`, \`ak-text-glow\`, \`ak-surface-raised\`
-- Backgrounds: \`ak-mesh-light\` / \`ak-mesh-dark\` / \`ak-mesh-astral\` (mesh gradients)
-- Motion accents (CSS): \`ak-float\`, \`ak-scroll-fade\`, \`ak-section-fade\`, \`ak-sheen\`, \`ak-press\` (tap feedback)
-- Color: tasteful accent (60-30-10); colorful charts use \`ak-chart-1\`..\`ak-chart-6\`; curated palettes via \`astralkit/palettes\`
-- Icons: Phosphor \`weight="duotone"\` reads richer for feature/marketing icons
-
-### Effect guardrails (use the RIGHT effect on the RIGHT surface)
-- **Glows need dark surfaces.** \`ak-text-glow\`, \`ak-ambient-glow\`, and \`ak-card-glow\` read correctly as LIGHT-on-DARK. On a light background with dark text they look like a muddy smudge — **do NOT put text-glow on dark text / light backgrounds.**
-- **For dramatic/marketing heroes, go dark.** Add the \`dark\` class to the section root + \`ak-mesh-dark\` (tokens auto-flip to dark), light text, and a gradient accent word. This reads more premium than a light hero.
-- **Gradient text accent** (instead of glow): \`<span className="bg-gradient-to-r from-ak-primary to-ak-info bg-clip-text text-transparent">word</span>\`.
-- Don't stack many effects on one element; one accent treatment per focal point.
-
-## Layout primitives — don't fight responsive display
-\`ak-stack\`, \`ak-cluster\`, \`ak-grid\`, \`ak-switcher\` SET \`display\` (flex/grid) and are unlayered, so they OVERRIDE Tailwind's responsive display utilities (\`md:hidden\`, \`lg:block\`, \`sm:hidden\`). Putting a responsive display toggle on the SAME element silently fails (e.g. a mobile accordion stays visible on desktop):
-\`\`\`tsx
-// WRONG — ak-stack's display:flex beats md:hidden, so it never hides
-<div className="md:hidden ak-stack">…</div>
-// RIGHT — wrap: toggle on the outer element, primitive inside
-<div className="md:hidden"><div className="ak-stack">…</div></div>
-// or use plain flex/grid when you need to toggle visibility
-<div className="md:hidden flex flex-col">…</div>
-\`\`\`
-
-## Charts — readable AND rendered (recipe)
-Use the colorful \`ak-chart-*\` tokens with solid fills (not faint \`ak-primary\` tints). **Percentage bar heights only resolve if the container has a DEFINITE height** — a common bug is \`min-height\` + \`items-end\`, which collapses the bars to zero. Use this pattern:
-\`\`\`tsx
-{/* DEFINITE height (h-56) + stretched columns so %-height bars resolve */}
-<div className="flex h-56 items-stretch gap-ak-1">
-  {data.map((v, i) => (
-    <div key={i} className="group flex flex-1 flex-col justify-end gap-ak-1">
-      <div
-        className={(i === data.length - 1 ? 'bg-ak-primary' : 'bg-ak-chart-1') + ' w-full rounded-ak-md'}
-        style={{ height: \`\${Math.round((v / max) * 100)}%\` }}  /* sanctioned data-driven inline style */
-        role="img" aria-label={\`\${labels[i]}: \${v}\`}
-      />
-      <span className="text-ak-xs text-ak-text-muted">{labels[i]}</span>
-    </div>
-  ))}
-</div>
-\`\`\`
-
-## Touch Targets — 48px Minimum
-- Buttons: \`min-h-[3rem]\` + \`cursor-pointer\`
-- Form inputs: \`h-14\` (56px)
-
-## Empty States — Every Data Container
-Every list, table, or feed must handle: Loading → Error → Empty → Data.
-Empty states need: icon, title, description, CTA.
-
-## Error Handling — Never Show Raw Errors
-User-facing errors need: title (jargon-free), description, action (Retry/Go Back).
-
-## cn() Utility
-\`\`\`tsx
-import { cn } from '@/lib/utils'
-<div className={cn("p-ak-3", isActive && "bg-ak-primary")}>
-\`\`\`
+export const CODING_STANDARDS = `# AstralKit Coding Standards
+
+## Setup
+- Package: \`astralkit\` (npm)
+- CSS: \`@import "astralkit/theme"; @import "astralkit/utilities";\` (after Tailwind imports)
+- Tailwind v3 plugin: \`require('astralkit/tailwind.cjs')\` in tailwind.config
+- Tailwind v4: \`@import "astralkit/theme-v4"; @import "astralkit/utilities";\`
+- Icons: \`@phosphor-icons/react\` exclusively. Never Lucide, Heroicons, or inline SVGs.
+- Fonts: Inter (body), DM Serif Display (display), JetBrains Mono (code)
+
+## Token-First Rule
+ALWAYS use \`ak-*\` tokens. NEVER use arbitrary bracket values.
+\`\`\`tsx
+// CORRECT
+<div className="p-ak-3 gap-ak-2 text-ak-base rounded-ak-lg">
+// WRONG — arbitrary values silently collapse in Tailwind v4
+<div className="p-[1.5rem] gap-[1rem] text-[16px] rounded-[0.75rem]">
+\`\`\`
+
+## Semantic Colors — No Raw Tailwind
+\`\`\`tsx
+// CORRECT: bg-ak-surface, text-ak-text, border-ak-border, bg-ak-primary
+// WRONG:   bg-gray-50, text-gray-900, border-gray-200, bg-blue-600
+\`\`\`
+
+## Typography — 16px Floor
+- Body text, descriptions, nav items, table cells: \`text-ak-base\` (16px) minimum
+- UI text: \`font-medium\` minimum — \`font-normal\` is for long-form prose only
+- Labels/badges: \`text-ak-sm\` (14px) or \`text-ak-xs\` (12px uppercase) acceptable
+- Helper/error text: \`text-ak-sm\` (14px) is the only exception
+
+## Spacing — ak-* Tokens Only
+\`\`\`tsx
+// CORRECT: p-ak-3, gap-ak-2, mb-ak-1_5
+// WRONG:   p-6, gap-4, mb-3
+\`\`\`
+
+## Icons — Phosphor Only
+\`\`\`tsx
+import { House, Gear } from '@phosphor-icons/react'
+<House size={20} aria-hidden="true" />
+\`\`\`
+
+## No Inline Styles
+Use Tailwind classes. \`style={{}}\` only for CSS variables with no Tailwind equivalent.
+
+## No Shadows on Panels/Dropdowns — Borders Only
+Use \`border border-ak-border\`. Reserve shadows for modals and elevated cards.
+
+## Motion — Framer Motion + CSS + Lenis (GSAP not allowed)
+Framer Motion (the MIT \`motion\` package) IS allowed. Prefer the AstralKit presets from
+\`astralkit/motion\` (tuned to the motion tokens, reduced-motion-safe). CSS animations are
+also fine (durations/easings via \`duration-ak-*\`, \`ease-ak-spring\`/\`bounce\`). Use Lenis for
+smooth scroll. ALWAYS honor \`prefers-reduced-motion\`. **GSAP is NOT allowed** (license).
+\`\`\`tsx
+import { motion, useReducedMotion } from 'motion/react'
+import { fadeInUp, withReducedMotion } from 'astralkit/motion'
+const reduced = useReducedMotion()
+<motion.div initial="hidden" animate="show" variants={withReducedMotion(fadeInUp, reduced)} />
+\`\`\`
+
+## Premium Polish — Use the Effect Toolkit (with taste)
+AstralKit ships CSS-only premium effects — reach for them so screens feel designed, not generic:
+- Depth/glow: \`ak-card-glow\`, \`ak-ambient-glow\`, \`ak-spotlight-card\`, \`ak-gradient-border\`, \`ak-text-glow\`, \`ak-surface-raised\`
+- Backgrounds: \`ak-mesh-light\` / \`ak-mesh-dark\` / \`ak-mesh-astral\` (mesh gradients)
+- Motion accents (CSS): \`ak-float\`, \`ak-scroll-fade\`, \`ak-section-fade\`, \`ak-sheen\`, \`ak-press\` (tap feedback)
+- Color: tasteful accent (60-30-10); colorful charts use \`ak-chart-1\`..\`ak-chart-6\`; curated palettes via \`astralkit/palettes\`
+- Icons: Phosphor \`weight="duotone"\` reads richer for feature/marketing icons
+
+### Effect guardrails (use the RIGHT effect on the RIGHT surface)
+- **Glows need dark surfaces.** \`ak-text-glow\`, \`ak-ambient-glow\`, and \`ak-card-glow\` read correctly as LIGHT-on-DARK. On a light background with dark text they look like a muddy smudge — **do NOT put text-glow on dark text / light backgrounds.**
+- **For dramatic/marketing heroes, go dark.** Add the \`dark\` class to the section root + \`ak-mesh-dark\` (tokens auto-flip to dark), light text, and a gradient accent word. This reads more premium than a light hero.
+- **Gradient text accent** (instead of glow): \`<span className="bg-gradient-to-r from-ak-primary to-ak-info bg-clip-text text-transparent">word</span>\`.
+- Don't stack many effects on one element; one accent treatment per focal point.
+
+## Layout primitives — don't fight responsive display
+\`ak-stack\`, \`ak-cluster\`, \`ak-grid\`, \`ak-switcher\` SET \`display\` (flex/grid) and are unlayered, so they OVERRIDE Tailwind's responsive display utilities (\`md:hidden\`, \`lg:block\`, \`sm:hidden\`). Putting a responsive display toggle on the SAME element silently fails (e.g. a mobile accordion stays visible on desktop):
+\`\`\`tsx
+// WRONG — ak-stack's display:flex beats md:hidden, so it never hides
+<div className="md:hidden ak-stack">…</div>
+// RIGHT — wrap: toggle on the outer element, primitive inside
+<div className="md:hidden"><div className="ak-stack">…</div></div>
+// or use plain flex/grid when you need to toggle visibility
+<div className="md:hidden flex flex-col">…</div>
+\`\`\`
+
+## Charts — readable AND rendered (recipe)
+Use the colorful \`ak-chart-*\` tokens with solid fills (not faint \`ak-primary\` tints). **Percentage bar heights only resolve if the container has a DEFINITE height** — a common bug is \`min-height\` + \`items-end\`, which collapses the bars to zero. Use this pattern:
+\`\`\`tsx
+{/* DEFINITE height (h-56) + stretched columns so %-height bars resolve */}
+<div className="flex h-56 items-stretch gap-ak-1">
+  {data.map((v, i) => (
+    <div key={i} className="group flex flex-1 flex-col justify-end gap-ak-1">
+      <div
+        className={(i === data.length - 1 ? 'bg-ak-primary' : 'bg-ak-chart-1') + ' w-full rounded-ak-md'}
+        style={{ height: \`\${Math.round((v / max) * 100)}%\` }}  /* sanctioned data-driven inline style */
+        role="img" aria-label={\`\${labels[i]}: \${v}\`}
+      />
+      <span className="text-ak-xs text-ak-text-muted">{labels[i]}</span>
+    </div>
+  ))}
+</div>
+\`\`\`
+
+## Touch Targets — 48px Minimum
+- Buttons: \`min-h-[3rem]\` + \`cursor-pointer\`
+- Form inputs: \`h-14\` (56px)
+
+## Empty States — Every Data Container
+Every list, table, or feed must handle: Loading → Error → Empty → Data.
+Empty states need: icon, title, description, CTA.
+
+## Error Handling — Never Show Raw Errors
+User-facing errors need: title (jargon-free), description, action (Retry/Go Back).
+
+## cn() Utility
+\`\`\`tsx
+import { cn } from '@/lib/utils'
+<div className={cn("p-ak-3", isActive && "bg-ak-primary")}>
+\`\`\`
+
+## Theming Grammar — M3 Role System (60-30-10)
+Every fill must use a ROLE, never resolve "what color is this" yourself:
+- **CTAs + binary on-states** (buttons, checked checkbox, toggle-ON): \`bg-ak-primary text-ak-on-primary hover:bg-ak-primary-hover\` — NEVER \`bg-ak-text\` for interactive fills.
+- **Selection-among-options** (active tab/segment/chip/nav item): \`bg-ak-secondary text-ak-on-secondary\`; subtle selected rows/nav: \`bg-ak-secondary-container text-ak-on-secondary-container\`.
+- **Selected-not-pressed cards**: \`bg-ak-primary-container border-ak-primary\`.
+- **Inverted/dark panels** (terminals, dark rails, dark tooltips, promo cards): \`bg-ak-inverse-surface text-ak-inverse-on-surface\` — NEVER \`bg-ak-text\`, \`bg-ak-neutral-900 text-white\`, or raw \`bg-black\`/hex.
+- **Surfaces**: page canvas \`bg-ak-surface\` → paper cards/inputs \`bg-ak-surface-container-lowest\` (or legacy \`bg-ak-bg\`/\`bg-ak-elevated\`) → wells/tracks \`bg-ak-surface-container\` (\`-high\`/\`-highest\` deeper). Borders: \`border-ak-outline-variant\` (hairline) / \`border-ak-outline\`.
+- **Overlays**: \`bg-ak-scrim\`. **Status**: \`ak-error(-container)\`/\`ak-success\`/\`ak-warning\`/\`ak-info\` + their \`-text\`/\`on-\` partners.
+- Non-interactive emphasis ink pills may keep \`bg-ak-text text-ak-bg\`. Opacity washes (\`bg-ak-text/10\`) stay neutral. Content colors (palette swatches, chart data) are exempt.
+Default theme: primary is black, secondary falls back to primary — monochrome by default, fully colorable by any theme.
 `;
 //# sourceMappingURL=rules.js.map

package/dist/data/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/data/rules.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwH/B,CAAC"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/data/rules.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmI/B,CAAC"}

package/dist/data/screens.d.ts

@@ -0,0 +1,5 @@
+export declare const SCREEN_BLUEPRINTS: Record<string, string>;
+export declare const SCREEN_TYPES: string[];
+/** Build the get_screen_blueprint response for a screen type. */
+export declare function buildScreenBlueprint(screenType: string): string;
+//# sourceMappingURL=screens.d.ts.map

package/dist/data/screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../../src/data/screens.ts"],"names":[],"mappings":"AAoJA,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQpD,CAAC;AAEF,eAAO,MAAM,YAAY,UAAiC,CAAC;AAE3D,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAY/D"}