@bestagentkits/render 0.1.0

package/dist/registry/prop-schema.js

@@ -0,0 +1,400 @@
+/**
+ * Declarative property schemas.
+ *
+ * One source of truth serves three consumers: runtime validation (with stable
+ * JSON paths), the published JSON Schema, and the compact `catalog()` /
+ * `describe()` contracts. Keeping them derived from one definition is what
+ * stops the documentation from drifting away from the validator.
+ */
+import { DiagnosticBag, pathIndex, pathKey } from '../diagnostics.js';
+import { isPlainObject } from '../json.js';
+export const DEFAULT_URL_SCHEMES = ['https', 'http', 'mailto'];
+export const NODE_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+function isRelativeReference(value) {
+    if (value === '')
+        return false;
+    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(value))
+        return false;
+    return !value.startsWith('//');
+}
+function validateUrl(schema, value, path, bag) {
+    if (isRelativeReference(value))
+        return true;
+    const schemes = schema.schemes ?? DEFAULT_URL_SCHEMES;
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path,
+            message: `"${value}" is neither a relative reference nor an absolute URL`,
+        });
+        return false;
+    }
+    const scheme = parsed.protocol.replace(':', '').toLowerCase();
+    if (!schemes.includes(scheme)) {
+        bag.add({
+            code: 'POLICY_VIOLATION',
+            path,
+            message: `URL scheme "${scheme}" is not allowed here (allowed: ${schemes.join(', ')})`,
+            details: { scheme, allowed: [...schemes] },
+        });
+        return false;
+    }
+    return true;
+}
+function defaultFor(schema) {
+    switch (schema.kind) {
+        case 'string':
+        case 'text':
+        case 'url':
+            return schema.default;
+        case 'number':
+            return schema.default;
+        case 'boolean':
+            return schema.default;
+        case 'list':
+            return schema.required === true ? undefined : [];
+        case 'record':
+            return schema.required === true ? undefined : {};
+        default:
+            return undefined;
+    }
+}
+/**
+ * Validate one property value against its schema, appending diagnostics and
+ * returning the normalized value (or `undefined` when absent/optional).
+ */
+export function validateProp(schema, value, path, bag) {
+    if (value === undefined) {
+        if (schema.required === true) {
+            bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'required value is missing' });
+        }
+        return defaultFor(schema);
+    }
+    switch (schema.kind) {
+        case 'string': {
+            if (typeof value !== 'string') {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected a string' });
+                return undefined;
+            }
+            const maxLength = schema.maxLength ?? 2_000;
+            if (value.length > maxLength) {
+                bag.add({
+                    code: 'SPEC_BOUNDS_ERROR',
+                    path,
+                    message: `string is ${value.length} characters, limit is ${maxLength}`,
+                });
+                return undefined;
+            }
+            if (schema.id === true && !NODE_ID_PATTERN.test(value)) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: `"${value}" is not a valid id (lowercase letters, digits and dashes, 64 max)`,
+                });
+                return undefined;
+            }
+            if (schema.enum !== undefined && !schema.enum.includes(value)) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: `"${value}" is not one of: ${schema.enum.join(', ')}`,
+                    details: { allowed: [...schema.enum] },
+                });
+                return undefined;
+            }
+            if (value.includes('\u0000')) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: 'string contains a NUL character',
+                });
+                return undefined;
+            }
+            return value;
+        }
+        case 'text': {
+            if (typeof value !== 'string') {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected multiline text' });
+                return undefined;
+            }
+            const maxLength = schema.maxLength ?? 50_000;
+            if (value.length > maxLength) {
+                bag.add({
+                    code: 'SPEC_BOUNDS_ERROR',
+                    path,
+                    message: `text is ${value.length} characters, limit is ${maxLength}`,
+                });
+                return undefined;
+            }
+            return value;
+        }
+        case 'number': {
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected a finite number' });
+                return undefined;
+            }
+            if (schema.integer === true && !Number.isInteger(value)) {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected an integer' });
+                return undefined;
+            }
+            if (schema.min !== undefined && value < schema.min) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: `${value} is below the minimum ${schema.min}`,
+                });
+                return undefined;
+            }
+            if (schema.max !== undefined && value > schema.max) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: `${value} is above the maximum ${schema.max}`,
+                });
+                return undefined;
+            }
+            return value;
+        }
+        case 'boolean': {
+            if (typeof value !== 'boolean') {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected a boolean' });
+                return undefined;
+            }
+            return value;
+        }
+        case 'url': {
+            if (typeof value !== 'string') {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: 'expected a URL or relative path',
+                });
+                return undefined;
+            }
+            return validateUrl(schema, value, path, bag) ? value : undefined;
+        }
+        case 'list': {
+            if (!Array.isArray(value)) {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected a list' });
+                return undefined;
+            }
+            if (schema.minItems !== undefined && value.length < schema.minItems) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path,
+                    message: `list has ${value.length} items, minimum is ${schema.minItems}`,
+                });
+                return undefined;
+            }
+            if (schema.maxItems !== undefined && value.length > schema.maxItems) {
+                bag.add({
+                    code: 'SPEC_BOUNDS_ERROR',
+                    path,
+                    message: `list has ${value.length} items, limit is ${schema.maxItems}`,
+                });
+                return undefined;
+            }
+            const result = [];
+            for (let index = 0; index < value.length; index += 1) {
+                const item = validateProp(schema.of, value[index], pathIndex(path, index), bag);
+                if (item !== undefined)
+                    result.push(item);
+            }
+            return result;
+        }
+        case 'object': {
+            if (!isPlainObject(value)) {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected an object' });
+                return undefined;
+            }
+            const result = {};
+            for (const [key, field] of Object.entries(schema.fields)) {
+                const fieldValue = validateProp(field, value[key], pathKey(path, key), bag);
+                if (fieldValue !== undefined)
+                    result[key] = fieldValue;
+            }
+            for (const key of Object.keys(value)) {
+                if (!(key in schema.fields)) {
+                    bag.add({
+                        code: 'SPEC_VALIDATION_ERROR',
+                        path: pathKey(path, key),
+                        message: `unknown property "${key}"`,
+                        details: { allowed: Object.keys(schema.fields) },
+                    });
+                }
+            }
+            return result;
+        }
+        case 'record': {
+            if (!isPlainObject(value)) {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected an object' });
+                return undefined;
+            }
+            const keys = Object.keys(value);
+            const maxKeys = schema.maxKeys ?? 200;
+            if (keys.length > maxKeys) {
+                bag.add({
+                    code: 'SPEC_BOUNDS_ERROR',
+                    path,
+                    message: `object has ${keys.length} keys, limit is ${maxKeys}`,
+                });
+                return undefined;
+            }
+            const result = {};
+            for (const key of keys) {
+                if (key.length > 128) {
+                    bag.add({
+                        code: 'SPEC_BOUNDS_ERROR',
+                        path: pathKey(path, key),
+                        message: 'key is longer than 128 characters',
+                    });
+                    continue;
+                }
+                const item = validateProp(schema.of, value[key], pathKey(path, key), bag);
+                if (item !== undefined)
+                    result[key] = item;
+            }
+            return result;
+        }
+        case 'oneOf': {
+            // Each option is attempted with its own diagnostics: a failed attempt must
+            // not poison the next candidate.
+            for (const option of schema.options) {
+                const attempt = new DiagnosticBag();
+                const candidate = validateProp(option, value, path, attempt);
+                if (!attempt.hasErrors)
+                    return candidate;
+            }
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path,
+                message: `value does not match any allowed shape (${schema.options.length} options)`,
+            });
+            return undefined;
+        }
+        case 'json': {
+            let serialized;
+            try {
+                serialized = JSON.stringify(value) ?? '';
+            }
+            catch {
+                bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'value is not JSON-serializable' });
+                return undefined;
+            }
+            const maxBytes = schema.maxBytes ?? 200_000;
+            if (serialized.length > maxBytes) {
+                bag.add({
+                    code: 'SPEC_BOUNDS_ERROR',
+                    path,
+                    message: `payload is ${serialized.length} bytes, limit is ${maxBytes}`,
+                });
+                return undefined;
+            }
+            return value;
+        }
+    }
+}
+/**
+ * Validate a props object against a block's property schema. Unknown keys are
+ * errors: a silently ignored prop is a silent authoring mistake.
+ */
+export function validateProps(fields, value, path, bag) {
+    if (!isPlainObject(value)) {
+        bag.add({ code: 'SPEC_VALIDATION_ERROR', path, message: 'expected a block object' });
+        return {};
+    }
+    const result = {};
+    for (const [key, field] of Object.entries(fields)) {
+        const validated = validateProp(field, value[key], pathKey(path, key), bag);
+        if (validated !== undefined)
+            result[key] = validated;
+    }
+    for (const key of Object.keys(value)) {
+        if (!(key in fields)) {
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path: pathKey(path, key),
+                message: `unknown property "${key}" for this block`,
+                details: { allowed: Object.keys(fields) },
+            });
+        }
+    }
+    return result;
+}
+/** Project a prop schema into JSON Schema for the published spec contract. */
+export function propSchemaToJsonSchema(schema) {
+    switch (schema.kind) {
+        case 'string': {
+            const out = { type: 'string' };
+            if (schema.maxLength !== undefined)
+                out.maxLength = schema.maxLength;
+            else
+                out.maxLength = 2_000;
+            if (schema.enum !== undefined)
+                out.enum = [...schema.enum];
+            if (schema.id === true)
+                out.pattern = NODE_ID_PATTERN.source;
+            return out;
+        }
+        case 'text':
+            return { type: 'string', maxLength: schema.maxLength ?? 50_000 };
+        case 'number': {
+            const out = { type: schema.integer === true ? 'integer' : 'number' };
+            if (schema.min !== undefined)
+                out.minimum = schema.min;
+            if (schema.max !== undefined)
+                out.maximum = schema.max;
+            return out;
+        }
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'url':
+            return {
+                type: 'string',
+                description: 'Relative path (local asset) or an absolute URL with an allowlisted scheme.',
+            };
+        case 'list': {
+            const out = {
+                type: 'array',
+                items: propSchemaToJsonSchema(schema.of),
+            };
+            if (schema.minItems !== undefined)
+                out.minItems = schema.minItems;
+            if (schema.maxItems !== undefined)
+                out.maxItems = schema.maxItems;
+            return out;
+        }
+        case 'object': {
+            const properties = {};
+            const required = [];
+            for (const [key, field] of Object.entries(schema.fields)) {
+                properties[key] = propSchemaToJsonSchema(field);
+                if (field.required === true)
+                    required.push(key);
+            }
+            const out = {
+                type: 'object',
+                properties,
+                additionalProperties: false,
+            };
+            if (required.length > 0)
+                out.required = required;
+            return out;
+        }
+        case 'record':
+            return { type: 'object', additionalProperties: propSchemaToJsonSchema(schema.of) };
+        case 'oneOf':
+            return { oneOf: schema.options.map((option) => propSchemaToJsonSchema(option)) };
+        case 'json': {
+            const out = { description: schema.description };
+            if (schema.schemaRef !== undefined)
+                out.$ref = schema.schemaRef;
+            return out;
+        }
+    }
+}
+//# sourceMappingURL=prop-schema.js.map

