@exactjs/core 0.5.0

package/dist/localization/formatter-pool.js

@@ -0,0 +1,65 @@
+const maximumCachedFormatters = 128;
+const formatters = new Map();
+/** Returns a shared formatter when its locale and options have safe structural identities. */
+export function cachedIntlFormatter(kind, locales, options, create) {
+    const localeKey = finiteLocaleKey(locales);
+    const optionsKey = finiteOptionsKey(options);
+    if (localeKey === undefined || optionsKey === undefined)
+        return create();
+    const key = `${kind}\0${localeKey}\0${optionsKey}`;
+    const cached = formatters.get(key);
+    if (cached) {
+        formatters.delete(key);
+        formatters.set(key, cached);
+        return cached;
+    }
+    const created = create();
+    formatters.set(key, created);
+    if (formatters.size > maximumCachedFormatters)
+        formatters.delete(formatters.keys().next().value);
+    return created;
+}
+/** Returns a duration formatter without caching constructor absence before a polyfill loads. */
+export function cachedDurationFormatter(locales, options) {
+    const DurationFormat = globalThis.Intl.DurationFormat;
+    if (!DurationFormat)
+        return undefined;
+    return cachedIntlFormatter('duration', locales, options, () => new DurationFormat(locales, options));
+}
+/** Clears realm cache state for isolated tests; not part of the public package surface. */
+export function clearIntlFormatterCache() {
+    formatters.clear();
+}
+function finiteLocaleKey(locales) {
+    if (locales === undefined)
+        return 'default';
+    if (typeof locales === 'string')
+        return `string:${locales}`;
+    if (!Array.isArray(locales) || !locales.every((locale) => typeof locale === 'string'))
+        return undefined;
+    return `list:${JSON.stringify(locales)}`;
+}
+function finiteOptionsKey(options) {
+    if (options === undefined)
+        return '{}';
+    const prototype = Object.getPrototypeOf(options);
+    if (prototype !== Object.prototype && prototype !== null)
+        return undefined;
+    const descriptors = Object.getOwnPropertyDescriptors(options);
+    const entries = [];
+    for (const key of Object.keys(descriptors).sort()) {
+        const descriptor = descriptors[key];
+        if (!('value' in descriptor))
+            return undefined;
+        const value = descriptor.value;
+        if (value === undefined)
+            continue;
+        if (value === null || ['string', 'number', 'boolean'].includes(typeof value)) {
+            entries.push([key, value]);
+            continue;
+        }
+        return undefined;
+    }
+    return JSON.stringify(entries);
+}
+//# sourceMappingURL=formatter-pool.js.map

package/dist/localization/formatter-pool.js.map

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

package/dist/localization.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Opt-in component localization integration.
+ *
+ * Compiled components import the narrower runtime entry automatically when they use `this.intl`.
+ * Importing the public localization helpers installs the same integration for compiled library
+ * components that share the caller's runtime.
+ */
+import './localization/component-integration.js';
+export { LocalizationContext } from './localization/context.js';
+export { intl } from './localization/facade.js';
+export type { IntlDurationFormatter, IntlFacade, LocalizationContextValue } from './localization/contracts.js';
+//# sourceMappingURL=localization.d.ts.map

package/dist/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../src/localization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,yCAAyC,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,YAAY,EACX,qBAAqB,EACrB,UAAU,EACV,wBAAwB,EACxB,MAAM,6BAA6B,CAAC"}

package/dist/localization.js

@@ -0,0 +1,11 @@
+/**
+ * Opt-in component localization integration.
+ *
+ * Compiled components import the narrower runtime entry automatically when they use `this.intl`.
+ * Importing the public localization helpers installs the same integration for compiled library
+ * components that share the caller's runtime.
+ */
+import './localization/component-integration.js';
+export { LocalizationContext } from './localization/context.js';
+export { intl } from './localization/facade.js';
+//# sourceMappingURL=localization.js.map

