@nextwebwg/html-next 1.0.0-alpha.1

package/dist/controller.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentGraphNode } from "./graph.js";
+import type { ComponentHost } from "./runtime.js";
+/** A component controller invoked with the instance's lifecycle-owned host. */
+export type Controller = (host: ComponentHost) => void | (() => void) | Promise<void | (() => void)>;
+export type ModuleImporter = (url: string) => Promise<unknown>;
+export interface ControllerModule {
+    readonly default: Controller;
+    readonly [name: string]: unknown;
+}
+/** Loads and validates a declared controller through the host's native ESM loader. */
+export declare function loadControllerModule(node: ComponentGraphNode, importer?: ModuleImporter): Promise<ControllerModule>;
+export declare function loadController(node: ComponentGraphNode, importer?: ModuleImporter): Promise<Controller>;
+/** Test/runtime boundary for documents that need an isolated native-module cache view. */
+export declare function clearControllerCache(): void;
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,aAAa,KAChB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAID,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,GAAE,cAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,GAAE,cAAqC,GAC9C,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/controller.js

@@ -0,0 +1,33 @@
+import { fail } from "./diagnostics.js";
+const controllerModules = new Map();
+/** Loads and validates a declared controller through the host's native ESM loader. */
+export function loadControllerModule(node, importer = (url) => import(url)) {
+    const edge = node.controller;
+    if (edge === undefined) {
+        return Promise.reject(new TypeError(`<${node.definition.contract.tag}> does not declare a controller.`));
+    }
+    let pending = controllerModules.get(edge.url);
+    if (pending === undefined) {
+        pending = importer(edge.url).then((module) => {
+            const candidate = module?.default;
+            if (typeof candidate !== "function") {
+                fail("HJ002", `Controller module \`${edge.url}\` must default-export a function.`, node.url);
+            }
+            return Object.freeze({ ...module, default: candidate });
+        }).catch((error) => {
+            if (error instanceof Error && "diagnostic" in error)
+                throw error;
+            fail("HJ001", `Controller module \`${edge.url}\` failed to load: ${error instanceof Error ? error.message : String(error)}.`, node.url);
+        });
+        controllerModules.set(edge.url, pending);
+    }
+    return pending;
+}
+export async function loadController(node, importer = (url) => import(url)) {
+    return (await loadControllerModule(node, importer)).default;
+}
+/** Test/runtime boundary for documents that need an isolated native-module cache view. */
+export function clearControllerCache() {
+    controllerModules.clear();
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAcxC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAqC,CAAC;AAEvE,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAClC,IAAwB,EACxB,QAAQ,GAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;IAE/C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,kCAAkC,CAAC,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3C,MAAM,SAAS,GAAI,MAAuC,EAAE,OAAO,CAAC;YACpE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,EAAE,uBAAuB,IAAI,CAAC,GAAG,oCAAoC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/F,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAI,MAAkC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAqB,CAAC;QAC3G,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC1B,IAAI,KAAK,YAAY,KAAK,IAAI,YAAY,IAAI,KAAK;gBAAE,MAAM,KAAK,CAAC;YACjE,IAAI,CACF,OAAO,EACP,uBAAuB,IAAI,CAAC,GAAG,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAC9G,IAAI,CAAC,GAAG,CACT,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB,EACxB,QAAQ,GAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;IAE/C,OAAO,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB;IAClC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/data.d.ts

@@ -0,0 +1,28 @@
+export interface DataState<T = unknown> {
+    readonly pending: boolean;
+    readonly value: T | null;
+    readonly error: unknown | null;
+    readonly ok: boolean;
+}
+export interface DataRequestOptions<T = unknown> {
+    readonly source: string;
+    readonly baseURL: string;
+    readonly type?: string;
+    readonly debounce?: number;
+    readonly poll?: number;
+    readonly fetch?: typeof fetch;
+    readonly setTimer?: (callback: () => void, delay: number) => unknown;
+    readonly clearTimer?: (handle: unknown) => void;
+    /** Optional application adapter for validation, coercion, or projection before publication. */
+    readonly adapt?: (value: unknown) => T;
+    readonly onState: (state: DataState<T>) => void;
+}
+/** An owned, abortable declared read with injectable network and clock boundaries. */
+export declare class DataResource<T = unknown> {
+    #private;
+    readonly options: DataRequestOptions<T>;
+    constructor(options: DataRequestOptions<T>);
+    update(parameters: Readonly<Record<string, unknown>>): void;
+    disconnect(): void;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjD;AAqBD,sFAAsF;AACtF,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;;IAUvB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAAnD,YAAqB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAIlD;IAED,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAW1D;IAED,UAAU,IAAI,IAAI,CAKjB;CAwCF"}

package/dist/data.js

@@ -0,0 +1,100 @@
+function requestURL(source, baseURL, parameters) {
+    const used = new Set();
+    const expanded = source.replace(/\{([A-Za-z_$][A-Za-z0-9_$-]*)\}/g, (_match, name) => {
+        used.add(name);
+        const value = parameters[name];
+        return value == null ? "" : encodeURIComponent(String(value));
+    });
+    const url = new URL(expanded, baseURL);
+    for (const [name, value] of Object.entries(parameters)) {
+        if (used.has(name) || value == null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(name, String(item));
+        }
+        else {
+            url.searchParams.set(name, String(value));
+        }
+    }
+    return url.href;
+}
+/** An owned, abortable declared read with injectable network and clock boundaries. */
+export class DataResource {
+    options;
+    #fetch;
+    #setTimer;
+    #clearTimer;
+    #parameters = {};
+    #abort;
+    #timer;
+    #generation = 0;
+    #connected = false;
+    constructor(options) {
+        this.options = options;
+        this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.#setTimer = options.setTimer ?? ((callback, delay) => setTimeout(callback, delay));
+        this.#clearTimer = options.clearTimer ?? ((handle) => clearTimeout(handle));
+    }
+    update(parameters) {
+        this.#parameters = { ...parameters };
+        this.#connected = true;
+        this.#cancel();
+        const generation = ++this.#generation;
+        const run = () => { void this.#request(generation); };
+        if ((this.options.debounce ?? 0) > 0) {
+            this.#timer = this.#setTimer(run, this.options.debounce);
+        }
+        else {
+            run();
+        }
+    }
+    disconnect() {
+        if (!this.#connected)
+            return;
+        this.#connected = false;
+        this.#generation += 1;
+        this.#cancel();
+    }
+    #cancel() {
+        this.#abort?.abort();
+        this.#abort = undefined;
+        if (this.#timer !== undefined)
+            this.#clearTimer(this.#timer);
+        this.#timer = undefined;
+    }
+    #stale(generation) {
+        return !this.#connected || generation !== this.#generation;
+    }
+    async #request(generation) {
+        if (this.#stale(generation))
+            return;
+        const abort = new AbortController();
+        this.#abort = abort;
+        const previous = this.options;
+        previous.onState({ pending: true, value: null, error: null, ok: false });
+        try {
+            const response = await this.#fetch(requestURL(previous.source, previous.baseURL, this.#parameters), { signal: abort.signal });
+            if (!response.ok)
+                throw new TypeError(`Request failed with ${response.status}.`);
+            const raw = previous.type === "text" ? await response.text() : await response.json();
+            const value = previous.adapt === undefined ? raw : previous.adapt(raw);
+            if (this.#stale(generation))
+                return;
+            previous.onState({ pending: false, value, error: null, ok: true });
+        }
+        catch (error) {
+            if (abort.signal.aborted || this.#stale(generation))
+                return;
+            previous.onState({ pending: false, value: null, error, ok: false });
+        }
+        finally {
+            if (this.#abort === abort)
+                this.#abort = undefined;
+            if (!this.#stale(generation) && (previous.poll ?? 0) > 0) {
+                this.#timer = this.#setTimer(() => { void this.#request(generation); }, previous.poll);
+            }
+        }
+    }
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,11 @@
+export interface HtmlDiagnostic {
+    readonly code: string;
+    readonly message: string;
+    readonly source?: string;
+}
+export declare class HtmlDiagnosticError extends Error {
+    readonly diagnostic: HtmlDiagnostic;
+    constructor(diagnostic: HtmlDiagnostic);
+}
+export declare function fail(code: string, message: string, source?: string): never;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,YAAY,UAAU,EAAE,cAAc,EAKrC;CACF;AAED,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,KAAK,CAIP"}

package/dist/diagnostics.js

@@ -0,0 +1,13 @@
+export class HtmlDiagnosticError extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        const location = diagnostic.source ? `${diagnostic.source}: ` : "";
+        super(`${location}${diagnostic.code}: ${diagnostic.message}`);
+        this.name = "HtmlDiagnosticError";
+        this.diagnostic = Object.freeze({ ...diagnostic });
+    }
+}
+export function fail(code, message, source) {
+    throw new HtmlDiagnosticError(source === undefined ? { code, message } : { code, message, source });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,UAAU,CAAiB;IAEpC,YAAY,UAA0B;QACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,KAAK,CAAC,GAAG,QAAQ,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAClB,IAAY,EACZ,OAAe,EACf,MAAe;IAEf,MAAM,IAAI,mBAAmB,CAC3B,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CACrE,CAAC;AACJ,CAAC"}

package/dist/expression.d.ts

@@ -0,0 +1,80 @@
+/** A missing read or an operation on missing/typed-invalid data. */
+export declare const ABSENT: unique symbol;
+export type Absent = typeof ABSENT;
+export type Value = string | number | boolean | null | Absent | readonly Value[] | {
+    readonly [key: string]: Value;
+};
+/** Expressions only look names up, so any `Map` or reactive scope layer can supply them. */
+export interface Scope {
+    get(name: string): Value | undefined;
+}
+export declare class UndeclaredName extends Error {
+    readonly identifier: string;
+    constructor(identifier: string);
+}
+export type ExpressionNode = {
+    kind: "literal";
+    value: Value;
+} | {
+    kind: "id";
+    name: string;
+} | {
+    kind: "member";
+    object: ExpressionNode;
+    key: string;
+} | {
+    kind: "index";
+    object: ExpressionNode;
+    index: ExpressionNode;
+} | {
+    kind: "unary";
+    op: "not" | "-";
+    operand: ExpressionNode;
+} | {
+    kind: "binary";
+    op: string;
+    left: ExpressionNode;
+    right: ExpressionNode;
+} | {
+    kind: "call";
+    fn: string;
+    args: ExpressionNode[];
+} | {
+    kind: "object";
+    pairs: {
+        key: string;
+        value: ExpressionNode;
+    }[];
+} | {
+    kind: "array";
+    items: ExpressionNode[];
+};
+export interface CompiledExpression {
+    readonly source: string;
+    readonly ast: ExpressionNode;
+    readonly dependencies: readonly string[];
+}
+export type WritablePathSegment = string | number | {
+    readonly kind: "index";
+    readonly expression: ExpressionNode;
+};
+export type WritablePath = readonly WritablePathSegment[];
+/** Truthiness follows the empty value of each type. */
+export declare function truthy(value: Value): boolean;
+/** Compile an expression once for parsers, runtimes, and target generators. */
+export declare function compileExpression(source: string): CompiledExpression;
+/** Return a writable path only when it is rooted in declared writable state. */
+export declare function getWritablePath(source: string, writableRoots: ReadonlySet<string>): WritablePath | undefined;
+/** Parse-check an expression (syntax only). */
+export declare function checkExpression(source: string): void;
+/** Evaluate an expression against a scope. */
+export declare function evaluate(source: string, scope: Scope): Value;
+/** Evaluate a previously compiled expression without reparsing its source. */
+export declare function evaluateCompiled(expression: CompiledExpression | ExpressionNode, scope: Scope): Value;
+/** Escaped-text form: absence and null render as empty text. */
+export declare function toText(value: Value): string;
+/** Enumerated attributes whose true and false are the strings "true" and "false", not presence. */
+export declare function isEnumeratedBoolean(name: string): boolean;
+/** Serialize an ordinary bound attribute. */
+export declare function toAttribute(value: Value, name?: string): string | null;
+//# sourceMappingURL=expression.d.ts.map

package/dist/expression.d.ts.map

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