package/dist/registry/prop-schema.js.map

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

package/dist/registry/registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Registry and discovery surfaces.
+ *
+ * `catalog()` is the compact, token-cheap listing an agent can afford to load
+ * up front. `describe(type)` is the full contract, paid for only for the blocks
+ * that were actually selected. The published JSON Schema is generated from the
+ * same definitions, so a documented prop and a validated prop cannot disagree.
+ */
+import { type ActionType } from './actions.js';
+import { type BlockDefinition } from './roster.js';
+/** Page Spec schema version implemented by this compiler. */
+export declare const SPEC_SCHEMA_VERSION = 1;
+export interface CatalogEntry {
+    type: string;
+    kind: 'semantic' | 'primitive';
+    version: number;
+    summary: string;
+}
+export interface Catalog {
+    schemaVersion: number;
+    blockCount: number;
+    blocks: CatalogEntry[];
+    actions: {
+        type: ActionType;
+        summary: string;
+    }[];
+}
+export declare function getBlockDefinition(type: string): BlockDefinition | undefined;
+export declare function blockTypes(): string[];
+/** Compact discovery surface: names, kinds, and one-line summaries. */
+export declare function catalog(): Catalog;
+/**
+ * Full contract for one block type.
+ *
+ * Returns a deep copy so a caller cannot mutate the registry through the
+ * contract object.
+ */
+export declare function describe(type: string): BlockDefinition;
+/**
+ * The canonical Page Spec JSON Schema (JSON Schema draft 2020-12).
+ *
+ * Generated, never hand-maintained: `tests/unit/json-schema.test.ts` regenerates
+ * it, compares against `schema/page-spec.v1.json`, and validates the fixture
+ * corpus with an independent validator.
+ */
+export declare function buildPageSpecJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAsB,KAAK,UAAU,EAAkC,MAAM,cAAc,CAAC;AAEnG,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtF,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC;AAED,uEAAuE;AACvE,wBAAgB,OAAO,IAAI,OAAO,CAYjC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAStD;AAuED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+EjE"}

