@microsoft/fast-element 2.10.4 → 3.0.0-rc.2

package/dist/dts/hydration/diagnostics.d.ts

@@ -0,0 +1,93 @@
+import type { ViewBehaviorFactory } from "../templating/html-directive.js";
+/**
+ * Structured description of the binding hydration was expecting to apply when
+ * a mismatch is detected.
+ * @public
+ */
+export interface HydrationMismatchExpectation {
+    /**
+     * The tag name of the element the binding was expecting (e.g. `"SPAN"`),
+     * or `null` when the binding does not target a specific element (host or
+     * template-level bindings).
+     */
+    tagName: string | null;
+    /**
+     * Human-readable description of the binding aspect, for example
+     * `"content"`, `"property className"`, or `"attribute aria-label"`.
+     */
+    aspect: string;
+}
+/**
+ * Structured description of the DOM hydration actually encountered at the
+ * mismatch point.
+ * @public
+ */
+export interface HydrationMismatchActual {
+    /**
+     * Serialized HTML snippet of the server-rendered DOM where the mismatch
+     * was detected. Truncated with an ellipsis when long.
+     */
+    html: string;
+}
+/**
+ * Result of a hydration-mismatch diagnostic format call.
+ * @public
+ */
+export interface HydrationDiagnosticResult {
+    /**
+     * The error message to attach to the thrown hydration error.
+     */
+    message: string;
+    /**
+     * Structured description of the binding the hydration walk was
+     * attempting to apply. The default diagnostic leaves this `undefined`;
+     * install `hydrationDebugger()` to populate it.
+     */
+    expected?: HydrationMismatchExpectation | string;
+    /**
+     * Structured description of the server-rendered DOM that was
+     * encountered at the mismatch point. The default diagnostic leaves
+     * this `undefined`; install `hydrationDebugger()` to populate it.
+     */
+    received?: HydrationMismatchActual;
+}
+/**
+ * Pluggable formatter for hydration mismatch errors. The default
+ * implementation is a minimal one-line message; install
+ * {@link hydrationDebugger} to swap in the rich "Expected … / Received …"
+ * formatter with an HTML snippet of the SSR DOM.
+ * @public
+ */
+export interface HydrationDiagnostic {
+    /**
+     * Format a binding-resolution mismatch (a factory whose `targetNodeId`
+     * has no entry in the resolved targets after the SSR DOM walk).
+     */
+    formatBindingMismatch(factory: ViewBehaviorFactory, firstChild: Node, lastChild: Node, hostName: string | undefined): HydrationDiagnosticResult;
+    /**
+     * Format a structural error encountered during the SSR DOM walk
+     * (e.g. attribute binding count overflow, missing close marker).
+     */
+    formatStructuralError(node: Node, hostName: string | undefined, expectedDescription: string): HydrationDiagnosticResult;
+}
+/**
+ * Installs a {@link HydrationDiagnostic} as the active formatter for
+ * hydration mismatch errors. Called by `enableHydration()` when an opt-in
+ * debugger configuration is supplied; not exposed as `@public` because
+ * library consumers should always go through `enableHydration` to install
+ * a debugger.
+ * @internal
+ */
+export declare function installHydrationDiagnostic(diagnostic: HydrationDiagnostic): void;
+/**
+ * Returns the currently active {@link HydrationDiagnostic} — either the
+ * minimal default or one installed by an opt-in debugger.
+ * @internal
+ */
+export declare function getHydrationDiagnostic(): HydrationDiagnostic;
+/**
+ * Reads the host element's tag name from any node inside a hydration view.
+ * Returns `undefined` when the node is not inside a shadow root.
+ * @internal
+ */
+export declare function getHostName(node: Node | null | undefined): string | undefined;

package/dist/dts/hydration/hydration-debugger.d.ts