package/dist/localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.js","sourceRoot":"","sources":["../src/localization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,yCAAyC,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,45 @@
+/** Defines the log level type contract. */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+/** Defines the log scope type contract. */
+export type LogScope = {
+    source: 'component' | 'framework';
+    packageName?: string;
+    category?: string;
+    component?: {
+        id: string;
+        name: string;
+        mounted: boolean;
+    };
+};
+/** Reports an observable log event. */
+export type LogEvent = {
+    level: LogLevel;
+    message: string;
+    data?: unknown;
+    error?: unknown;
+    scope: LogScope;
+};
+/** Defines the logger type contract. */
+export type Logger = {
+    isEnabled?(level: LogLevel, scope: LogScope): boolean;
+    log(event: LogEvent): void;
+};
+/** Defines the lazy log value type contract. */
+export type LazyLogValue<T> = T | (() => T);
+/** Defines the component log type contract. */
+export type ComponentLog = {
+    trace(message: LazyLogValue<string>, data?: LazyLogValue<unknown>): void;
+    debug(message: LazyLogValue<string>, data?: LazyLogValue<unknown>): void;
+    info(message: LazyLogValue<string>, data?: LazyLogValue<unknown>): void;
+    warn(message: LazyLogValue<string>, data?: LazyLogValue<unknown>): void;
+    error(message: LazyLogValue<string>, error?: LazyLogValue<unknown>, data?: LazyLogValue<unknown>): void;
+};
+/** Configures console logger. */
+export type ConsoleLoggerOptions = {
+    level?: LogLevel;
+};
+/** Creates a logger implementation that writes formatted eXact events to the console. */
+export declare function createConsoleLogger(options?: ConsoleLoggerOptions): Logger;
+/** Formats a structured log scope into the compact prefix used by framework logs. */
+export declare function formatLogScope(scope: LogScope): string;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG;IACtB,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;KACjB,CAAC;CACF,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,MAAM,GAAG;IACpB,SAAS,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtD,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5C,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACzE,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxE,KAAK,CACJ,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAC7B,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,GAC1B,IAAI,CAAC;CACR,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;CACjB,CAAC;AAUF,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAqB9E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAOtD"}

package/dist/logging.js

