@fayegram-ai/faye-ui 0.0.0-stage → 0.1.0

package/dist/contracts/index.js

@@ -0,0 +1,194 @@
+export const SCHEMA_VERSION = 1;
+export class ContractError extends Error {
+    path;
+    constructor(path, message) {
+        super(`${path}: ${message}`);
+        this.path = path;
+        this.name = 'ContractError';
+    }
+}
+export function assertIdentifier(value, path) {
+    if (typeof value !== 'string' || !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/.test(value) || value.length > 100 || ['constructor', 'prototype'].includes(value))
+        throw new ContractError(path, 'expected a lowercase, namespaced identifier of at most 100 characters');
+}
+export function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+/** Validate shape before accessing properties of externally supplied JSON. */
+export function assertRecord(value, path) {
+    if (!isRecord(value))
+        throw new ContractError(path, 'expected a plain object');
+}
+/** Token contracts are validated independently of theme implementations and extensions. */
+export function validateTokenContract(schema) {
+    assertPortable(schema);
+    assertRecord(schema, 'contract');
+    const names = new Set();
+    const types = ['color', 'length', 'duration', 'number', 'fontFamily', 'fontWeight', 'shadow', 'easing', 'string'];
+    for (const [key, spec] of Object.entries(schema)) {
+        assertIdentifier(key, 'contract.token');
+        assertRecord(spec, `contract.${key}`);
+        if (!types.includes(spec.type) || typeof spec.description !== 'string' ||
+            (spec.runtime !== undefined && typeof spec.runtime !== 'boolean') ||
+            Object.keys(spec).some(k => !['type', 'description', 'runtime'].includes(k)))
+            throw new ContractError(`contract.${key}`, 'invalid token specification');
+        const cssName = key.replaceAll('.', '-');
+        if (names.has(cssName))
+            throw new ContractError('contract', `CSS variable name collision: ${cssName}`);
+        names.add(cssName);
+    }
+    return schema;
+}
+// Figma's main sandbox has no TextEncoder. Count UTF-8 bytes without requiring
+// browser globals; lone surrogates use the encoder's three-byte replacement.
+function utf8ByteLength(source) {
+    let bytes = 0;
+    for (const character of source) {
+        const point = character.codePointAt(0);
+        bytes += point <= 0x7f ? 1 : point <= 0x7ff ? 2 : point <= 0xffff ? 3 : 4;
+    }
+    return bytes;
+}
+/** Reject executable data, cyclic objects, prototype keys and excessively large inputs. */
+export function assertPortable(value, maxBytes = 256000) {
+    const seen = new WeakSet();
+    let nodes = 0;
+    const walk = (item, path, depth) => {
+        if (++nodes > 20000 || depth > 32)
+            throw new ContractError(path, 'input exceeds complexity limits');
+        if (item === null || typeof item === 'boolean' || typeof item === 'string')
+            return;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return;
+        if (typeof item !== 'object' || item === null)
+            throw new ContractError(path, 'expected portable JSON data');
+        if (seen.has(item))
+            throw new ContractError(path, 'cyclic object or repeated object reference');
+        seen.add(item);
+        if (Object.getOwnPropertySymbols(item).length)
+            throw new ContractError(path, 'symbol keys are not portable');
+        if (Array.isArray(item)) {
+            const descriptors = Object.getOwnPropertyDescriptors(item);
+            for (const key of Object.keys(descriptors))
+                if (key !== 'length' && !/^(0|[1-9]\d*)$/.test(key))
+                    throw new ContractError(path, 'array properties are not portable');
+            for (let i = 0; i < item.length; i++) {
+                const descriptor = descriptors[String(i)];
+                if (!descriptor || !('value' in descriptor))
+                    throw new ContractError(path, 'sparse arrays and accessors are not portable');
+                walk(descriptor.value, `${path}[${i}]`, depth + 1);
+            }
+        }
+        else {
+            if (!isRecord(item))
+                throw new ContractError(path, 'expected a plain object');
+            for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(item))) {
+                if (['__proto__', 'prototype', 'constructor'].includes(key))
+                    throw new ContractError(path, `forbidden key ${key}`);
+                if (!descriptor.enumerable)
+                    throw new ContractError(path, 'non-enumerable data is not portable');
+                if (!('value' in descriptor))
+                    throw new ContractError(path, 'accessors are not portable');
+                walk(descriptor.value, `${path}.${key}`, depth + 1);
+            }
+        }
+        seen.delete(item);
+    };
+    walk(value, '$', 0);
+    if (utf8ByteLength(JSON.stringify(value)) > maxBytes)
+        throw new ContractError('$', 'input exceeds byte limit');
+}
+export function parsePortable(source, maxBytes = 256000) {
+    if (utf8ByteLength(source) > maxBytes)
+        throw new ContractError('$', 'input exceeds byte limit');
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new ContractError('$', 'invalid JSON');
+    }
+    assertPortable(value, maxBytes);
+    return value;
+}
+export function deepFreeze(value) {
+    const seen = new WeakSet();
+    const freeze = (item) => {
+        if (!item || typeof item !== 'object' || seen.has(item))
+            return;
+        seen.add(item);
+        for (const child of Object.values(item))
+            freeze(child);
+        Object.freeze(item);
+    };
+    freeze(value);
+    return value;
+}
+export function canonicalJson(value) {
+    assertPortable(value);
+    const sort = (item) => Array.isArray(item) ? item.map(sort) : isRecord(item) ? Object.fromEntries(Object.keys(item).sort().map(k => [k, sort(item[k])])) : item;
+    return JSON.stringify(sort(value));
+}
+export function validateDescriptor(value) {
+    assertPortable(value);
+    assertRecord(value, 'component');
+    assertIdentifier(value.name, 'component.name');
+    if (value.schemaVersion !== 1)
+        throw new ContractError('component.schemaVersion', 'unsupported schema');
+    if (!Array.isArray(value.parts) || !value.parts.length)
+        throw new ContractError('component.parts', 'at least one part is required');
+    if (new Set(value.parts).size !== value.parts.length)
+        throw new ContractError('component.parts', 'duplicate part');
+    value.parts.forEach(p => {
+        assertIdentifier(p, 'component.parts');
+        if (p.includes('.'))
+            throw new ContractError('component.parts', 'parts are flat identifiers');
+    });
+    if (Object.keys(value).some(k => !['schemaVersion', 'name', 'parts', 'variants', 'states', 'defaults'].includes(k)))
+        throw new ContractError('component', 'unknown property');
+    if (value.variants !== undefined)
+        assertRecord(value.variants, 'component.variants');
+    if (value.defaults !== undefined)
+        assertRecord(value.defaults, 'component.defaults');
+    for (const [key, choices] of Object.entries(value.variants ?? {})) {
+        assertIdentifier(key, 'component.variants');
+        if (key.includes('.'))
+            throw new ContractError('component.variants', 'variant keys are flat identifiers');
+        if (!Array.isArray(choices) || !choices.length || new Set(choices).size !== choices.length)
+            throw new ContractError(`component.variants.${key}`, 'expected unique choices');
+        choices.forEach(c => assertIdentifier(c, `component.variants.${key}`));
+    }
+    for (const [key, entry] of Object.entries(value.defaults ?? {}))
+        if (!value.variants || !Object.hasOwn(value.variants, key) || !value.variants[key]?.includes(String(entry)))
+            throw new ContractError('component.defaults', 'default must match a declared variant');
+    const states = ['hover', 'active', 'focus-visible', 'disabled', 'checked', 'selected', 'open', 'invalid'];
+    if (value.states && (!Array.isArray(value.states) || new Set(value.states).size !== value.states.length || value.states.some(state => !states.includes(state))))
+        throw new ContractError('component.states', 'invalid or duplicated state');
+    return deepFreeze(structuredClone(value));
+}
+export const defaultAccessibility = /* @__PURE__ */ Object.freeze({ focus: 'auto', hints: 'auto', contrast: 'system' });
+/** Undefined properties inherit; explicit auto/system restores automatic behavior. */
+export function resolveAccessibility(...sources) {
+    const value = { ...defaultAccessibility };
+    for (const source of sources) {
+        if (source === undefined)
+            continue;
+        if (!source || typeof source !== 'object' || Array.isArray(source))
+            throw new TypeError('accessibility must be a configuration object');
+        for (const [key, entry] of Object.entries(source)) {
+            if (!['focus', 'hints', 'contrast'].includes(key))
+                throw new TypeError('Unknown accessibility preference: ' + key);
+            if (entry === undefined)
+                continue;
+            if (!(key === 'contrast' ? ['system', 'more'] : ['auto', 'always']).includes(entry))
+                throw new TypeError('Invalid accessibility.' + key);
+            Object.assign(value, { [key]: entry });
+        }
+    }
+    return Object.freeze(value);
+}
+export function accessibilityAttributes(options) {
+    const value = resolveAccessibility(options);
+    return { 'data-faye-ui-focus': value.focus, 'data-faye-ui-hints': value.hints, 'data-faye-ui-contrast': value.contrast };
+}
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["/** Portable contracts. This package has no React, DOM, styling or component imports. */\nexport type { InteractionOptions, InteractionVariant, InteractionLevel, TrackInteractionEffect, InteractionVariantOverrides } from './interaction.js';\nexport type { IconAttribute, IconAttributes, IconNode, IconDefinition } from './icon.js';\nexport const SCHEMA_VERSION = 1 as const;\nexport type Scheme = 'light' | 'dark';\nexport type ColorPreference = Scheme | 'system';\nexport type Density = 'comfortable' | 'compact';\nexport type Direction = 'ltr' | 'rtl';\nexport type TokenType = 'color' | 'length' | 'duration' | 'number' | 'fontFamily' | 'fontWeight' | 'shadow' | 'easing' | 'string';\nexport type TokenValue = string | number;\nexport interface TokenReference {\n    readonly $ref: string;\n}\nexport interface TokenDefinition {\n    readonly $type: TokenType;\n    readonly $value: TokenValue | TokenReference;\n    readonly description?: string;\n}\nexport type TokenSet = Readonly<Record<string, TokenDefinition>>;\nexport interface TokenSpec {\n    readonly type: TokenType;\n    readonly description: string;\n    readonly runtime?: boolean;\n}\nexport type TokenContract = Readonly<Record<string, TokenSpec>>;\nexport interface ThemeAxis {\n    readonly default: string;\n    readonly values: Readonly<Record<string, TokenSet>>;\n}\nexport type ThemeAxes = Readonly<Record<string, ThemeAxis>>;\nexport interface ThemeCondition {\n    readonly id: string;\n    readonly when: {\n        readonly scheme?: Scheme;\n        readonly density?: Density;\n        readonly axes?: Readonly<Record<string, string>>;\n    };\n    readonly tokens: TokenSet;\n}\nexport interface ThemeDefinition {\n    readonly schemaVersion: 1;\n    readonly id: string;\n    readonly tokens: TokenSet;\n    readonly schemes?: Readonly<Partial<Record<Scheme, TokenSet>>>;\n    readonly densities?: Readonly<Partial<Record<Density, TokenSet>>>;\n    readonly axes?: ThemeAxes;\n    readonly conditions?: readonly ThemeCondition[];\n}\nexport interface ResolvedTheme {\n    readonly schemaVersion: 1;\n    readonly id: string;\n    readonly scheme: Scheme;\n    readonly density: Density;\n    readonly axes: Readonly<Record<string, string>>;\n    readonly values: Readonly<Record<string, TokenValue>>;\n    readonly types: Readonly<Record<string, TokenType>>;\n}\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | readonly JsonValue[] | {\n    readonly [key: string]: JsonValue;\n};\nexport type StyleValue = string | number | {\n    readonly token: string;\n};\nexport type Declarations = Readonly<Record<string, StyleValue>>;\nexport type PseudoState = 'hover' | 'active' | 'focus-visible' | 'disabled' | 'checked' | 'selected' | 'open' | 'invalid';\nexport interface ComponentDescriptor {\n    readonly schemaVersion: 1;\n    readonly name: string;\n    readonly parts: readonly string[];\n    readonly variants?: Readonly<Record<string, readonly string[]>>;\n    readonly states?: readonly PseudoState[];\n    readonly defaults?: Readonly<Record<string, JsonPrimitive>>;\n}\nexport interface StyleRule {\n    readonly id: string;\n    readonly part: string;\n    readonly when?: Readonly<Record<string, string>>;\n    readonly state?: PseudoState;\n    /** Named breakpoint. Query structure is compiled, not a runtime CSS variable. */\n    readonly breakpoint?: string;\n    /** Select print or screen without injecting an arbitrary media query. */\n    readonly media?: 'print' | 'screen';\n    readonly container?: {\n        readonly name?: string;\n        readonly minWidth?: string;\n        readonly maxWidth?: string;\n    };\n    readonly declarations: Declarations;\n}\nexport interface ComponentSheet {\n    readonly schemaVersion: 1;\n    readonly id: string;\n    readonly component: string;\n    readonly defaults?: Readonly<Record<string, JsonPrimitive>>;\n    readonly rules: readonly StyleRule[];\n}\nexport interface SheetPatch {\n    readonly defaults?: Readonly<Record<string, JsonPrimitive>>;\n    readonly removeDefaults?: readonly string[];\n    readonly removeRules?: readonly string[];\n    readonly rules?: readonly StyleRule[];\n}\nexport interface ComponentProfile {\n    readonly schemaVersion: 1;\n    readonly id: string;\n    readonly component: string;\n    readonly classes: Readonly<Record<string, string>>;\n    readonly defaults: Readonly<Record<string, JsonPrimitive>>;\n}\nexport interface CompiledSheet {\n    readonly css: string;\n    readonly profile: ComponentProfile;\n    readonly provenance: Readonly<Record<string, string>>;\n}\nexport interface ExtensionDescriptor {\n    readonly schemaVersion: 1;\n    readonly name: string;\n    readonly version: string;\n    readonly contractVersion: 1;\n    readonly components: readonly ComponentDescriptor[];\n    readonly tokens?: TokenContract;\n    readonly styles: readonly string[];\n}\nexport class ContractError extends Error {\n    constructor(readonly path: string, message: string) { super(`${path}: ${message}`); this.name = 'ContractError'; }\n}\nexport function assertIdentifier(value: unknown, path: string): asserts value is string {\n    if (typeof value !== 'string' || !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/.test(value) || value.length > 100 || ['constructor', 'prototype'].includes(value))\n        throw new ContractError(path, 'expected a lowercase, namespaced identifier of at most 100 characters');\n}\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);\n}\n/** Validate shape before accessing properties of externally supplied JSON. */\nexport function assertRecord(value: unknown, path: string): asserts value is Record<string, unknown> {\n    if (!isRecord(value))\n        throw new ContractError(path, 'expected a plain object');\n}\n/** Token contracts are validated independently of theme implementations and extensions. */\nexport function validateTokenContract(schema: TokenContract): TokenContract {\n    assertPortable(schema);\n    assertRecord(schema, 'contract');\n    const names = new Set<string>();\n    const types = ['color', 'length', 'duration', 'number', 'fontFamily', 'fontWeight', 'shadow', 'easing', 'string'];\n    for (const [key, spec] of Object.entries(schema)) {\n        assertIdentifier(key, 'contract.token');\n        assertRecord(spec, `contract.${key}`);\n        if (!types.includes(spec.type) || typeof spec.description !== 'string' ||\n            (spec.runtime !== undefined && typeof spec.runtime !== 'boolean') ||\n            Object.keys(spec).some(k => !['type', 'description', 'runtime'].includes(k)))\n            throw new ContractError(`contract.${key}`, 'invalid token specification');\n        const cssName = key.replaceAll('.', '-');\n        if (names.has(cssName))\n            throw new ContractError('contract', `CSS variable name collision: ${cssName}`);\n        names.add(cssName);\n    }\n    return schema;\n}\n// Figma's main sandbox has no TextEncoder. Count UTF-8 bytes without requiring\n// browser globals; lone surrogates use the encoder's three-byte replacement.\nfunction utf8ByteLength(source: string): number {\n    let bytes = 0;\n    for (const character of source) {\n        const point = character.codePointAt(0)!;\n        bytes += point <= 0x7f ? 1 : point <= 0x7ff ? 2 : point <= 0xffff ? 3 : 4;\n    }\n    return bytes;\n}\n/** Reject executable data, cyclic objects, prototype keys and excessively large inputs. */\nexport function assertPortable(value: unknown, maxBytes = 256000): asserts value is JsonValue {\n    const seen = new WeakSet<object>();\n    let nodes = 0;\n    const walk = (item: unknown, path: string, depth: number): void => {\n        if (++nodes > 20000 || depth > 32)\n            throw new ContractError(path, 'input exceeds complexity limits');\n        if (item === null || typeof item === 'boolean' || typeof item === 'string')\n            return;\n        if (typeof item === 'number' && Number.isFinite(item))\n            return;\n        if (typeof item !== 'object' || item === null)\n            throw new ContractError(path, 'expected portable JSON data');\n        if (seen.has(item))\n            throw new ContractError(path, 'cyclic object or repeated object reference');\n        seen.add(item);\n        if (Object.getOwnPropertySymbols(item).length)\n            throw new ContractError(path, 'symbol keys are not portable');\n        if (Array.isArray(item)) {\n            const descriptors = Object.getOwnPropertyDescriptors(item);\n            for (const key of Object.keys(descriptors))\n                if (key !== 'length' && !/^(0|[1-9]\\d*)$/.test(key))\n                    throw new ContractError(path, 'array properties are not portable');\n            for (let i = 0; i < item.length; i++) {\n                const descriptor = descriptors[String(i)];\n                if (!descriptor || !('value' in descriptor))\n                    throw new ContractError(path, 'sparse arrays and accessors are not portable');\n                walk(descriptor.value, `${path}[${i}]`, depth + 1);\n            }\n        }\n        else {\n            if (!isRecord(item))\n                throw new ContractError(path, 'expected a plain object');\n            for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(item))) {\n                if (['__proto__', 'prototype', 'constructor'].includes(key))\n                    throw new ContractError(path, `forbidden key ${key}`);\n                if (!descriptor.enumerable)\n                    throw new ContractError(path, 'non-enumerable data is not portable');\n                if (!('value' in descriptor))\n                    throw new ContractError(path, 'accessors are not portable');\n                walk(descriptor.value, `${path}.${key}`, depth + 1);\n            }\n        }\n        seen.delete(item);\n    };\n    walk(value, '$', 0);\n    if (utf8ByteLength(JSON.stringify(value)) > maxBytes)\n        throw new ContractError('$', 'input exceeds byte limit');\n}\nexport function parsePortable(source: string, maxBytes = 256000): JsonValue {\n    if (utf8ByteLength(source) > maxBytes)\n        throw new ContractError('$', 'input exceeds byte limit');\n    let value: unknown;\n    try {\n        value = JSON.parse(source);\n    }\n    catch {\n        throw new ContractError('$', 'invalid JSON');\n    }\n    assertPortable(value, maxBytes);\n    return value;\n}\nexport function deepFreeze<T>(value: T): Readonly<T> {\n    const seen = new WeakSet<object>();\n    const freeze = (item: unknown): void => {\n        if (!item || typeof item !== 'object' || seen.has(item))\n            return;\n        seen.add(item);\n        for (const child of Object.values(item))\n            freeze(child);\n        Object.freeze(item);\n    };\n    freeze(value);\n    return value;\n}\nexport function canonicalJson(value: unknown): string {\n    assertPortable(value);\n    const sort = (item: JsonValue): JsonValue => Array.isArray(item) ? item.map(sort) : isRecord(item) ? Object.fromEntries(Object.keys(item).sort().map(k => [k, sort(item[k] as JsonValue)])) : item;\n    return JSON.stringify(sort(value));\n}\nexport function validateDescriptor(value: ComponentDescriptor): ComponentDescriptor {\n    assertPortable(value);\n    assertRecord(value, 'component');\n    assertIdentifier(value.name, 'component.name');\n    if (value.schemaVersion !== 1)\n        throw new ContractError('component.schemaVersion', 'unsupported schema');\n    if (!Array.isArray(value.parts) || !value.parts.length)\n        throw new ContractError('component.parts', 'at least one part is required');\n    if (new Set(value.parts).size !== value.parts.length)\n        throw new ContractError('component.parts', 'duplicate part');\n    value.parts.forEach(p => {\n        assertIdentifier(p, 'component.parts');\n        if (p.includes('.'))\n            throw new ContractError('component.parts', 'parts are flat identifiers');\n    });\n    if (Object.keys(value).some(k => !['schemaVersion', 'name', 'parts', 'variants', 'states', 'defaults'].includes(k)))\n        throw new ContractError('component', 'unknown property');\n    if (value.variants !== undefined)\n        assertRecord(value.variants, 'component.variants');\n    if (value.defaults !== undefined)\n        assertRecord(value.defaults, 'component.defaults');\n    for (const [key, choices] of Object.entries(value.variants ?? {})) {\n        assertIdentifier(key, 'component.variants');\n        if (key.includes('.'))\n            throw new ContractError('component.variants', 'variant keys are flat identifiers');\n        if (!Array.isArray(choices) || !choices.length || new Set(choices).size !== choices.length)\n            throw new ContractError(`component.variants.${key}`, 'expected unique choices');\n        choices.forEach(c => assertIdentifier(c, `component.variants.${key}`));\n    }\n    for (const [key, entry] of Object.entries(value.defaults ?? {}))\n        if (!value.variants || !Object.hasOwn(value.variants, key) || !value.variants[key]?.includes(String(entry)))\n            throw new ContractError('component.defaults', 'default must match a declared variant');\n    const states = ['hover', 'active', 'focus-visible', 'disabled', 'checked', 'selected', 'open', 'invalid'];\n    if (value.states && (!Array.isArray(value.states) || new Set(value.states).size !== value.states.length || value.states.some(state => !states.includes(state))))\n        throw new ContractError('component.states', 'invalid or duplicated state');\n    return deepFreeze(structuredClone(value));\n}\n\n/** Presentation preferences. Semantics and keyboard operation are always available. */\nexport interface AccessibilityOptions {\n    readonly focus?: 'auto' | 'always';\n    readonly hints?: 'auto' | 'always';\n    readonly contrast?: 'system' | 'more';\n}\nexport type AccessibilityPreferences = Readonly<Required<AccessibilityOptions>>;\nexport const defaultAccessibility: AccessibilityPreferences = /* @__PURE__ */ Object.freeze({ focus: 'auto', hints: 'auto', contrast: 'system' });\n\n/** Undefined properties inherit; explicit auto/system restores automatic behavior. */\nexport function resolveAccessibility(...sources: readonly (AccessibilityOptions | undefined)[]): AccessibilityPreferences {\n    const value = { ...defaultAccessibility };\n    for (const source of sources) {\n        if (source === undefined) continue;\n        if (!source || typeof source !== 'object' || Array.isArray(source)) throw new TypeError('accessibility must be a configuration object');\n        for (const [key, entry] of Object.entries(source)) {\n            if (!['focus', 'hints', 'contrast'].includes(key)) throw new TypeError('Unknown accessibility preference: ' + key);\n            if (entry === undefined) continue;\n            if (!(key === 'contrast' ? ['system', 'more'] : ['auto', 'always']).includes(entry as string)) throw new TypeError('Invalid accessibility.' + key);\n            Object.assign(value, { [key]: entry });\n        }\n    }\n    return Object.freeze(value);\n}\n\nexport function accessibilityAttributes(options?: AccessibilityOptions) {\n    const value = resolveAccessibility(options);\n    return { 'data-faye-ui-focus': value.focus, 'data-faye-ui-hints': value.hints, 'data-faye-ui-contrast': value.contrast } as const;\n}\n"]}