@@ -0,0 +1,35 @@
+import type { HydrationDiagnostic } from "./diagnostics.js";
+/**
+ * Opt-in hydration debugger configuration. Pass to `enableHydration` to
+ * install the rich "Expected / Received" hydration mismatch formatter:
+ *
+ * ```ts
+ * import { enableHydration, hydrationDebugger } from "@microsoft/fast-element/hydration.js";
+ *
+ * enableHydration({ debugger: hydrationDebugger() });
+ * ```
+ *
+ * @public
+ */
+export interface HydrationDebugger {
+    /**
+     * The {@link HydrationDiagnostic} the debugger installs when consumed
+     * by `enableHydration`.
+     */
+    readonly diagnostic: HydrationDiagnostic;
+}
+/**
+ * Returns a {@link HydrationDebugger} that, when supplied to
+ * `enableHydration({ debugger })`, installs the rich hydration mismatch
+ * formatter: a single-line "Expected … / Received …" message plus an HTML
+ * snippet of the SSR DOM and structured `expected`/`received` fields on
+ * the thrown error (both `HydrationBindingError` and
+ * `HydrationTargetElementError`).
+ *
+ * Without the debugger, hydration errors emit only a minimal one-line
+ * message pointing at this function — keeping the runtime hydration cost
+ * small for production bundles that do not need rich diagnostics.
+ *
+ * @public
+ */
+export declare function hydrationDebugger(): HydrationDebugger;

package/dist/dts/hydration/messages.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Centralized hydration mismatch message strings used by both the default
+ * minimal `HydrationDiagnostic` and the opt-in `hydrationDebugger` rich
+ * formatter, and by the structural-error throw sites in
+ * `target-builder.ts`.
+ *
+ * Static text is exported as a plain `const`; interpolated text is exported
+ * as a small builder function. Plain `export const` declarations tree-shake
+ * better than frozen-object property bags, so unused strings drop out of
+ * bundles cleanly.
+ */
+/**
+ * Fallback host tag name used when a hydration mismatch is detected on a
+ * node that is not inside a shadow root.
+ */
+export declare const unknownHostName = "unknown";
+export declare const aspectLabelAttribute = "attribute";
+export declare const aspectLabelBooleanAttribute = "boolean attribute";
+export declare const aspectLabelProperty = "property";
+export declare const aspectLabelContent = "content";
+export declare const aspectLabelTokenList = "token list";
+export declare const aspectLabelEvent = "event";
+/** Fallback used when the aspectType is missing or unknown. */
+export declare const aspectLabelUnknown = "binding";
+/**
+ * Combines an aspect label with the original source aspect identifier from
+ * markup (e.g. `"property className"`). Returns the bare label when no
+ * source aspect was captured.
+ */
+export declare function formatAspect(label: string, sourceAspect: string | undefined): string;
+/**
+ * Formats the "Expected" half of the rich hydration mismatch message, e.g.
+ * `"<span> with content binding"` or `"content binding"` when no tag is
+ * associated with the binding factory.
+ */
+export declare function formatExpectedTarget(tagName: string | null, aspect: string): string;
+/**
+ * Default minimal hydration mismatch message used when the
+ * `hydrationDebugger` opt-in is not installed. The optional `detail` string
+ * carries the structural expectation surfaced by `target-builder.ts`.
+ */
+export declare function formatDefaultMismatchMessage(hostName: string, detail: string | undefined): string;
+/**
+ * Rich `Expected … / Received …` hydration mismatch message format produced
+ * by the `hydrationDebugger` formatter.
+ */
+export declare function formatRichMismatchMessage(hostName: string, expectedText: string, receivedHtml: string): string;
+export declare const expectedContentAfterStartMarker = "content following `<!--fe:b-->` content binding marker";
+export declare const expectedContentEndMarker = "matching `<!--fe:/b-->` content binding close marker";
+export declare const expectedElementBoundaryEndMarker = "matching `<!--fe:/e-->` element boundary close marker";
+/**
+ * Builds the "no more attribute bindings" structural expectation message
+ * thrown when an element's `data-fe` count claims more attribute bindings
+ * than the compiled template defines.
+ */
+export declare function formatNoMoreAttributeBindings(factoryCount: number): string;
+/**
+ * Builds the "no more content bindings" structural expectation message
+ * thrown when the SSR DOM contains more content binding markers than the
+ * compiled template defines.
+ */
+export declare function formatNoMoreContentBindings(factoryCount: number): string;

package/dist/dts/hydration/runtime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Installs the hydration runtime on `ViewTemplate.prototype`,
+ * making all templates hydratable. Call this before any hydration
+ * occurs. Safe to call multiple times — subsequent calls are no-ops.
+ * @internal
+ */
+export declare function ensureHydrationRuntime(): void;