package/dist/registry/registry.js

@@ -0,0 +1,201 @@
+/**
+ * Registry and discovery surfaces.
+ *
+ * `catalog()` is the compact, token-cheap listing an agent can afford to load
+ * up front. `describe(type)` is the full contract, paid for only for the blocks
+ * that were actually selected. The published JSON Schema is generated from the
+ * same definitions, so a documented prop and a validated prop cannot disagree.
+ */
+import { RenderError } from '../errors.js';
+import { LIMITS } from '../spec/bounds.js';
+import { ACTION_DEFINITIONS, ALLOWED_EVENTS, actionsCatalog } from './actions.js';
+import { propSchemaToJsonSchema } from './prop-schema.js';
+import { BLOCK_DEFINITIONS, BLOCKS_BY_TYPE } from './roster.js';
+/** Page Spec schema version implemented by this compiler. */
+export const SPEC_SCHEMA_VERSION = 1;
+export function getBlockDefinition(type) {
+    return BLOCKS_BY_TYPE.get(type);
+}
+export function blockTypes() {
+    return BLOCK_DEFINITIONS.map((definition) => definition.type);
+}
+/** Compact discovery surface: names, kinds, and one-line summaries. */
+export function catalog() {
+    return {
+        schemaVersion: SPEC_SCHEMA_VERSION,
+        blockCount: BLOCK_DEFINITIONS.length,
+        blocks: BLOCK_DEFINITIONS.map((definition) => ({
+            type: definition.type,
+            kind: definition.kind,
+            version: definition.version,
+            summary: definition.summary,
+        })),
+        actions: actionsCatalog(),
+    };
+}
+/**
+ * Full contract for one block type.
+ *
+ * Returns a deep copy so a caller cannot mutate the registry through the
+ * contract object.
+ */
+export function describe(type) {
+    const definition = BLOCKS_BY_TYPE.get(type);
+    if (definition === undefined) {
+        throw new RenderError('SPEC_UNKNOWN_BLOCK', `unknown block type "${type}"`, {
+            path: 'blocks',
+            details: { type, known: blockTypes().sort() },
+        });
+    }
+    return JSON.parse(JSON.stringify(definition));
+}
+function blockListSchema() {
+    return {
+        type: 'array',
+        minItems: 1,
+        maxItems: LIMITS.maxBlocks,
+        items: { $ref: '#/$defs/block' },
+    };
+}
+function blockSchema(definition) {
+    const properties = {
+        type: { const: definition.type },
+    };
+    const required = ['type'];
+    for (const [key, schema] of Object.entries(definition.props)) {
+        properties[key] = propSchemaToJsonSchema(schema);
+        if (schema.required === true)
+            required.push(key);
+    }
+    if (definition.slots?.children !== undefined) {
+        properties.blocks = { $ref: '#/$defs/blockList' };
+    }
+    return {
+        type: 'object',
+        additionalProperties: false,
+        required,
+        properties,
+        description: definition.summary,
+    };
+}
+function actionMapSchema() {
+    return {
+        type: 'object',
+        minProperties: 1,
+        maxProperties: ALLOWED_EVENTS.length,
+        propertyNames: { enum: [...ALLOWED_EVENTS] },
+        additionalProperties: {
+            oneOf: [
+                { $ref: '#/$defs/action' },
+                { type: 'array', minItems: 1, maxItems: 8, items: { $ref: '#/$defs/action' } },
+            ],
+        },
+        description: 'Declarative action bindings, keyed by event name.',
+    };
+}
+function actionSchema() {
+    return {
+        oneOf: ACTION_DEFINITIONS.map((definition) => {
+            const properties = { action: { const: definition.type } };
+            const required = ['action'];
+            for (const [key, schema] of Object.entries(definition.params)) {
+                properties[key] = propSchemaToJsonSchema(schema);
+                if (schema.required === true)
+                    required.push(key);
+            }
+            return {
+                type: 'object',
+                additionalProperties: false,
+                required,
+                properties,
+                description: definition.summary,
+            };
+        }),
+    };
+}
+/**
+ * The canonical Page Spec JSON Schema (JSON Schema draft 2020-12).
+ *
+ * Generated, never hand-maintained: `tests/unit/json-schema.test.ts` regenerates
+ * it, compares against `schema/page-spec.v1.json`, and validates the fixture
+ * corpus with an independent validator.
+ */
+export function buildPageSpecJsonSchema() {
+    const defs = {
+        block: {
+            oneOf: BLOCK_DEFINITIONS.map((definition) => ({ $ref: `#/$defs/block-${definition.type}` })),
+        },
+        blockList: blockListSchema(),
+        actionMap: actionMapSchema(),
+        action: actionSchema(),
+    };
+    for (const definition of BLOCK_DEFINITIONS) {
+        defs[`block-${definition.type}`] = blockSchema(definition);
+    }
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'https://agentkit.best/schema/page-spec.v1.json',
+        title: 'AgentKit Page Spec',
+        description: 'Declarative page description compiled by @bestagentkits/render into deterministic, offline, interactive HTML.',
+        type: 'object',
+        additionalProperties: false,
+        required: ['version', 'meta', 'blocks'],
+        properties: {
+            version: { const: SPEC_SCHEMA_VERSION, description: 'Page Spec schema version.' },
+            meta: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['title'],
+                properties: {
+                    title: { type: 'string', minLength: 1, maxLength: 200 },
+                    description: { type: 'string', maxLength: 400 },
+                    locale: { type: 'string', maxLength: 35 },
+                    slug: { type: 'string', maxLength: 120 },
+                },
+            },
+            theme: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    preset: { type: 'string', maxLength: 120 },
+                    extends: { type: 'string', maxLength: 120 },
+                    tokens: { type: 'object' },
+                },
+            },
+            policy: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    network: {
+                        oneOf: [
+                            { const: 'deny' },
+                            {
+                                type: 'object',
+                                additionalProperties: false,
+                                required: ['allow'],
+                                properties: {
+                                    allow: {
+                                        type: 'array',
+                                        minItems: 1,
+                                        maxItems: 8,
+                                        items: { enum: ['media', 'fonts', 'images'] },
+                                    },
+                                },
+                            },
+                        ],
+                    },
+                },
+            },
+            state: {
+                type: 'object',
+                maxProperties: LIMITS.maxMapKeys,
+                additionalProperties: {
+                    type: ['string', 'number', 'boolean', 'null'],
+                },
+            },
+            blocks: blockListSchema(),
+        },
+        $defs: defs,
+    };
+}
+//# sourceMappingURL=registry.js.map