package/dist/contracts/interaction.d.ts

@@ -0,0 +1,33 @@
+/** Shared portable configuration. Additional variant names require matching CSS. */
+export interface InteractionVariantOverrides {
+}
+export type InteractionVariant = 'classic' | 'minimal' | 'soft' | Extract<keyof InteractionVariantOverrides, string>;
+export type InteractionLevel = 'standard' | 'enhanced';
+export type TrackInteractionEffect = {
+    readonly type: 'expand';
+    readonly scale?: number;
+    readonly duration?: number;
+} | {
+    readonly type: 'highlight';
+    readonly duration?: number;
+} | {
+    readonly type: 'none';
+};
+export interface InteractionOptions {
+    readonly variant?: InteractionVariant;
+    readonly level?: InteractionLevel;
+    readonly effects?: {
+        readonly track?: TrackInteractionEffect;
+    };
+}
+/** Merge declarations before resolving presets. A different effect drops incompatible options. */
+export declare function mergeInteractionOptions(...sources: readonly (InteractionOptions | undefined)[]): InteractionOptions;
+export declare function resolveInteractionOptions(options?: InteractionOptions): {
+    readonly variant: InteractionVariant;
+    readonly level: InteractionLevel;
+    readonly track: "expand" | "highlight" | "none";
+    readonly scale: number | undefined;
+    readonly duration: number | undefined;
+    readonly highlight: boolean;
+};
+//# sourceMappingURL=interaction.d.ts.map

