@nextwebwg/html-next 1.0.0-alpha.1

package/dist/component-styles.js

@@ -0,0 +1,236 @@
+/**
+ * Component style compilation (nextwebwg.org/html-next/styling).
+ *
+ * A style block applies to its component's region: from the root (`[data-component~="tag"]`) down
+ * to nested component roots and projected content. `:host` selects the root, `:host-state()` the root
+ * while resolved props and state match, and `:slotted()` projected content at any depth.
+ *
+ * The browser needs no CSS parser: the three pseudo-classes are renamed into selectors it accepts, it
+ * parses the block twice (the component's own markup, and projected content), each copy drops the
+ * other's rules, and the remaining selectors are rewritten through the CSS Object Model. Build tools
+ * run the same selector rewrite over a CSS parser (`component-styles-build.ts`).
+ */
+import { fail } from "./diagnostics.js";
+import { rewriteValiditySelectors } from "./validity-css.js";
+/** Names a component on its root, and only its root. Delegated roots list every owner. */
+export const COMPONENT_ATTRIBUTE = "data-component";
+/** Marks each top-level projected node. */
+export const PROJECTED_ATTRIBUTE = "data-slotted";
+export function addAttributeToken(element, attribute, token) {
+    const tokens = new Set((element.getAttribute(attribute) ?? "").split(/\s+/).filter(Boolean));
+    tokens.add(token);
+    element.setAttribute(attribute, Array.from(tokens).join(" "));
+}
+export function markProjectedRoot(node) {
+    if (node.nodeType === 1)
+        node.setAttribute(PROJECTED_ATTRIBUTE, "");
+}
+/** The attribute carrying the resolved values a definition's `:host-state()` rules test. */
+export function stateAttribute(tag) {
+    return `data-${tag}-state`;
+}
+const SENTINEL = { slotted: "[--slotted]", state: "[--state]" };
+const RENAMABLE = /\/\*[\s\S]*?\*\/|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|:(slotted|host-state)\(/g;
+/**
+ * Renames `:slotted(` and `:host-state(` into valid selectors, skipping comments and strings. A
+ * target that has its own `:slotted()` (Vue) renames only `:host-state(`.
+ */
+export function renameComponentPseudoClasses(css, kinds = ["slotted", "host-state"]) {
+    return css.replace(RENAMABLE, (match, kind) => kind === undefined || !kinds.includes(kind) ? match : `:where(${kind === "slotted" ? SENTINEL.slotted : SENTINEL.state}):is(`);
+}
+/** Whether a renamed selector belongs to projected content rather than the component's own markup. */
+export function styleRuleKind(selector) {
+    return /:where\(\s*\[--slotted\]\s*\)/.test(selector) ? "slotted" : "own";
+}
+/** Index of the parenthesis that closes the one opened at `open`, skipping strings. */
+function closingParenthesis(value, open) {
+    let depth = 0;
+    for (let index = open; index < value.length; index += 1) {
+        const character = value[index];
+        if (character === "\"" || character === "'") {
+            const end = value.indexOf(character, index + 1);
+            index = end === -1 ? value.length : end;
+        }
+        else if (character === "(")
+            depth += 1;
+        else if (character === ")" && --depth === 0)
+            return index;
+    }
+    return value.length;
+}
+const STATE_TEST = /\[\s*([\w-]+)\s*(?:=\s*(?:"((?:\\.|[^"\\])*)"|'((?:\\.|[^'\\])*)'|([^\]\s]+))\s*)?\]/g;
+/** `[name]` and `[name="value"]` tests as tokens of the state attribute. */
+function stateTokens(tests, tag, names, canonical) {
+    let output = "";
+    for (const match of tests.matchAll(STATE_TEST)) {
+        const name = canonical(match[1]);
+        const value = match[2] ?? match[3] ?? match[4];
+        names.add(name);
+        output += `[${stateAttribute(tag)}~="${value === undefined ? name : `${name}=${encodeURIComponent(value)}`}"]`;
+    }
+    return output;
+}
+/** Type selectors naming components, outside brackets and strings. */
+function rewriteComponentTags(selector) {
+    let output = "";
+    for (let index = 0; index < selector.length; index += 1) {
+        const character = selector[index];
+        if (character === "[") {
+            const end = selector.indexOf("]", index);
+            const stop = end === -1 ? selector.length : end + 1;
+            output += selector.slice(index, stop);
+            index = stop - 1;
+            continue;
+        }
+        const previous = output.at(-1);
+        const startsCompound = previous === undefined || /[\s>+~(,]/.test(previous);
+        const tag = startsCompound ? /^[a-z][a-z0-9]*(?:-[a-z0-9]+)+(?![\w-]|\()/.exec(selector.slice(index))?.[0] : undefined;
+        if (tag !== undefined) {
+            output += `:is(${tag}, :where([${COMPONENT_ATTRIBUTE}~="${tag}"]))`;
+            index += tag.length - 1;
+            continue;
+        }
+        output += character;
+    }
+    return output;
+}
+/**
+ * Rewrites one renamed selector. `host` is what `:host` becomes: `:scope` inside the component's
+ * `@scope` rules (both of them are rooted at the component root), or the root's own selector where
+ * there is no `@scope` (Vue's scoped styles).
+ */
+export function rewriteComponentSelector(selector, tag, host, names, canonical = (name) => name) {
+    if (/:scope(?![\w-])/.test(selector)) {
+        fail("HY003", `\`:scope\` is not part of component styles; select the root with \`:host\` (in <${tag}>).`);
+    }
+    let output = "";
+    let index = 0;
+    const state = /:where\(\s*\[--state\]\s*\):is\(/g;
+    for (let match = state.exec(selector); match !== null; match = state.exec(selector)) {
+        const open = match.index + match[0].length - 1;
+        const close = closingParenthesis(selector, open);
+        output += `${selector.slice(index, match.index)}${host}${stateTokens(selector.slice(open + 1, close), tag, names, canonical)}`;
+        index = close + 1;
+        state.lastIndex = index;
+    }
+    output += selector.slice(index);
+    output = output
+        .replace(/:where\(\s*\[--slotted\]\s*\):is\(/g, `:where([${PROJECTED_ATTRIBUTE}], [${PROJECTED_ATTRIBUTE}] *):is(`)
+        .replace(/:host(?![\w-])/g, host);
+    return rewriteComponentTags(rewriteValiditySelectors(output));
+}
+/** Wraps the compiled groups in the component's two scopes; `hoisted` rules stay document-wide. */
+export function assembleComponentStyles(tag, own, slotted, hoisted) {
+    const root = `[${COMPONENT_ATTRIBUTE}~="${tag}"]`;
+    return [
+        hoisted,
+        own.trim() === "" ? "" : `@scope (${root}) to ([${COMPONENT_ATTRIBUTE}], [${PROJECTED_ATTRIBUTE}]) {\n${own}\n}`,
+        slotted.trim() === "" ? "" : `@scope (${root}) to ([${COMPONENT_ATTRIBUTE}]) {\n${slotted}\n}`,
+    ].filter((part) => part !== "").join("\n");
+}
+/** Scalars, keywords, enums, and unions of them can be tested; lists, records, and objects cannot. */
+function stylableType(type) {
+    if (typeof type === "string")
+        return true;
+    if (type === null || typeof type !== "object")
+        return false;
+    if ("enum" in type)
+        return true;
+    const node = type;
+    if (node.kind === "union")
+        return (node.members ?? []).every(stylableType);
+    return node.kind !== "list" && node.kind !== "record" && node.kind !== "object";
+}
+/** Rejects `:host-state()` tests on names that are not declared props or state of a stylable type. */
+export function validateStateNames(definition, names, source) {
+    const states = new Set((definition.declarations ?? [])
+        .filter((declaration) => declaration.kind === "state")
+        .map((declaration) => declaration.name));
+    for (const name of names) {
+        const prop = definition.contract.props[name];
+        if (prop === undefined && !states.has(name)) {
+            fail("HY001", `\`:host-state()\` tests \`${name}\`, which is not a declared prop or state.`, source);
+        }
+        if (prop !== undefined && !stylableType(prop.type)) {
+            fail("HY002", `\`:host-state()\` cannot test \`${name}\`, whose type is structured.`, source);
+        }
+    }
+}
+/** Compiles a style block in a browser through the CSS Object Model. */
+export function compileComponentStyles(css, definition, document, source) {
+    const tag = definition.contract.tag;
+    if (css.trim() === "")
+        return { css: "", stateNames: [] };
+    const Sheet = (document.defaultView ?? globalThis).CSSStyleSheet;
+    const renamed = renameComponentPseudoClasses(css);
+    const names = new Set();
+    const hoisted = [];
+    const view = document.defaultView ?? globalThis;
+    const StyleRule = view.CSSStyleRule;
+    const GroupingRule = view.CSSGroupingRule;
+    // The Object Model serializes attribute names in lowercase, so `[validationStatus]` comes back as
+    // `[validationstatus]`; state tests resolve against the declared names without regard to case.
+    const declared = new Map([
+        ...Object.keys(definition.contract.props),
+        ...(definition.declarations ?? []).filter((declaration) => declaration.kind === "state").map((declaration) => declaration.name),
+    ].map((name) => [name.toLowerCase(), name]));
+    const canonical = (name) => declared.get(name.toLowerCase()) ?? name;
+    const rewriteNested = (rule) => {
+        rule.selectorText = rewriteComponentSelector(rule.selectorText, tag, ":scope", names, canonical);
+        for (const child of Array.from(rule.cssRules ?? [])) {
+            if (child instanceof StyleRule)
+                rewriteNested(child);
+        }
+    };
+    // Keeps the rules of one kind, rewriting their selectors; grouping rules keep their structure.
+    const prune = (container, want, topLevel) => {
+        // In source order, so state names are collected in first-use order, as build tools collect them.
+        const rules = container.cssRules;
+        for (let index = 0; index < rules.length;) {
+            const rule = rules[index];
+            if (rule instanceof StyleRule) {
+                if (styleRuleKind(rule.selectorText) === want) {
+                    rewriteNested(rule);
+                    index += 1;
+                }
+                else
+                    container.deleteRule(index);
+            }
+            else if (rule instanceof GroupingRule) {
+                prune(rule, want, false);
+                index += 1;
+            }
+            else {
+                // Document-wide rules (@keyframes, @font-face, @property, …) are hoisted once, unscoped.
+                if (topLevel && want === "own")
+                    hoisted.push(rule.cssText);
+                container.deleteRule(index);
+            }
+        }
+    };
+    const compile = (want) => {
+        const sheet = new Sheet();
+        sheet.replaceSync(renamed);
+        prune(sheet, want, true);
+        return Array.from(sheet.cssRules, (rule) => rule.cssText).join("\n");
+    };
+    const own = compile("own");
+    const slotted = compile("slotted");
+    validateStateNames(definition, names, source);
+    return { css: assembleComponentStyles(tag, own, slotted, hoisted.join("\n")), stateNames: [...names] };
+}
+/** The state attribute's tokens for the current values: `name` while truthy, `name=value` for text. */
+export function stateAttributeValue(names, read) {
+    const tokens = [];
+    for (const name of names) {
+        const value = read(name);
+        const truthy = value === true || (typeof value === "string" && value.length > 0) ||
+            (typeof value === "number" && value !== 0 && !Number.isNaN(value));
+        if (truthy)
+            tokens.push(name);
+        if (typeof value === "string" || typeof value === "number")
+            tokens.push(`${name}=${encodeURIComponent(String(value))}`);
+    }
+    return tokens.join(" ");
+}
+//# sourceMappingURL=component-styles.js.map

package/dist/component-styles.js.map

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

package/dist/contract-platform.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentContract, DefineContractOptions } from "./types.js";
+export { serializePropTarget } from "./contract.js";
+/** Defines a contract using the build-time DOM interface inventory. */
+export declare function defineContract(input: unknown, options?: DefineContractOptions): ComponentContract;
+//# sourceMappingURL=contract-platform.d.ts.map

package/dist/contract-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-platform.d.ts","sourceRoot":"","sources":["../src/contract-platform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAEnB"}

package/dist/contract-platform.js

@@ -0,0 +1,8 @@
+import { defineContractWithNativeCheck } from "./contract.js";
+import { getDomInterface } from "./platform.js";
+export { serializePropTarget } from "./contract.js";
+/** Defines a contract using the build-time DOM interface inventory. */
+export function defineContract(input, options = {}) {
+    return defineContractWithNativeCheck(input, options, (name) => getDomInterface(name) !== undefined);
+}
+//# sourceMappingURL=contract-platform.js.map

package/dist/contract-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-platform.js","sourceRoot":"","sources":["../src/contract-platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAO,GAA0B,EAAE;IAEnC,OAAO,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;AACtG,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentContract, DefineContractOptions, PropContract, PropType, SerializedPropTarget } from "./types.js";
+export { componentName as deriveName } from "./names.js";
+/**
+ * Parses a `<prop type>` attribute into a raw prop type. A single scalar keyword
+ * (`string`/`number`/`boolean`) stays scalar; anything else is an enum whose members are
+ * split on the CSS value-definition-syntax single bar `|` (Values and Units, "one of").
+ */
+export declare function parseTypeAttribute(value: string): PropType;
+/** Coerces a `<prop default>` attribute string into a value of the declared type. */
+export declare function coerceDefault(type: PropType, raw: string): unknown;
+export declare function defineContractWithNativeCheck(input: unknown, options: DefineContractOptions, isNativeElement: (name: string) => boolean): ComponentContract;
+export declare function serializePropTarget(prop: PropContract, provided: unknown): SerializedPropTarget;
+export type { ComponentContract, DefineContractOptions, PropContract, PropTarget, PropType, SerializedPropTarget, } from "./types.js";
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,iBAAiB,EAEjB,qBAAqB,EAErB,YAAY,EAEZ,QAAQ,EAER,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAmBzD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAgB1D;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlE;AA0ID,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,EAC9B,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACzC,iBAAiB,CAmDnB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,OAAO,GAChB,oBAAoB,CAkCtB;AAED,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/contract.js

@@ -0,0 +1,234 @@
+import { fail } from "./diagnostics.js";
+import { deepFreeze } from "./freeze.js";
+import { componentName } from "./names.js";
+import { formatType, isAttributeType, isTypeNode, parseTypedValue, parseTypeExpression, serializeTypedValue, } from "./type-system.js";
+export { componentName as deriveName } from "./names.js";
+const CONTRACT_FIELDS = [
+    "status",
+    "summary",
+    "nativeElement",
+    "props",
+];
+const PROP_FIELDS = [
+    "type",
+    "default",
+    "required",
+    "target",
+    "description",
+];
+const STATUS_RE = /^(?:early|experimental|stable|deprecated)$/;
+/**
+ * Parses a `<prop type>` attribute into a raw prop type. A single scalar keyword
+ * (`string`/`number`/`boolean`) stays scalar; anything else is an enum whose members are
+ * split on the CSS value-definition-syntax single bar `|` (Values and Units, "one of").
+ */
+export function parseTypeAttribute(value) {
+    let parsed;
+    try {
+        parsed = parseTypeExpression(value);
+    }
+    catch (error) {
+        fail("HC013", error instanceof Error ? error.message : "Invalid prop type expression.");
+    }
+    if (parsed.kind === "terminal" &&
+        (parsed.name === "string" || parsed.name === "boolean" || parsed.name === "number"))
+        return parsed.name;
+    if (parsed.kind === "keyword")
+        return { enum: [parsed.value] };
+    if (parsed.kind === "union" && parsed.members.every((member) => member.kind === "keyword")) {
+        return { enum: parsed.members.map((member) => member.value) };
+    }
+    return parsed;
+}
+/** Coerces a `<prop default>` attribute string into a value of the declared type. */
+export function coerceDefault(type, raw) {
+    const result = parseTypedValue(raw, type);
+    return result.ok ? result.value : raw;
+}
+function record(value, code, message, source) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        fail(code, message, source);
+    }
+    return value;
+}
+function rejectUnknownFields(value, allowed, source) {
+    const unknown = Object.keys(value).filter((key) => !allowed.includes(key)).sort();
+    if (unknown.length > 0) {
+        fail("HC002", `Unknown field${unknown.length === 1 ? "" : "s"}: ${unknown.join(", ")}.`, source);
+    }
+}
+function requiredString(value, field, source) {
+    if (typeof value !== "string" || value.trim() === "") {
+        fail("HC003", `\`${field}\` must be a non-empty string.`, source);
+    }
+    return value;
+}
+function parseType(value, source) {
+    if (typeof value === "string") {
+        let parsed;
+        try {
+            parsed = parseTypeExpression(value);
+        }
+        catch (error) {
+            fail("HC013", error instanceof Error ? error.message : `Unsupported prop type \`${value}\`.`, source);
+        }
+        return parsed.kind === "terminal" &&
+            (parsed.name === "string" || parsed.name === "boolean" || parsed.name === "number")
+            ? parsed.name
+            : parsed;
+    }
+    const object = record(value, "HC013", "A prop type must be a scalar name or enum object.", source);
+    if (isTypeNode(object)) {
+        try {
+            return parseTypeExpression(formatType(object));
+        }
+        catch (error) {
+            fail("HC013", error instanceof Error ? error.message : "Invalid type node.", source);
+        }
+    }
+    rejectUnknownFields(object, ["enum"], source);
+    if (!Array.isArray(object.enum) || object.enum.length === 0) {
+        fail("HC014", "An enum must contain at least one string member.", source);
+    }
+    if (!object.enum.every((member) => typeof member === "string")) {
+        fail("HC014", "Every enum member must be a string.", source);
+    }
+    const members = object.enum;
+    for (let index = 0; index < members.length; index += 1) {
+        if (members.indexOf(members[index], index + 1) !== -1) {
+            fail("HC014", "Enum members must be unique.", source);
+        }
+    }
+    return { enum: Object.freeze([...members]) };
+}
+function parseTarget(value, source) {
+    const object = record(value, "HC017", "A prop target must be an object.", source);
+    rejectUnknownFields(object, ["attribute", "property"], source);
+    const keys = Object.keys(object);
+    if (keys.length !== 1) {
+        fail("HC017", "A prop target must declare exactly one attribute or property.", source);
+    }
+    if ("attribute" in object) {
+        if (typeof object.attribute !== "string" ||
+            object.attribute === "" ||
+            // oxlint-disable-next-line no-control-regex -- HTML forbids these exact control characters.
+            !/^[^\u0000\t\n\f\r "'>/=]+$/.test(object.attribute)) {
+            fail("HC017", "An attribute target must be a valid HTML attribute name.", source);
+        }
+        return { attribute: object.attribute.toLowerCase() };
+    }
+    if (typeof object.property !== "string" ||
+        !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(object.property)) {
+        fail("HC017", "A property target must be a valid DOM property identifier.", source);
+    }
+    return { property: object.property };
+}
+function accepts(type, value) {
+    return parseTypedValue(value, type).ok;
+}
+function parseProp(name, value, source) {
+    const object = record(value, "HC012", `Prop \`${name}\` must be an object.`, source);
+    rejectUnknownFields(object, PROP_FIELDS, source);
+    const type = parseType(object.type, source);
+    const required = object.required ?? false;
+    if (typeof required !== "boolean") {
+        fail("HC016", `Prop \`${name}\` has a non-boolean \`required\` value.`, source);
+    }
+    if (required && "default" in object) {
+        fail("HC019", `Required prop \`${name}\` cannot also declare a default.`, source);
+    }
+    if ("default" in object && !accepts(type, object.default)) {
+        fail("HC015", `Default for prop \`${name}\` does not satisfy its type.`, source);
+    }
+    const target = parseTarget(object.target, source);
+    if (!isAttributeType(type)) {
+        fail("HC017", `Prop \`${name}\` cannot be written as an HTML attribute; function, unknown, and trusted content types have no text form.`, source);
+    }
+    const description = requiredString(object.description, `props.${name}.description`, source);
+    const normalized = { type, required, target, description };
+    if ("default" in object)
+        normalized.default = object.default;
+    return deepFreeze(normalized);
+}
+export function defineContractWithNativeCheck(input, options, isNativeElement) {
+    const source = options.source;
+    const object = record(input, "HC001", "A component contract must be an object.", source);
+    rejectUnknownFields(object, CONTRACT_FIELDS, source);
+    const tag = requiredString(options.tag, "component", source);
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/.test(tag)) {
+        fail("HC005", "The `component` tag must be lowercase and contain a hyphen.", source);
+    }
+    const name = componentName(tag);
+    if (object.status !== undefined && (typeof object.status !== "string" || !STATUS_RE.test(object.status))) {
+        fail("HC007", "Component `status` is not recognized.", source);
+    }
+    const summary = object.summary === undefined ? undefined : requiredString(object.summary, "summary", source);
+    const nativeElement = requiredString(object.nativeElement, "nativeElement", source);
+    if (!/^[a-z][a-z0-9-]*$/.test(nativeElement) ||
+        (!isNativeElement(nativeElement) &&
+            !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/.test(nativeElement))) {
+        fail("HC008", "`nativeElement` must be a lowercase HTML element or component tag.", source);
+    }
+    const rawProps = record(object.props, "HC009", "`props` must be an object.", source);
+    const normalizedKeys = new Map();
+    for (const propName of Object.keys(rawProps)) {
+        if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(propName)) {
+            fail("HC010", `Invalid prop name \`${propName}\`.`, source);
+        }
+        const key = propName.toLowerCase();
+        const prior = normalizedKeys.get(key);
+        if (prior !== undefined) {
+            fail("HC011", `Props \`${prior}\` and \`${propName}\` collide after lowercase normalization.`, source);
+        }
+        normalizedKeys.set(key, propName);
+    }
+    const props = {};
+    for (const propName of Object.keys(rawProps).sort()) {
+        props[propName] = parseProp(propName, rawProps[propName], source);
+    }
+    return deepFreeze({
+        version: 1,
+        name,
+        tag,
+        ...(object.status === undefined ? {} : { status: object.status }),
+        ...(summary === undefined ? {} : { summary }),
+        nativeElement,
+        props,
+    });
+}
+export function serializePropTarget(prop, provided) {
+    const value = provided === undefined ? prop.default : provided;
+    if (value === undefined) {
+        if (prop.required) {
+            fail("HC020", "A required prop value was omitted.");
+        }
+        if ("attribute" in prop.target) {
+            return { kind: "attribute", name: prop.target.attribute, value: null };
+        }
+        return { kind: "property", name: prop.target.property, value: null };
+    }
+    if (value === null) {
+        if (prop.required) {
+            fail("HC021", "A prop value does not satisfy its declared type.");
+        }
+        if ("attribute" in prop.target) {
+            return { kind: "attribute", name: prop.target.attribute, value: null };
+        }
+        return { kind: "property", name: prop.target.property, value: null };
+    }
+    if (!accepts(prop.type, value)) {
+        fail("HC021", "A prop value does not satisfy its declared type.");
+    }
+    const parsed = parseTypedValue(value, prop.type);
+    if (!parsed.ok)
+        fail("HC021", "A prop value does not satisfy its declared type.");
+    const canonical = parsed.value;
+    if ("property" in prop.target) {
+        return { kind: "property", name: prop.target.property, value: canonical };
+    }
+    if (typeof canonical === "boolean") {
+        return { kind: "attribute", name: prop.target.attribute, value: canonical ? "" : null };
+    }
+    return { kind: "attribute", name: prop.target.attribute, value: serializeTypedValue(canonical, prop.type) };
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/controller-files.d.ts

@@ -0,0 +1,10 @@
+import type { GeneratedArtifact } from "./generate.js";
+/** The deepest directory containing every path. */
+export declare function commonDirectory(paths: readonly string[]): string;
+/**
+ * Copies a controller and its relative imports under `targetRoot`, named relative to the deepest
+ * directory that holds the whole graph: the component's own directory unless the controller imports
+ * a shared module beside it. The graph must stay inside the component's package (`trustRoot`).
+ */
+export declare function addControllerGraph(sourceURL: string, trustRoot: string, targetRoot: string, artifacts: Map<string, GeneratedArtifact>): Promise<string>;
+//# sourceMappingURL=controller-files.d.ts.map

package/dist/controller-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-files.d.ts","sourceRoot":"","sources":["../src/controller-files.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAavD,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMhE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/controller-files.js

@@ -0,0 +1,54 @@
+/** Copies a component's controller module and its relative imports into generated output. */
+import { readFile } from "node:fs/promises";
+import { dirname, relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import ts from "typescript-compiler";
+/** The controller module and its static relative imports, by file URL. */
+async function readControllerGraph(sourceURL, files) {
+    if (files.has(sourceURL))
+        return;
+    const content = await readFile(fileURLToPath(sourceURL), "utf8");
+    files.set(sourceURL, content);
+    for (const item of ts.preProcessFile(content, true, true).importedFiles) {
+        if (!item.fileName.startsWith(".") && !item.fileName.startsWith("/"))
+            continue;
+        await readControllerGraph(new URL(item.fileName, sourceURL).href, files);
+    }
+}
+/** The deepest directory containing every path. */
+export function commonDirectory(paths) {
+    let common = dirname(paths[0]);
+    for (const path of paths.slice(1)) {
+        while (relative(common, path).startsWith(`..${sep}`))
+            common = dirname(common);
+    }
+    return common;
+}
+/**
+ * Copies a controller and its relative imports under `targetRoot`, named relative to the deepest
+ * directory that holds the whole graph: the component's own directory unless the controller imports
+ * a shared module beside it. The graph must stay inside the component's package (`trustRoot`).
+ */
+export async function addControllerGraph(sourceURL, trustRoot, targetRoot, artifacts) {
+    const files = new Map();
+    await readControllerGraph(sourceURL, files);
+    const root = fileURLToPath(trustRoot);
+    const paths = [...files.keys()].map((url) => fileURLToPath(url));
+    for (const path of paths) {
+        const withinRoot = relative(root, path);
+        if (withinRoot === ".." || withinRoot.startsWith(`..${sep}`)) {
+            throw new Error(`Controller module escaped its component root: ${path}.`);
+        }
+    }
+    const base = commonDirectory(paths);
+    const target = (path) => `${targetRoot}/${relative(base, path).split(sep).join("/")}`;
+    for (const [url, content] of files) {
+        const path = target(fileURLToPath(url));
+        const prior = artifacts.get(path);
+        if (prior !== undefined && prior.content !== content)
+            throw new Error(`Generated artifact collision at ${path}.`);
+        artifacts.set(path, { path, content });
+    }
+    return target(fileURLToPath(sourceURL));
+}
+//# sourceMappingURL=controller-files.js.map

package/dist/controller-files.js.map

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