@bestagentkits/render 0.1.0

package/dist/theme/theme-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-catalog.js","sourceRoot":"","sources":["../../src/theme/theme-catalog.ts"],"names":[],"mappings":"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"}

package/dist/theme/tokens.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Theme token model.
+ *
+ * A theme is typed data, never CSS. Every token is declared here with its kind
+ * and its bounds, so a preset — built-in or user-authored — can only set values
+ * the compiler knows how to validate. There is deliberately no token kind that
+ * accepts a free-form declaration, which is what makes "no CSS escape hatch" a
+ * property of the type system rather than a promise.
+ */
+export type TokenKind = 'color' | 'length' | 'font-stack' | 'elevation' | 'easing' | 'enum' | 'number';
+export interface TokenSpec {
+    kind: TokenKind;
+    group: string;
+    description: string;
+    /** Allowed values for `enum` tokens. */
+    values?: readonly string[];
+    min?: number;
+    max?: number;
+}
+export declare const TOKEN_SPECS: Readonly<Record<string, TokenSpec>>;
+export type Tokens = Record<string, string>;
+/** Long-form descriptions keyed by token name, for `describe()`-style surfaces. */
+export declare function tokenNames(): string[];
+/** True when a font stack cannot escape a CSS declaration. */
+export declare function isSafeFontStack(value: string): boolean;
+export interface TokenProblem {
+    token: string;
+    message: string;
+}
+/** Validate one token value against its declared kind. */
+export declare function validateTokenValue(token: string, value: unknown): TokenProblem | undefined;
+/** Validate a partial token set, returning every problem found. */
+export declare function validateTokens(tokens: Record<string, unknown>): TokenProblem[];
+/** Resolve a token to its CSS value, mapping symbolic tokens to fixed values. */
+export declare function tokenCssValue(token: string, value: string): string;
+/** The CSS custom property name for a token. */
+export declare function tokenVariable(token: string): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/theme/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAiF3D,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC;AAOD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAoD1F;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,CAO9E;AAUD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/theme/tokens.js