package/dist/contracts/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../packages/contracts/src/interaction.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,2BAA2B;CAAG;AAC/C,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,2BAA2B,EAAE,MAAM,CAAC,CAAC;AACrH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAChC,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAA;KAAE,CAAC;CAClE;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,kBAAkB,GAAG,SAAS,CAAC,EAAE,GAAG,kBAAkB,CAgBnH;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB;;;;;;;EAWzE"}

package/dist/contracts/interaction.js

@@ -0,0 +1,40 @@
+/** Merge declarations before resolving presets. A different effect drops incompatible options. */
+export function mergeInteractionOptions(...sources) {
+    let variant, level, track;
+    for (const source of sources) {
+        if (source === undefined)
+            continue;
+        if (!source || typeof source !== 'object' || Array.isArray(source))
+            throw new TypeError('interaction must be a configuration object');
+        if (source.variant !== undefined)
+            variant = source.variant;
+        if (source.level !== undefined)
+            level = source.level;
+        const next = source.effects?.track;
+        if (next !== undefined) {
+            const defined = Object.fromEntries(Object.entries(next).filter(([, value]) => value !== undefined));
+            track = track?.type === next.type ? { ...track, ...defined } : { ...defined };
+        }
+    }
+    const result = { ...(variant !== undefined && { variant }), ...(level !== undefined && { level }), ...(track !== undefined && { effects: { track } }) };
+    resolveInteractionOptions(result);
+    return result;
+}
+export function resolveInteractionOptions(options = {}) {
+    const variant = options.variant ?? 'minimal', level = options.level ?? 'standard';
+    if (typeof variant !== 'string' || !/^[a-z][a-z0-9-]*$/.test(variant))
+        throw new TypeError('Invalid interaction variant');
+    if (!['standard', 'enhanced'].includes(level))
+        throw new TypeError('Invalid interaction level');
+    const track = options.effects?.track ?? { type: variant === 'classic' ? 'none' : 'expand' };
+    if (!['expand', 'highlight', 'none'].includes(track.type))
+        throw new TypeError('Invalid track interaction effect');
+    const scale = track.type === 'expand' ? track.scale : undefined;
+    const duration = track.type !== 'none' ? track.duration : undefined;
+    if (scale !== undefined && (!Number.isFinite(scale) || scale < 1 || scale > 2))
+        throw new RangeError('Interaction scale must be between 1 and 2');
+    if (duration !== undefined && (!Number.isFinite(duration) || duration < 0))
+        throw new RangeError('Interaction duration must be finite and nonnegative');
+    return { variant, level, track: track.type, scale, duration, highlight: track.type === 'highlight' || track.type === 'expand' && variant === 'soft' };
+}
+//# sourceMappingURL=interaction.js.map