package/dist/dts/hydration/target-builder.d.ts

@@ -1,4 +1,5 @@
 import type { CompiledViewBehaviorFactory, ViewBehaviorFactory, ViewBehaviorTargets } from "../templating/html-directive.js";
+import { type HydrationMismatchActual, type HydrationMismatchExpectation } from "./diagnostics.js";
 export declare class HydrationTargetElementError extends Error {
     /**
      * The Compiled View Behavior Factories that belong to the view.
@@ -7,7 +8,19 @@ export declare class HydrationTargetElementError extends Error {
     /**
      * The node to target factory.
      */
-    readonly node: Element;
+    readonly node: Node;
+    /**
+     * Structured description of the binding the hydration walk was
+     * attempting to apply when the mismatch was detected. Free-form
+     * string for structural errors that do not correspond to a single
+     * binding factory.
+     */
+    readonly expected?: (HydrationMismatchExpectation | string) | undefined;
+    /**
+     * Structured description of the server-rendered DOM that was
+     * encountered at the mismatch point.
+     */
+    readonly received?: HydrationMismatchActual | undefined;
     /**
      * String representation of the HTML in the template that
      * threw the target element error.
@@ -25,10 +38,23 @@ export declare class HydrationTargetElementError extends Error {
     /**
      * The node to target factory.
      */
-    node: Element);
+    node: Node, 
+    /**
+     * Structured description of the binding the hydration walk was
+     * attempting to apply when the mismatch was detected. Free-form
+     * string for structural errors that do not correspond to a single
+     * binding factory.
+     */
+    expected?: (HydrationMismatchExpectation | string) | undefined, 
+    /**
+     * Structured description of the server-rendered DOM that was
+     * encountered at the mismatch point.
+     */
+    received?: HydrationMismatchActual | undefined);
 }
 /**
  * Represents the DOM boundaries controlled by a view
+ * @public
  */
 export interface ViewBoundaries {
     first: Node;
@@ -37,6 +63,7 @@ export interface ViewBoundaries {
 /**
  * Stores relationships between a {@link ViewBehaviorFactory} and
  * the {@link ViewBoundaries} the factory created.
+ * @public
  */
 export interface ViewBehaviorBoundaries {
     [factoryId: string]: ViewBoundaries;
@@ -52,20 +79,21 @@ export declare function createRangeForNodes(first: Node, last: Node): Range;
 /**
  * Maps compiled ViewBehaviorFactory IDs to their corresponding DOM nodes in the
  * server-rendered shadow root. Uses a TreeWalker to scan the existing DOM between
- * firstNode and lastNode, parsing hydration markers to build the targets map.
+ * firstNode and lastNode, processing data-free sequential hydration markers.
+ *
+ * A sequential factory pointer advances through the factories array in DFS order.
+ * Since the template compiler and hydration walker both traverse the DOM in
+ * identical depth-first order, no embedded indices are needed in markers.
  *
- * For element nodes: parses `data-fe-b` (or variant) attributes to identify which
- * factories target each element, then removes the marker attribute.
+ * For element nodes: parses `data-fe="N"` to determine the count of attribute
+ * binding factories, then consumes N factories sequentially.
  *
- * For comment nodes: parses content binding markers (`fe-b$$start/end$$`) to find
- * the DOM range controlled by each content binding. Single text nodes become the
- * direct target; multi-node ranges are stored in boundaries for structural directives.
- * Element boundary markers (`fe-eb$$start/end$$`) cause the walker to skip over
- * nested custom elements that handle their own hydration.
+ * For comment nodes: `fe:b` markers consume the next factory for content bindings,
+ * using balanced depth counting for nested marker pairing. `fe:e` markers cause
+ * the walker to skip nested custom element subtrees.
  *
  * Host bindings (targetNodeId='h') appear at the start of the factories array but
- * have no SSR markers — getHydrationIndexOffset() computes how many to skip so that
- * marker indices align with the correct non-host factories.
+ * have no SSR markers — getHydrationIndexOffset() computes the initial pointer value.
  *
  * @param firstNode - The first node of the view.
  * @param lastNode -  The last node of the view.

package/dist/dts/hydration.d.ts

@@ -0,0 +1,18 @@
+export type { HydrationOptions } from "./components/enable-hydration.js";
+export { deferHydrationAttribute, enableHydration, StopHydration, } from "./components/enable-hydration.js";
+export { isHydratable } from "./components/hydration.js";
+export { HydrationTracker } from "./components/hydration-tracker.js";
+export type { DOMAspect, DOMSink, } from "./dom.js";
+export { type DOMAspectGuards, type DOMElementGuards, type DOMGuards, DOMPolicy, type DOMPolicyOptions, type DOMSinkGuards, } from "./dom-policy.js";
+export type { HydrationDiagnostic, HydrationDiagnosticResult, HydrationMismatchActual, HydrationMismatchExpectation, } from "./hydration/diagnostics.js";
+export type { HydrationDebugger } from "./hydration/hydration-debugger.js";
+export { hydrationDebugger } from "./hydration/hydration-debugger.js";
+export type { ViewBehaviorBoundaries, ViewBoundaries, } from "./hydration/target-builder.js";
+export type { Disposable, TrustedTypesPolicy } from "./interfaces.js";
+export type { ExecutionContext, ExpressionController, SourceLifetime, } from "./observation/observable.js";
+export type { ContentTemplate, ContentView, HydratableContentTemplate, } from "./templating/html-binding-directive.js";
+export type { ViewBehavior, ViewBehaviorFactory, ViewBehaviorTargets, ViewController, } from "./templating/html-directive.js";
+export type { HydratableView, HydratableViewController, ViewNodes, } from "./templating/hydration-view.js";
+export { HydrationBindingError, HydrationStage, } from "./templating/hydration-view.js";
+export type { CaptureType, ElementViewTemplate, HydratableElementViewTemplate, HydratableSyntheticViewTemplate, SyntheticViewTemplate, } from "./templating/template.js";
+export type { DefaultExecutionContext, ElementView, SyntheticView, View, } from "./templating/view.js";

package/dist/dts/index.d.ts

@@ -1,48 +1,48 @@
-export type { Callable, Class, Constructable, Disposable, FASTGlobal, TrustedTypesPolicy, } from "./interfaces.js";
-export { emptyArray, FAST } from "./platform.js";
-export { DOM, DOMAspect, type DOMPolicy, type DOMSink } from "./dom.js";
-export { ArrayObserver, lengthOf, Sort, sortedCount, Splice, SpliceStrategy, SpliceStrategySupport, type LengthObserver, type SortObserver, } from "./observation/arrays.js";
-export { PropertyChangeNotifier, SubscriberSet, type Notifier, type Subscriber, } from "./observation/notifier.js";
-export { ExecutionContext, Observable, observable, SourceLifetime, volatile, type Accessor, type Expression, type ExpressionController, type ExpressionNotifier, type ExpressionObserver, type ObservationRecord, } from "./observation/observable.js";
-export { Updates, type UpdateQueue } from "./observation/update-queue.js";
+/**
+ * Core APIs for building standards-based Web Components with FAST Element.
+ * @packageDocumentation
+ */
+export { AttributeConfiguration, AttributeDefinition, type AttributeMode, attr, booleanConverter, type DecoratorAttributeConfiguration, nullableBooleanConverter, nullableNumberConverter, type ValueConverter, } from "./attr.js";
 export { Binding, type BindingDirective } from "./binding/binding.js";
 export { normalizeBinding } from "./binding/normalize.js";
 export { oneTime } from "./binding/one-time.js";
 export { listener, oneWay } from "./binding/one-way.js";
-export { CSSBindingDirective } from "./styles/css-binding-directive.js";
-export { cssDirective, CSSDirective, type AddBehavior, type CSSDirectiveDefinition, } from "./styles/css-directive.js";
-export { css, type CSSTemplateTag, type CSSValue } from "./styles/css.js";
-export { ElementStyles, type ComposableStyles, type ConstructibleStyleStrategy, } from "./styles/element-styles.js";
-export { type HostBehavior } from "./styles/host.js";
-export type { HostController } from "./styles/host.js";
+export { Signal, signal } from "./binding/signal.js";
+export { type TwoWayBindingOptions, TwoWaySettings, twoWay, } from "./binding/two-way.js";
+export type { ElementControllerStrategy } from "./components/element-controller.js";
+export { ElementController, Stages, } from "./components/element-controller.js";
+export type { FASTElementExtension, FASTElementTemplateResolver, PartialFASTElementDefinition, ShadowRootOptions, TypeDefinition, TypeRegistry, } from "./components/fast-definitions.js";
+export { FASTElementDefinition, fastElementRegistry, type TemplateLifecycleCallbacks, } from "./components/fast-definitions.js";
+export { customElement, FASTElement, type FASTElementConstructor, } from "./components/fast-element.js";
+export { enableDebug } from "./debug.js";
+export { type ChildListDirectiveOptions, ChildrenDirective, type ChildrenDirectiveOptions, children, type SubtreeDirectiveOptions, } from "./directives/children.js";
+export { type ElementsFilter, elements, type NodeBehaviorOptions, NodeObservationDirective, } from "./directives/node-observation.js";
+export { RefDirective, ref } from "./directives/ref.js";
+export { RepeatBehavior, RepeatDirective, type RepeatOptions, repeat, } from "./directives/repeat.js";
+export { SlottedDirective, type SlottedDirectiveOptions, slotted, } from "./directives/slotted.js";
+export { when } from "./directives/when.js";
+export { DOM, DOMAspect, type DOMSink } from "./dom.js";
+export { type DOMAspectGuards, type DOMElementGuards, type DOMGuards, DOMPolicy, type DOMPolicyOptions, type DOMSinkGuards, } from "./dom-policy.js";
+export type { Callable, Class, Constructable, Disposable, TrustedTypesPolicy, } from "./interfaces.js";
+export { ArrayObserver, type LengthObserver, lengthOf, Sort, type SortObserver, Splice, SpliceStrategy, SpliceStrategySupport, sortedCount, } from "./observation/arrays.js";
+export { type Notifier, PropertyChangeNotifier, type Subscriber, SubscriberSet, } from "./observation/notifier.js";
+export type { Accessor, Expression, ExpressionController, ExpressionNotifier, ExpressionObserver, ObservationRecord, } from "./observation/observable.js";
+export { ExecutionContext, Observable, observable, SourceLifetime, volatile, } from "./observation/observable.js";
+export { type UpdateQueue, Updates } from "./observation/update-queue.js";
+export { emptyArray, FAST } from "./platform.js";
+export { type AccessCachedPath, type CachedPath, type CachedPathCommon, type CachedPathMap, type ChildrenMap, type DefaultCachedPath, type EventCachedPath, type JSONSchema, type JSONSchemaCommon, type JSONSchemaDefinition, type RegisterPathConfig, type RepeatCachedPath, Schema, schemaRegistry, } from "./schema.js";
+export * from "./state/exports.js";
+export { type CSSTemplateTag, type CSSValue, css } from "./styles/css.js";
+export { CSSDirective, type CSSDirectiveDefinition, cssDirective, } from "./styles/css-directive.js";
+export type { ComposableStyles, ConstructibleStyleStrategy, } from "./styles/element-styles.js";
+export { ElementStyles } from "./styles/element-styles.js";
+export type { HostBehavior, HostController } from "./styles/host.js";
 export type { StyleStrategy, StyleTarget } from "./styles/style-strategy.js";
-export { children, ChildrenDirective } from "./templating/children.js";
-export type { ChildListDirectiveOptions, ChildrenDirectiveOptions, SubtreeDirectiveOptions, } from "./templating/children.js";
-export { Compiler } from "./templating/compiler.js";
-export type { CompilationStrategy } from "./templating/compiler.js";
-export { HTMLBindingDirective } from "./templating/html-binding-directive.js";
-export type { ContentTemplate, ContentView, } from "./templating/html-binding-directive.js";
-export { htmlDirective, HTMLDirective, StatelessAttachedAttributeDirective, } from "./templating/html-directive.js";
-export type { AddViewBehaviorFactory, Aspected, CompiledViewBehaviorFactory, HTMLDirectiveDefinition, PartialHTMLDirectiveDefinition, ViewBehavior, ViewBehaviorFactory, ViewBehaviorTargets, ViewController, } from "./templating/html-directive.js";
+export { type CompilationStrategy, Compiler } from "./templating/compiler.js";
+export { type ContentTemplate, type ContentView, HTMLBindingDirective, } from "./templating/html-binding-directive.js";
+export { type AddViewBehaviorFactory, type Aspected, type CompiledViewBehaviorFactory, HTMLDirective, type HTMLDirectiveDefinition, htmlDirective, type PartialHTMLDirectiveDefinition, StatelessAttachedAttributeDirective, type ViewBehavior, type ViewBehaviorFactory, type ViewBehaviorTargets, type ViewController, } from "./templating/html-directive.js";
 export { Markup, Parser } from "./templating/markup.js";
-export { elements, NodeObservationDirective } from "./templating/node-observation.js";
-export type { ElementsFilter, NodeBehaviorOptions, } from "./templating/node-observation.js";
-export { ref, RefDirective } from "./templating/ref.js";
-export { render, RenderBehavior, RenderDirective } from "./templating/render.js";
-export { repeat, RepeatBehavior, RepeatDirective } from "./templating/repeat.js";
-export type { RepeatOptions } from "./templating/repeat.js";
-export { slotted, SlottedDirective } from "./templating/slotted.js";
-export type { SlottedDirectiveOptions } from "./templating/slotted.js";
-export { html, InlineTemplateDirective, ViewTemplate } from "./templating/template.js";
-export type { CaptureType, ElementViewTemplate, HTMLTemplateCompilationResult, HTMLTemplateTag, SyntheticViewTemplate, TemplateValue, } from "./templating/template.js";
-export { HTMLView, HydrationBindingError } from "./templating/view.js";
-export type { ElementView, HydratableView, SyntheticView, View, } from "./templating/view.js";
-export { when } from "./templating/when.js";
-export { attr, AttributeConfiguration, AttributeDefinition, booleanConverter, nullableBooleanConverter, nullableNumberConverter, } from "./components/attributes.js";
-export type { AttributeMode, DecoratorAttributeConfiguration, ValueConverter, } from "./components/attributes.js";
-export { ElementController, HydratableElementController, needsHydrationAttribute, Stages, type HydrationControllerCallbacks, } from "./components/element-controller.js";
-export type { ElementControllerStrategy } from "./components/element-controller.js";
-export { FASTElementDefinition, fastElementRegistry, TemplateOptions, type TemplateLifecycleCallbacks, } from "./components/fast-definitions.js";
-export type { PartialFASTElementDefinition, ShadowRootOptions, TypeRegistry, } from "./components/fast-definitions.js";
-export { customElement, FASTElement } from "./components/fast-element.js";
-export { deferHydrationAttribute, isHydratable } from "./components/hydration.js";
+export { RenderBehavior, RenderDirective, render } from "./templating/render.js";
+export { type CaptureType, type ElementViewTemplate, type HTMLTemplateCompilationResult, type HTMLTemplateTag, html, InlineTemplateDirective, type SyntheticViewTemplate, type TemplateValue, ViewTemplate, } from "./templating/template.js";
+export { DefaultExecutionContext, type ElementView, HTMLView, type SyntheticView, type View, } from "./templating/view.js";
+export * from "./utilities.js";

package/dist/dts/index.debug.d.ts

@@ -1,2 +1 @@
-import "./debug.js";
 export * from "./index.js";

package/dist/dts/index.rollup.debug.d.ts

@@ -1,2 +1 @@
-import "./debug.js";
 export * from "./index.js";

package/dist/dts/interfaces.d.ts

@@ -56,55 +56,6 @@ export type Mutable<T> = {
  * @public
  */
 export type ParameterDecorator = (target: Object, propertyKey: string | undefined, parameterIndex: number) => void;
-/**
- * The FAST global.
- * @public
- */
-export interface FASTGlobal {
-    /**
-     * The list of loaded versions.
-     */
-    readonly versions: string[];
-    /**
-     * Gets a kernel value.
-     * @param id - The id to get the value for.
-     * @param initialize - Creates the initial value for the id if not already existing.
-     */
-    getById<T>(id: string | number): T | null;
-    getById<T>(id: string | number, initialize: () => T): T;
-    /**
-     * Sends a warning to the developer.
-     * @param code - The warning code to send.
-     * @param values - Values relevant for the warning message.
-     */
-    warn(code: number, values?: Record<string, any>): void;
-    /**
-     * Creates an error.
-     * @param code - The error code to send.
-     * @param values - Values relevant for the error message.
-     */
-    error(code: number, values?: Record<string, any>): Error;
-    /**
-     * Adds debug messages for errors and warnings.
-     * @param messages - The message dictionary to add.
-     * @remarks
-     * Message can include placeholders like $\{name\} which can be
-     * replaced by values passed at runtime.
-     */
-    addMessages(messages: Record<number, string>): void;
-}
-/**
- * Core services that can be shared across FAST instances.
- * @internal
- */
-type KernelServiceId = {
-    readonly updateQueue: string | number;
-    readonly observable: string | number;
-    readonly contextEvent: string | number;
-    readonly elementRegistry: string | number;
-};
-declare let KernelServiceId: KernelServiceId;
-export { KernelServiceId };
 /**
  * Warning and error messages.
  * @internal
@@ -120,6 +71,8 @@ export declare const enum Message {
     onlySetTemplatePolicyOnce = 1207,
     cannotSetTemplatePolicyAfterCompilation = 1208,
     blockedByDOMPolicy = 1209,
+    invalidHydrationAttributeMarker = 1210,
+    duplicateRenderInstruction = 1211,
     missingElementDefinition = 1401,
     noRegistrationForContext = 1501,
     noFactoryForResolver = 1502,

package/dist/dts/observable.d.ts

@@ -1,7 +1,4 @@
-/**
- * Observable exports for easy access to the Observable API
- */
-export { ExecutionContext, Observable, observable, SourceLifetime, volatile, } from "./observation/observable.js";
-export type { Accessor, Expression, ExpressionController, ExpressionNotifier, ExpressionObserver, ObservationRecord, } from "./observation/observable.js";
-export { PropertyChangeNotifier, SubscriberSet } from "./observation/notifier.js";
 export type { Notifier, Subscriber } from "./observation/notifier.js";
+export { PropertyChangeNotifier, SubscriberSet } from "./observation/notifier.js";
+export type { Accessor, Expression, ExpressionController, ExpressionNotifier, ExpressionObserver, ObservationRecord, } from "./observation/observable.js";
+export { ExecutionContext, Observable, observable, SourceLifetime, } from "./observation/observable.js";

package/dist/dts/observation/arrays.d.ts

@@ -226,7 +226,7 @@ export declare const ArrayObserver: Readonly<{
      * Enables the array observation mechanism.
      * @remarks
      * Array observation is enabled automatically when using the
-     * {@link RepeatDirective}, so calling this API manually is
+     * `RepeatDirective`, so calling this API manually is
      * not typically necessary.
      */
     readonly enable: () => void;

package/dist/dts/observation/observable.d.ts

@@ -180,13 +180,13 @@ export declare const Observable: Readonly<{
      * @param initialSubscriber - An initial subscriber to changes in the binding value.
      * @param isVolatileBinding - Indicates whether the binding's dependency list must be re-evaluated on every value evaluation.
      */
-    binding<TSource = any, TReturn = any>(expression: Expression<TSource, TReturn, any>, initialSubscriber?: Subscriber, isVolatileBinding?: boolean): ExpressionNotifier<TSource, TReturn, any>;
+    binding<TSource = any, TReturn = any>(expression: Expression<TSource, TReturn>, initialSubscriber?: Subscriber, isVolatileBinding?: boolean): ExpressionNotifier<TSource, TReturn>;
     /**
      * Determines whether a binding expression is volatile and needs to have its dependency list re-evaluated
      * on every evaluation of the value.
      * @param expression - The binding to inspect.
      */
-    isVolatileBinding<TSource_1 = any, TReturn_1 = any>(expression: Expression<TSource_1, TReturn_1, any>): boolean;
+    isVolatileBinding<TSource = any, TReturn = any>(expression: Expression<TSource, TReturn>): boolean;
 }>;
 /**
  * Decorator: Defines an observable property on the target.
@@ -270,7 +270,7 @@ export declare const ExecutionContext: Readonly<{
     /**
      * A default execution context.
      */
-    default: ExecutionContext<any>;
+    default: ExecutionContext;
     /**
      * Gets the current event.
      * @returns An event object.

package/dist/dts/observation/update-queue.d.ts

@@ -1,4 +1,4 @@
-import { type Callable } from "../interfaces.js";
+import type { Callable } from "../interfaces.js";
 /**
  * A work queue used to synchronize writes to the DOM.
  * @public

package/dist/dts/platform.d.ts

@@ -1,10 +1,31 @@
-import { type FASTGlobal } from "./interfaces.js";
-import "./polyfills.js";
 /**
- * The FAST global.
+ * The FAST messaging API for warnings and errors.
  * @public
  */
-export declare const FAST: FASTGlobal;
+export declare const FAST: {
+    /**
+     * Sends a warning to the developer.
+     * @param code - The warning code to send.
+     * @param values - Values relevant for the warning message.
+     */
+    warn(_code: number, _values?: Record<string, any>): void;
+    /**
+     * Creates an error from a code.
+     * @param code - The error code.
+     * @param values - Values relevant for the error message.
+     */
+    error(code: number, _values?: Record<string, any>): Error;
+    /**
+     * Adds debug messages for errors and warnings.
+     * @param messages - The message dictionary to add.
+     */
+    addMessages(messages: Record<number, string>): void;
+};
+/**
+ * Gets the shared debug message lookup.
+ * @internal
+ */
+export declare function getDebugMessageLookup(): Record<number, string>;
 /**
  * A readonly, empty array.
  * @remarks
@@ -14,19 +35,35 @@ export declare const FAST: FASTGlobal;
  */
 export declare const emptyArray: readonly never[];
 /**
- * Do not change. Part of shared kernel contract.
- * @internal
+ * A type that can be registered with a `TypeRegistry`.
+ * @public
  */
 export interface TypeDefinition {
+    /**
+     * The registered type constructor.
+     */
     type: Function;
 }
 /**
- * Do not change. Part of shared kernel contract.
- * @internal
+ * A registry that stores definitions by type.
+ * @public
  */
 export interface TypeRegistry<TDefinition extends TypeDefinition> {
+    /**
+     * Registers a type definition.
+     * @param definition - The type definition to register.
+     * @returns `true` when the definition was registered, otherwise `false`.
+     */
     register(definition: TDefinition): boolean;
+    /**
+     * Gets a definition by type.
+     * @param key - The type to retrieve the definition for.
+     */
     getByType(key: Function): TDefinition | undefined;
+    /**
+     * Gets a definition by instance.
+     * @param object - The instance to retrieve the definition for.
+     */
     getForInstance(object: any): TDefinition | undefined;
 }
 /**

package/dist/dts/registry.d.ts

@@ -0,0 +1 @@
+export { FASTElementDefinition, fastElementRegistry, type TypeDefinition, type TypeRegistry, } from "./components/fast-definitions.js";

package/dist/dts/render.d.ts

@@ -0,0 +1,7 @@
+export type { Binding, BindingDirective } from "./binding/binding.js";
+export type { Subscriber } from "./observation/notifier.js";
+export type { Expression, ExpressionObserver } from "./observation/observable.js";
+export type { ContentTemplate } from "./templating/html-binding-directive.js";
+export type { AddViewBehaviorFactory, HTMLDirective, ViewBehavior, ViewBehaviorFactory, ViewController, } from "./templating/html-directive.js";
+export { RenderBehavior, RenderDirective, render } from "./templating/render.js";
+export type { CaptureType } from "./templating/template.js";

package/dist/dts/schema.d.ts

@@ -0,0 +1 @@
+export { type AccessCachedPath, type CachedPath, type CachedPathCommon, type CachedPathMap, type ChildrenMap, type DefaultCachedPath, type EventCachedPath, type JSONSchema, type JSONSchemaCommon, type JSONSchemaDefinition, type RegisterPathConfig, type RepeatCachedPath, Schema, schemaRegistry, } from "./components/schema.js";

package/dist/dts/state/exports.d.ts

@@ -1,3 +1,3 @@
 export { reactive } from "./reactive.js";
-export { watch } from "./watch.js";
 export * from "./state.js";
+export { watch } from "./watch.js";