@@ -0,0 +1,52 @@
+const logLevelOrder = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4
+};
+/** Creates a logger implementation that writes formatted eXact events to the console. */
+export function createConsoleLogger(options = {}) {
+    const minimumLevel = options.level ?? 'info';
+    return {
+        isEnabled(level) {
+            return logLevelOrder[level] >= logLevelOrder[minimumLevel];
+        },
+        log(event) {
+            const prefix = `${formatLogScope(event.scope)} ${event.message}`;
+            const consoleMethod = getConsoleMethod(event.level);
+            if (event.error !== undefined && event.data !== undefined) {
+                consoleMethod(prefix, event.error, event.data);
+            }
+            else if (event.error !== undefined) {
+                consoleMethod(prefix, event.error);
+            }
+            else if (event.data !== undefined) {
+                consoleMethod(prefix, event.data);
+            }
+            else {
+                consoleMethod(prefix);
+            }
+        }
+    };
+}
+/** Formats a structured log scope into the compact prefix used by framework logs. */
+export function formatLogScope(scope) {
+    if (scope.source === 'component' && scope.component) {
+        return `[exact] [component:${scope.component.name}#${scope.component.id}]`;
+    }
+    const frameworkName = ['framework', scope.packageName, scope.category].filter(Boolean).join(':');
+    return `[exact] [${frameworkName}]`;
+}
+function getConsoleMethod(level) {
+    if (level === 'trace')
+        return console.trace?.bind(console) ?? console.debug.bind(console);
+    if (level === 'debug')
+        return console.debug.bind(console);
+    if (level === 'info')
+        return console.info.bind(console);
+    if (level === 'warn')
+        return console.warn.bind(console);
+    return console.error.bind(console);
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAmDA,MAAM,aAAa,GAA6B;IAC/C,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACR,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACrE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IAE7C,OAAO;QACN,SAAS,CAAC,KAAK;YACd,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5D,CAAC;QACD,GAAG,CAAC,KAAK;YACR,MAAM,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3D,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACP,aAAa,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,KAAe;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACrD,OAAO,sBAAsB,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC;IAC5E,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjG,OAAO,YAAY,aAAa,GAAG,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe;IACxC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1F,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/native-props.d.ts

@@ -0,0 +1,9 @@
+/** Identifies event-shaped native props regardless of authored casing. */
+export declare function isNativeEventProp(name: string): boolean;
+/** Rejects HTML-writing properties that bypass receipt validation and renderer range ownership. */
+export declare function assertNativePropAllowed(name: string): void;
+/** Rejects inline code and non-callable event values before DOM mutation or HTML serialization. */
+export declare function assertNativeEventHandler(value: unknown): void;
+/** Canonicalizes the HTML document attribute before checking its unsafeHtml capability. */
+export declare function isNativeSrcdocProp(name: string): boolean;
+//# sourceMappingURL=native-props.d.ts.map

package/dist/native-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-props.d.ts","sourceRoot":"","sources":["../src/native-props.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiB1D;AAED,mGAAmG;AACnG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM7D;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/native-props.js

@@ -0,0 +1,30 @@
+/** Identifies event-shaped native props regardless of authored casing. */
+export function isNativeEventProp(name) {
+    return (name.length > 2 && (name[0] === 'o' || name[0] === 'O') && (name[1] === 'n' || name[1] === 'N'));
+}
+/** Rejects HTML-writing properties that bypass receipt validation and renderer range ownership. */
+export function assertNativePropAllowed(name) {
+    const first = name[0];
+    if (first !== 'i' &&
+        first !== 'I' &&
+        first !== 'o' &&
+        first !== 'O' &&
+        first !== 'd' &&
+        first !== 'D')
+        return;
+    const lower = name.toLowerCase();
+    if (lower === 'innerhtml' || lower === 'outerhtml' || lower === 'dangerouslysetinnerhtml') {
+        throw new TypeError(`Native eXact does not support ${name}; use unsafeHtml() with explicit root opt-in.`);
+    }
+}
+/** Rejects inline code and non-callable event values before DOM mutation or HTML serialization. */
+export function assertNativeEventHandler(value) {
+    if (value != null && value !== false && typeof value !== 'function') {
+        throw new TypeError('Native eXact event handlers must be functions; inline event strings are not supported.');
+    }
+}
+/** Canonicalizes the HTML document attribute before checking its unsafeHtml capability. */
+export function isNativeSrcdocProp(name) {
+    return name.length === 6 && name.toLowerCase() === 'srcdoc';
+}
+//# sourceMappingURL=native-props.js.map

package/dist/native-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-props.js","sourceRoot":"","sources":["../src/native-props.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,CACN,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAC/F,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IACC,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,GAAG;QAEb,OAAO;IACR,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,yBAAyB,EAAE,CAAC;QAC3F,MAAM,IAAI,SAAS,CAClB,iCAAiC,IAAI,+CAA+C,CACpF,CAAC;IACH,CAAC;AACF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACtD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CAClB,wFAAwF,CACxF,CAAC;IACH,CAAC;AACF,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC;AAC7D,CAAC"}

package/dist/protocol-utf8.d.ts

@@ -0,0 +1,3 @@
+/** Counts UTF-8 bytes without buffering short strings, matching TextEncoder for lone surrogates. */
+export declare function protocolUtf8ByteLength(value: string): number;
+//# sourceMappingURL=protocol-utf8.d.ts.map

package/dist/protocol-utf8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-utf8.d.ts","sourceRoot":"","sources":["../src/protocol-utf8.ts"],"names":[],"mappings":"AACA,oGAAoG;AACpG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB5D"}

package/dist/protocol-utf8.js

@@ -0,0 +1,27 @@
+const encoder = new TextEncoder();
+/** Counts UTF-8 bytes without buffering short strings, matching TextEncoder for lone surrogates. */
+export function protocolUtf8ByteLength(value) {
+    if (value.length > 64)
+        return encoder.encode(value).byteLength;
+    let bytes = 0;
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x7f)
+            bytes++;
+        else if (code <= 0x7ff)
+            bytes += 2;
+        else if (code >= 0xd800 && code <= 0xdbff && index + 1 < value.length) {
+            const next = value.charCodeAt(index + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                bytes += 4;
+                index++;
+            }
+            else
+                bytes += 3;
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+//# sourceMappingURL=protocol-utf8.js.map

package/dist/protocol-utf8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-utf8.js","sourceRoot":"","sources":["../src/protocol-utf8.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAClC,oGAAoG;AACpG,MAAM,UAAU,sBAAsB,CAAC,KAAa;IACnD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;IAC/D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,IAAI,IAAI;YAAE,KAAK,EAAE,CAAC;aACrB,IAAI,IAAI,IAAI,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC9B,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACtC,KAAK,IAAI,CAAC,CAAC;gBACX,KAAK,EAAE,CAAC;YACT,CAAC;;gBAAM,KAAK,IAAI,CAAC,CAAC;QACnB,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,9 @@
+/** Encodes arbitrary UTF-8 data for use inside an eXact HTML comment marker. */
+export declare function encodeExactMarkerPart(value: string): string;
+/** Decodes data emitted by encodeExactMarkerPart; directly encoded safe values pass through. */
+export declare function decodeExactMarkerPart(value: string): string;
+/** Performs the exact marker start domain operation. */
+export declare function exactMarkerStart(id: string): string;
+/** Performs the exact marker end domain operation. */
+export declare function exactMarkerEnd(id: string): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/protocol.js

@@ -0,0 +1,32 @@
+const markerUtf8Encoder = new TextEncoder();
+const markerHexBytes = Array.from({ length: 256 }, (_, byte) => byte.toString(16).padStart(2, '0'));
+/** Encodes arbitrary UTF-8 data for use inside an eXact HTML comment marker. */
+export function encodeExactMarkerPart(value) {
+    if (/^[A-Za-z0-9._-]+$/.test(value) && !value.includes('--'))
+        return value;
+    const bytes = markerUtf8Encoder.encode(value);
+    let encoded = '~';
+    for (let index = 0; index < bytes.length; index++)
+        encoded += markerHexBytes[bytes[index]];
+    return encoded;
+}
+/** Decodes data emitted by encodeExactMarkerPart; directly encoded safe values pass through. */
+export function decodeExactMarkerPart(value) {
+    if (!value.startsWith('~') || !/^(?:[0-9a-f]{2})+$/i.test(value.slice(1)))
+        return value;
+    const hex = value.slice(1);
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let index = 0; index < bytes.length; index++) {
+        bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
+    }
+    return new TextDecoder().decode(bytes);
+}
+/** Performs the exact marker start domain operation. */
+export function exactMarkerStart(id) {
+    return `exact:${id}`;
+}
+/** Performs the exact marker end domain operation. */
+export function exactMarkerEnd(id) {
+    return `/exact:${id}`;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,IAAI,WAAW,EAAE,CAAC;AAC5C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAEpG,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAClD,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,CAAE,CAAE,CAAC;IAC7F,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAClD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxF,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,EAAU;IAC1C,OAAO,SAAS,EAAE,EAAE,CAAC;AACtB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,EAAU;IACxC,OAAO,UAAU,EAAE,EAAE,CAAC;AACvB,CAAC"}

package/dist/render-children.d.ts

@@ -0,0 +1,6 @@
+import type { Child, RenderResult } from './component/contracts.js';
+/** Flattens nested compiler-produced child arrays without assigning renderer topology. */
+export declare function normalizeChildren(children: unknown[]): Child[];
+/** Normalizes one component output into its owned child sequence. */
+export declare function normalizeRenderResult(result: RenderResult): Child[];
+//# sourceMappingURL=render-children.d.ts.map

package/dist/render-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-children.d.ts","sourceRoot":"","sources":["../src/render-children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAI9D;AAUD,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAInE"}

package/dist/render-children.js

@@ -0,0 +1,25 @@
+/** Flattens nested compiler-produced child arrays without assigning renderer topology. */
+export function normalizeChildren(children) {
+    const normalized = [];
+    appendNormalizedChildren(children, normalized);
+    return normalized;
+}
+/** Appends descendants in order without temporary arrays or variadic argument limits. */
+function appendNormalizedChildren(children, normalized) {
+    for (const child of children) {
+        if (Array.isArray(child))
+            appendNormalizedChildren(child, normalized);
+        else
+            normalized.push(child);
+    }
+}
+/** Normalizes one component output into its owned child sequence. */
+export function normalizeRenderResult(result) {
+    if (!Array.isArray(result))
+        return [result];
+    for (const child of result)
+        if (Array.isArray(child))
+            return normalizeChildren(result);
+    return result;
+}
+//# sourceMappingURL=render-children.js.map

package/dist/render-children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-children.js","sourceRoot":"","sources":["../src/render-children.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,QAAmB;IACpD,MAAM,UAAU,GAAY,EAAE,CAAC;IAC/B,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,yFAAyF;AACzF,SAAS,wBAAwB,CAAC,QAAmB,EAAE,UAAmB;IACzE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;;YACjE,UAAU,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;IACtC,CAAC;AACF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACvF,OAAO,MAAiB,CAAC;AAC1B,CAAC"}