package/dist/contracts/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["interaction.ts"],"names":[],"mappings":"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","sourcesContent":["/** Shared portable configuration. Additional variant names require matching CSS. */\nexport interface InteractionVariantOverrides {}\nexport type InteractionVariant = 'classic' | 'minimal' | 'soft' | Extract<keyof InteractionVariantOverrides, string>;\nexport type InteractionLevel = 'standard' | 'enhanced';\nexport type TrackInteractionEffect =\n    | { readonly type: 'expand'; readonly scale?: number; readonly duration?: number }\n    | { readonly type: 'highlight'; readonly duration?: number }\n    | { readonly type: 'none' };\nexport interface InteractionOptions {\n    readonly variant?: InteractionVariant;\n    readonly level?: InteractionLevel;\n    readonly effects?: { readonly track?: TrackInteractionEffect };\n}\n\n/** Merge declarations before resolving presets. A different effect drops incompatible options. */\nexport function mergeInteractionOptions(...sources: readonly (InteractionOptions | undefined)[]): InteractionOptions {\n    let variant: InteractionVariant | undefined, level: InteractionLevel | undefined, track: TrackInteractionEffect | undefined;\n    for (const source of sources) {\n        if (source === undefined) continue;\n        if (!source || typeof source !== 'object' || Array.isArray(source)) throw new TypeError('interaction must be a configuration object');\n        if (source.variant !== undefined) variant = source.variant;\n        if (source.level !== undefined) level = source.level;\n        const next = source.effects?.track;\n        if (next !== undefined) {\n            const defined = Object.fromEntries(Object.entries(next).filter(([, value]) => value !== undefined)) as TrackInteractionEffect;\n            track = track?.type === next.type ? { ...track, ...defined } : { ...defined };\n        }\n    }\n    const result = { ...(variant !== undefined && { variant }), ...(level !== undefined && { level }), ...(track !== undefined && { effects: { track } }) };\n    resolveInteractionOptions(result);\n    return result;\n}\n\nexport function resolveInteractionOptions(options: InteractionOptions = {}) {\n    const variant = options.variant ?? 'minimal', level = options.level ?? 'standard';\n    if (typeof variant !== 'string' || !/^[a-z][a-z0-9-]*$/.test(variant)) throw new TypeError('Invalid interaction variant');\n    if (!['standard', 'enhanced'].includes(level)) throw new TypeError('Invalid interaction level');\n    const track: TrackInteractionEffect = options.effects?.track ?? { type: variant === 'classic' ? 'none' : 'expand' };\n    if (!['expand', 'highlight', 'none'].includes(track.type)) throw new TypeError('Invalid track interaction effect');\n    const scale = track.type === 'expand' ? track.scale : undefined;\n    const duration = track.type !== 'none' ? track.duration : undefined;\n    if (scale !== undefined && (!Number.isFinite(scale) || scale < 1 || scale > 2)) throw new RangeError('Interaction scale must be between 1 and 2');\n    if (duration !== undefined && (!Number.isFinite(duration) || duration < 0)) throw new RangeError('Interaction duration must be finite and nonnegative');\n    return { variant, level, track: track.type, scale, duration, highlight: track.type === 'highlight' || track.type === 'expand' && variant === 'soft' } as const;\n}\n"]}