@@ -0,0 +1,190 @@
+/**
+ * Theme token model.
+ *
+ * A theme is typed data, never CSS. Every token is declared here with its kind
+ * and its bounds, so a preset — built-in or user-authored — can only set values
+ * the compiler knows how to validate. There is deliberately no token kind that
+ * accepts a free-form declaration, which is what makes "no CSS escape hatch" a
+ * property of the type system rather than a promise.
+ */
+const ELEVATIONS = ['none', 'subtle', 'medium', 'strong'];
+const EASINGS = ['ease', 'ease-in-out', 'linear'];
+export const TOKEN_SPECS = {
+    'color-background': { kind: 'color', group: 'color', description: 'Page background.' },
+    'color-surface': { kind: 'color', group: 'color', description: 'Card and panel background.' },
+    'color-surface-raised': { kind: 'color', group: 'color', description: 'Elevated surface.' },
+    'color-border': { kind: 'color', group: 'color', description: 'Hairline border colour.' },
+    'color-text': { kind: 'color', group: 'color', description: 'Primary text colour.' },
+    'color-text-muted': { kind: 'color', group: 'color', description: 'Secondary text colour.' },
+    'color-accent': { kind: 'color', group: 'color', description: 'Primary accent.' },
+    'color-accent-contrast': {
+        kind: 'color',
+        group: 'color',
+        description: 'Text colour placed on the accent.',
+    },
+    'color-info': { kind: 'color', group: 'color', description: 'Informational status colour.' },
+    'color-success': { kind: 'color', group: 'color', description: 'Success status colour.' },
+    'color-warning': { kind: 'color', group: 'color', description: 'Warning status colour.' },
+    'color-danger': { kind: 'color', group: 'color', description: 'Danger status colour.' },
+    'font-heading': {
+        kind: 'font-stack',
+        group: 'typography',
+        description: 'Heading font stack. System stacks only; no remote fonts.',
+    },
+    'font-body': { kind: 'font-stack', group: 'typography', description: 'Body font stack.' },
+    'font-mono': { kind: 'font-stack', group: 'typography', description: 'Monospace font stack.' },
+    'font-size-base': { kind: 'length', group: 'typography', description: 'Base font size.' },
+    'font-scale': {
+        kind: 'number',
+        group: 'typography',
+        description: 'Modular scale ratio for heading sizes.',
+        min: 1.05,
+        max: 1.6,
+    },
+    'line-height': {
+        kind: 'number',
+        group: 'typography',
+        description: 'Body line height multiplier.',
+        min: 1.2,
+        max: 2.2,
+    },
+    measure: { kind: 'length', group: 'typography', description: 'Maximum reading width.' },
+    'space-unit': { kind: 'length', group: 'spacing', description: 'Base spacing unit.' },
+    density: {
+        kind: 'enum',
+        group: 'spacing',
+        description: 'Vertical rhythm between sections.',
+        values: ['compact', 'comfortable', 'spacious'],
+    },
+    'radius-small': { kind: 'length', group: 'radius', description: 'Small corner radius.' },
+    'radius-medium': { kind: 'length', group: 'radius', description: 'Default corner radius.' },
+    'radius-large': { kind: 'length', group: 'radius', description: 'Large corner radius.' },
+    'border-width': { kind: 'length', group: 'border', description: 'Default border width.' },
+    'elevation-card': {
+        kind: 'elevation',
+        group: 'elevation',
+        description: 'Card shadow strength.',
+        values: ELEVATIONS,
+    },
+    'elevation-popover': {
+        kind: 'elevation',
+        group: 'elevation',
+        description: 'Popover shadow strength.',
+        values: ELEVATIONS,
+    },
+    'motion-duration': { kind: 'length', group: 'motion', description: 'Transition duration.' },
+    'motion-easing': {
+        kind: 'easing',
+        group: 'motion',
+        description: 'Transition easing function.',
+        values: EASINGS,
+    },
+    'motion-policy': {
+        kind: 'enum',
+        group: 'motion',
+        description: 'Whether transitions and animations run at all.',
+        values: ['full', 'reduced', 'none'],
+    },
+};
+/** Long-form descriptions keyed by token name, for `describe()`-style surfaces. */
+export function tokenNames() {
+    return Object.keys(TOKEN_SPECS).sort();
+}
+const COLOR_PATTERN = /^#[0-9a-f]{3}(?:[0-9a-f]{3}(?:[0-9a-f]{2})?)?$/i;
+/** CSS length or duration values, in units a preset may safely use. */
+const LENGTH_PATTERN = /^-?\d+(?:\.\d+)?(?:px|rem|em|ch|ex|%|vw|vh|ms|s)$/;
+const FONT_STACK_PATTERN = /^[A-Za-z0-9 ,'"\-._+]+$/;
+/** True when a font stack cannot escape a CSS declaration. */
+export function isSafeFontStack(value) {
+    if (!FONT_STACK_PATTERN.test(value))
+        return false;
+    const lowered = value.toLowerCase();
+    return !['url(', 'expression', 'javascript', '@import', '\\'].some((bad) => lowered.includes(bad));
+}
+/** Validate one token value against its declared kind. */
+export function validateTokenValue(token, value) {
+    const spec = TOKEN_SPECS[token];
+    if (spec === undefined) {
+        return { token, message: 'unknown token' };
+    }
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        return { token, message: `expected a ${spec.kind} value` };
+    }
+    switch (spec.kind) {
+        case 'color': {
+            if (typeof value !== 'string' || !COLOR_PATTERN.test(value)) {
+                return { token, message: 'expected a hex colour such as #1a2b3c' };
+            }
+            return undefined;
+        }
+        case 'length': {
+            if (typeof value !== 'string' || !LENGTH_PATTERN.test(value)) {
+                return {
+                    token,
+                    message: 'expected a length or duration such as 16px, 1rem, 72ch, or 160ms',
+                };
+            }
+            return undefined;
+        }
+        case 'font-stack': {
+            if (typeof value !== 'string' || !isSafeFontStack(value)) {
+                return { token, message: 'expected a font stack of names only (no url(), no expressions)' };
+            }
+            return undefined;
+        }
+        case 'elevation':
+        case 'easing':
+        case 'enum': {
+            const allowed = spec.values ?? [];
+            if (typeof value !== 'string' || !allowed.includes(value)) {
+                return { token, message: `expected one of: ${allowed.join(', ')}` };
+            }
+            return undefined;
+        }
+        case 'number': {
+            const numeric = typeof value === 'number' ? value : Number(value);
+            if (!Number.isFinite(numeric))
+                return { token, message: 'expected a number' };
+            if (spec.min !== undefined && numeric < spec.min) {
+                return { token, message: `must be at least ${spec.min}` };
+            }
+            if (spec.max !== undefined && numeric > spec.max) {
+                return { token, message: `must be at most ${spec.max}` };
+            }
+            return undefined;
+        }
+    }
+}
+/** Validate a partial token set, returning every problem found. */
+export function validateTokens(tokens) {
+    const problems = [];
+    for (const [token, value] of Object.entries(tokens)) {
+        const problem = validateTokenValue(token, value);
+        if (problem !== undefined)
+            problems.push(problem);
+    }
+    return problems;
+}
+/** Fixed elevation shadows, so a preset cannot supply an arbitrary shadow. */
+const ELEVATION_SHADOWS = {
+    none: 'none',
+    subtle: '0 1px 2px rgba(0, 0, 0, 0.06)',
+    medium: '0 2px 8px rgba(0, 0, 0, 0.10)',
+    strong: '0 8px 24px rgba(0, 0, 0, 0.16)',
+};
+/** Resolve a token to its CSS value, mapping symbolic tokens to fixed values. */
+export function tokenCssValue(token, value) {
+    const spec = TOKEN_SPECS[token];
+    if (spec?.kind === 'elevation')
+        return ELEVATION_SHADOWS[value] ?? 'none';
+    if (spec?.kind === 'easing')
+        return value;
+    if (spec?.kind === 'enum')
+        return value;
+    return value;
+}
+/** The CSS custom property name for a token. */
+export function tokenVariable(token) {
+    return `--ak-${token}`;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/theme/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Package version.
+ *
+ * Kept as a literal so the value is available to any runtime (including a
+ * worker bundle) without reading a manifest. `tests/unit/version.test.ts`
+ * asserts that it stays equal to the `version` field in `package.json`, so a
+ * release that forgets one of them fails fast.
+ */
+export declare const VERSION = "0.1.0";
+/** Published package name, used by CLI output and release tooling. */
+export declare const PACKAGE_NAME = "@bestagentkits/render";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,sEAAsE;AACtE,eAAO,MAAM,YAAY,0BAA0B,CAAC"}

package/dist/version.js

@@ -0,0 +1,12 @@
+/**
+ * Package version.
+ *
+ * Kept as a literal so the value is available to any runtime (including a
+ * worker bundle) without reading a manifest. `tests/unit/version.test.ts`
+ * asserts that it stays equal to the `version` field in `package.json`, so a
+ * release that forgets one of them fails fast.
+ */
+export const VERSION = '0.1.0';
+/** Published package name, used by CLI output and release tooling. */
+export const PACKAGE_NAME = '@bestagentkits/render';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@bestagentkits/render",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Declarative Page Spec compiler: deterministic, offline, interactive standalone HTML from JSON/YAML.",
+  "keywords": [
+    "agentkit",
+    "renderer",
+    "page-spec",
+    "declarative",
+    "html",
+    "compiler",
+    "deterministic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bestagentkits/ak-render.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.11"
+  },
+  "packageManager": "pnpm@9.15.0",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ak-render": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/mark-cli-executable.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "test": "vitest run",
+    "test:browser": "playwright test",
+    "test:package": "node scripts/package-smoke.mjs",
+    "test:clean-install": "node scripts/clean-install-verify.mjs",
+    "gallery:generate": "node scripts/generate-gallery.mjs",
+    "gallery:check": "node scripts/generate-gallery.mjs --check",
+    "bench:baseline": "node benchmarks/legacy-context-cost.mjs",
+    "bench:render": "node benchmarks/render-benchmark.mjs",
+    "bench:browser": "playwright test tests/browser/benchmark.spec.ts",
+    "bench": "pnpm build && pnpm bench:render && pnpm bench:browser",
+    "schema:generate": "node scripts/generate-json-schema.mjs",
+    "schema:check": "node scripts/generate-json-schema.mjs --check",
+    "snapshots:generate": "node scripts/generate-theme-snapshots.mjs",
+    "snapshots:check": "node scripts/generate-theme-snapshots.mjs --check",
+    "verify": "pnpm lint && pnpm typecheck && pnpm test && pnpm build"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.12",
+    "@playwright/test": "^1.56.0",
+    "@types/node": "^22.15.0",
+    "ajv": "^8.17.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "dependencies": {
+    "yaml": "^2.8.3"
+  }
+}