package/dist/contracts/scope.d.ts

@@ -0,0 +1,26 @@
+import { type Scheme, type Density, type Direction } from './index.js';
+import { type AccessibilityOptions } from './index.js';
+export type AxisSelection = Readonly<Record<string, string>>;
+/** Small server/client-safe DOM contract. Membership in a theme's choices is validated by the theme resolver. */
+export declare function axisAttributes(axes: AxisSelection): Readonly<Record<string, string>>;
+export declare function themeScopeAttributes(options: {
+    themeId: string;
+    scheme: Scheme;
+    density?: Density;
+    direction?: Direction;
+    axes?: AxisSelection;
+    motion?: 'system' | 'reduced';
+    accessibility?: AccessibilityOptions;
+    systemContrast?: 'normal' | 'more';
+}): Readonly<{
+    'data-faye-ui-focus': "auto" | "always";
+    'data-faye-ui-hints': "auto" | "always";
+    'data-faye-ui-contrast': "system" | "more";
+    'data-faye-ui-system-contrast'?: "more" | "normal" | undefined;
+    'data-faye-ui-motion'?: "reduced" | undefined;
+    'data-faye-ui-theme': string;
+    'data-faye-ui-scheme': Scheme;
+    'data-faye-ui-density': Density;
+    dir: Direction;
+}>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/contracts/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../packages/contracts/src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7D,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWpF;AACD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACtC;;;;;;;;;;GAMA"}

package/dist/contracts/scope.js

@@ -0,0 +1,24 @@
+import { assertIdentifier, assertRecord, ContractError } from './index.js';
+import { accessibilityAttributes } from './index.js';
+/** Small server/client-safe DOM contract. Membership in a theme's choices is validated by the theme resolver. */
+export function axisAttributes(axes) {
+    assertRecord(axes, 'scope.axes');
+    const attributes = {};
+    for (const name of Object.keys(axes).sort()) {
+        assertIdentifier(name, 'scope.axes');
+        assertIdentifier(axes[name], `scope.axes.${name}`);
+        if (name.includes('.') || axes[name].includes('.') || ['scheme', 'density', 'direction', 'theme'].includes(name))
+            throw new ContractError('scope.axes', 'expected nonreserved flat axis names and values');
+        attributes[`data-faye-ui-axis-${name}`] = axes[name];
+    }
+    return Object.freeze(attributes);
+}
+export function themeScopeAttributes(options) {
+    assertIdentifier(options.themeId, 'scope.themeId');
+    if (!['light', 'dark'].includes(options.scheme) || !['comfortable', 'compact'].includes(options.density ?? 'comfortable') || !['ltr', 'rtl'].includes(options.direction ?? 'ltr') || !['system', 'reduced'].includes(options.motion ?? 'system'))
+        throw new ContractError('scope', 'unsupported environment value');
+    if (options.systemContrast !== undefined && !['normal', 'more'].includes(options.systemContrast))
+        throw new ContractError('scope.systemContrast', 'unsupported system contrast');
+    return Object.freeze({ 'data-faye-ui-theme': options.themeId, 'data-faye-ui-scheme': options.scheme, 'data-faye-ui-density': options.density ?? 'comfortable', dir: options.direction ?? 'ltr', ...(options.motion === 'reduced' ? { 'data-faye-ui-motion': 'reduced' } : {}), ...(options.systemContrast !== undefined ? { 'data-faye-ui-system-contrast': options.systemContrast } : {}), ...accessibilityAttributes(options.accessibility), ...axisAttributes(options.axes ?? {}) });
+}
+//# sourceMappingURL=scope.js.map

package/dist/contracts/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAA6C,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,uBAAuB,EAA6B,MAAM,YAAY,CAAC;AAEhF,iHAAiH;AACjH,MAAM,UAAU,cAAc,CAAC,IAAmB;IAC9C,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACjC,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACrC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC7G,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,iDAAiD,CAAC,CAAC;QAC7F,UAAU,CAAC,qBAAqB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAE,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,oBAAoB,CAAC,OASpC;IACG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;QAC5O,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;IACjL,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,8BAA8B,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,uBAAuB,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5d,CAAC","sourcesContent":["import { assertIdentifier, assertRecord, ContractError, type Scheme, type Density, type Direction } from './index.js';\nimport { accessibilityAttributes, type AccessibilityOptions } from './index.js';\nexport type AxisSelection = Readonly<Record<string, string>>;\n/** Small server/client-safe DOM contract. Membership in a theme's choices is validated by the theme resolver. */\nexport function axisAttributes(axes: AxisSelection): Readonly<Record<string, string>> {\n    assertRecord(axes, 'scope.axes');\n    const attributes: Record<string, string> = {};\n    for (const name of Object.keys(axes).sort()) {\n        assertIdentifier(name, 'scope.axes');\n        assertIdentifier(axes[name], `scope.axes.${name}`);\n        if (name.includes('.') || axes[name]!.includes('.') || ['scheme', 'density', 'direction', 'theme'].includes(name))\n            throw new ContractError('scope.axes', 'expected nonreserved flat axis names and values');\n        attributes[`data-faye-ui-axis-${name}`] = axes[name]!;\n    }\n    return Object.freeze(attributes);\n}\nexport function themeScopeAttributes(options: {\n    themeId: string;\n    scheme: Scheme;\n    density?: Density;\n    direction?: Direction;\n    axes?: AxisSelection;\n    motion?: 'system' | 'reduced';\n    accessibility?: AccessibilityOptions;\n    systemContrast?: 'normal' | 'more';\n}) {\n    assertIdentifier(options.themeId, 'scope.themeId');\n    if (!['light', 'dark'].includes(options.scheme) || !['comfortable', 'compact'].includes(options.density ?? 'comfortable') || !['ltr', 'rtl'].includes(options.direction ?? 'ltr') || !['system', 'reduced'].includes(options.motion ?? 'system'))\n        throw new ContractError('scope', 'unsupported environment value');\n    if (options.systemContrast !== undefined && !['normal', 'more'].includes(options.systemContrast)) throw new ContractError('scope.systemContrast', 'unsupported system contrast');\n    return Object.freeze({ 'data-faye-ui-theme': options.themeId, 'data-faye-ui-scheme': options.scheme, 'data-faye-ui-density': options.density ?? 'comfortable', dir: options.direction ?? 'ltr', ...(options.motion === 'reduced' ? { 'data-faye-ui-motion': 'reduced' } : {}), ...(options.systemContrast !== undefined ? { 'data-faye-ui-system-contrast': options.systemContrast } : {}), ...accessibilityAttributes(options.accessibility), ...axisAttributes(options.axes ?? {}) });\n}\n"]}

package/dist/contracts/server/accessibility.js

@@ -0,0 +1,2 @@
+/** Portable accessibility presentation contracts; the root stays self-contained. */
+export { defaultAccessibility, resolveAccessibility, accessibilityAttributes } from './index.js';

package/dist/contracts/server/extend-descriptor.js

@@ -0,0 +1,24 @@
+import { assertPortable, assertRecord, ContractError, validateDescriptor } from './index.js';
+/** Extend a descriptor without mutating the library contract. Axes merge by name; choices append uniquely. */
+export function extendDescriptor(base, patch) {
+    const checked = validateDescriptor(base);
+    assertPortable(patch);
+    assertRecord(patch, 'descriptor.patch');
+    if (Object.keys(patch).some(key => !['parts', 'variants', 'states', 'defaults'].includes(key)))
+        throw new ContractError('descriptor.patch', 'unknown field');
+    if (patch.variants !== undefined)
+        assertRecord(patch.variants, 'descriptor.patch.variants');
+    if (patch.defaults !== undefined)
+        assertRecord(patch.defaults, 'descriptor.patch.defaults');
+    if (patch.parts !== undefined && !Array.isArray(patch.parts))
+        throw new ContractError('descriptor.patch.parts', 'expected array');
+    if (patch.states !== undefined && !Array.isArray(patch.states))
+        throw new ContractError('descriptor.patch.states', 'expected array');
+    const variants = { ...checked.variants };
+    for (const [name, choices] of Object.entries(patch.variants ?? {})) {
+        if (!Array.isArray(choices) || !choices.length || new Set(choices).size !== choices.length)
+            throw new ContractError(`descriptor.patch.variants.${name}`, 'expected nonempty unique choices');
+        variants[name] = [...new Set([...(variants[name] ?? []), ...choices])];
+    }
+    return validateDescriptor({ schemaVersion: 1, name: checked.name, parts: [...new Set([...checked.parts, ...(patch.parts ?? [])])], variants, states: [...new Set([...(checked.states ?? []), ...(patch.states ?? [])])], defaults: { ...checked.defaults, ...patch.defaults } });
+}

package/dist/contracts/server/icon.js

@@ -0,0 +1,92 @@
+const tags = new Set(['g', 'path', 'circle', 'rect', 'line', 'ellipse', 'polyline', 'polygon']);
+const drawing = ['fill', 'stroke', 'strokeWidth', 'strokeLinecap', 'strokeLinejoin', 'fillRule', 'clipRule', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeDasharray', 'strokeDashoffset', 'vectorEffect'];
+const attributes = new Set(['key', 'd', 'cx', 'cy', 'r', 'x', 'y', 'width', 'height', 'rx', 'ry', 'x1', 'x2', 'y1', 'y2', 'points', 'transform', 'className', ...drawing]);
+const rootProperties = new Set(['name', 'aliases', 'node', 'size', 'width', 'height', 'viewBox', 'defaults', 'rtl']);
+/** Converts ordinary SVG attribute spellings to their React equivalents. */
+export function iconAttributeName(name) {
+    return name === 'class' ? 'className' : name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/** Validate authored/imported definitions. No XML, event handlers or resource references. */
+export function validateIconDefinition(icon) {
+    const fail = (path) => { throw new TypeError(`Invalid icon definition: ${path}`); };
+    const checkData = (value, path, array = false) => {
+        if (!value || typeof value !== 'object')
+            return fail(path);
+        const prototype = Object.getPrototypeOf(value);
+        const native = array ? Array : Object;
+        let plain = prototype === native.prototype || !array && prototype === null;
+        if (!plain && prototype) {
+            const constructor = Object.getOwnPropertyDescriptor(prototype, 'constructor')?.value;
+            plain = typeof constructor === 'function' && Function.prototype.toString.call(constructor) === Function.prototype.toString.call(native) && constructor.prototype === prototype;
+        }
+        if (Array.isArray(value) !== array || !plain)
+            fail(`nonplain ${path}`);
+        const keys = Reflect.ownKeys(value);
+        if (Array.isArray(value) && keys.length !== value.length + 1)
+            fail(`sparse or decorated ${path}`);
+        for (const key of keys) {
+            if (array && key === 'length')
+                continue;
+            const property = Object.getOwnPropertyDescriptor(value, key);
+            if (typeof key !== 'string' || array && !/^(0|[1-9]\d*)$/.test(key) || !property.enumerable || !('value' in property))
+                fail(`nonportable ${path}`);
+        }
+    };
+    checkData(icon, 'expected a plain object');
+    if (Object.keys(icon).some(key => !rootProperties.has(key)))
+        fail('unknown root property');
+    if (icon.name !== undefined && (typeof icon.name !== 'string' || !icon.name.length))
+        fail('name');
+    if (icon.aliases !== undefined) {
+        checkData(icon.aliases, 'aliases', true);
+        if (icon.aliases.some(alias => typeof alias !== 'string'))
+            fail('aliases');
+    }
+    for (const key of ['size', 'width', 'height'])
+        if (icon[key] !== undefined && (!Number.isFinite(icon[key]) || icon[key] <= 0))
+            fail(key);
+    if (icon.size !== undefined && (icon.width !== undefined || icon.height !== undefined))
+        fail('use size or width/height');
+    if ((icon.width === undefined) !== (icon.height === undefined))
+        fail('width/height must be paired');
+    if (icon.viewBox !== undefined) {
+        checkData(icon.viewBox, 'viewBox', true);
+        if (icon.viewBox.length !== 4 || icon.viewBox.some(n => !Number.isFinite(n)) || icon.viewBox[2] <= 0 || icon.viewBox[3] <= 0)
+            fail('viewBox');
+    }
+    if (icon.rtl !== undefined && !['none', 'mirror'].includes(icon.rtl))
+        fail('rtl');
+    const checkAttributes = (value, root) => {
+        checkData(value, 'attributes');
+        for (const [name, entry] of Object.entries(value)) {
+            const normalized = iconAttributeName(name);
+            if (!(root ? drawing.includes(normalized) : attributes.has(normalized)))
+                fail(`unsupported attribute ${name}`);
+            if (!['string', 'number', 'boolean'].includes(typeof entry) || typeof entry === 'number' && !Number.isFinite(entry))
+                fail(`nonportable attribute ${name}`);
+            if (typeof entry === 'string' && (entry.length > 65536 || /url\s*\(/i.test(entry)))
+                fail(`resource reference or oversized attribute ${name}`);
+        }
+    };
+    if (icon.defaults !== undefined)
+        checkAttributes(icon.defaults, true);
+    let count = 0;
+    const visit = (nodes, depth) => {
+        checkData(nodes, 'node list', true);
+        if (!nodes.length || depth > 16)
+            fail('node list');
+        for (const node of nodes) {
+            checkData(node, 'node', true);
+            if (++count > 512 || node.length < 2 || node.length > 3 || !tags.has(node[0]))
+                fail('unsupported node');
+            checkAttributes(node[1], false);
+            if (node[2] !== undefined) {
+                if (node[0] !== 'g')
+                    fail('only groups accept children');
+                visit(node[2], depth + 1);
+            }
+        }
+    };
+    visit(icon.node, 0);
+    return icon;
+}