@craft-ts/component 0.7.0-beta.13 → 0.7.0-beta.16

package/src/lib/server-render.d.ts

@@ -1,5 +1,5 @@
-import { type CraftInjector, type CraftTransferSnapshot } from '@craft-ts/core';
-import { type CraftComponent, type PropsOf } from './types';
+import { type CraftInjector, type CraftSecurityPolicyInput, type CraftRuntimeMode, type CraftTransferSnapshot } from '@craft-ts/core';
+import { type CraftComponent, type PropsOf } from './types.js';
 export declare const CRAFT_TRANSFER_SCRIPT_ID = "__CRAFT_TRANSFER__";
 export type RenderCraftOptions = Readonly<{
     config: {
@@ -11,6 +11,13 @@ export type RenderCraftOptions = Readonly<{
     signal?: AbortSignal;
     includeStyles?: boolean;
     includeSnapshotScript?: boolean;
+    mode?: CraftRuntimeMode;
+    securityPolicy?: CraftSecurityPolicyInput;
+    /**
+     * Nonce CSP de la requête. Il est reporté sur les styles rendus, ce qui
+     * permet une politique sans `'unsafe-inline'`.
+     */
+    cspNonce?: string;
 }>;
 export type RenderCraftResult = Readonly<{
     html: string;
@@ -26,9 +33,11 @@ export type RenderToStringOptions<Component extends CraftComponent<any>> = Reado
     url?: string;
     timeoutMs?: number;
     signal?: AbortSignal;
+    mode?: CraftRuntimeMode;
+    securityPolicy?: CraftSecurityPolicyInput;
+    cspNonce?: string;
 }>;
 /** Low-level component convenience API built on the same per-request runtime. */
 export declare function renderToString<Component extends CraftComponent<any>>(component: Component, options?: RenderToStringOptions<Component>): Promise<string>;
 /** Kept type-visible for adapters that need to share the request injector. */
 export type CraftServerInjector = CraftInjector;
-//# sourceMappingURL=server-render.d.ts.map

package/src/lib/server-render.js

@@ -1,28 +1,58 @@
-import { CRAFT_PLATFORM, CRAFT_PRIMITIVE_REGISTRY, CRAFT_SSR_RUNTIME, captureCraftTransferSnapshot, createCraftRenderIdentity, createServerPlatform, serializeCraftTransferSnapshot, } from '@craft-ts/core';
-import { ɵcreateCraftApplicationInjector, ɵrunCraftAppInitializers, } from './bootstrap';
-import { CRAFT_ROOT_COMPONENT } from './craft-host-tokens';
-import { provideCraftRootComponent } from './bridge';
-import { mountInterpretedComponentWithOptions, } from './render/interpreter';
-import { createServerStyleCollector } from './render/server-style-collector';
-import { CraftSsrCoordinator } from './render/ssr-coordinator';
-import { createStringDomAdapter } from './render/string-dom';
-import { CRAFT_COMPONENT } from './types';
+import { CRAFT_PLATFORM, CRAFT_PRIMITIVE_REGISTRY, CRAFT_SECURITY_POLICY, CRAFT_SSR_RUNTIME, CraftCspNonce, captureCraftTransferSnapshot, createCraftSecurityPolicy, createCraftRenderIdentity, createServerPlatform, assertCraftCspNonce, serializeCraftTransferSnapshot, } from '@craft-ts/core';
+import { ɵcreateCraftApplicationInjector, ɵrunCraftAppInitializers, } from './bootstrap.js';
+import { CRAFT_ROOT_COMPONENT } from './craft-host-tokens.js';
+import { provideCraftRootComponent } from './bridge.js';
+import { mountInterpretedComponentWithOptions, } from './render/interpreter.js';
+import { createServerStyleCollector } from './render/server-style-collector.js';
+import { CraftSsrCoordinator } from './render/ssr-coordinator.js';
+import { createStringDomAdapter } from './render/string-dom.js';
+import { CRAFT_COMPONENT } from './types.js';
 export const CRAFT_TRANSFER_SCRIPT_ID = '__CRAFT_TRANSFER__';
 /** Renders one fully isolated Craft application request to deterministic HTML. */
 export async function renderCraft(options) {
+    const requestedPolicy = options.securityPolicy
+        ? createCraftSecurityPolicy(options.securityPolicy)
+        : undefined;
+    const defaultPolicy = requestedPolicy ?? createCraftSecurityPolicy();
+    const hasConfiguredPolicy = options.config.providers.some((provider) => typeof provider === 'object' &&
+        provider !== null &&
+        ('provide' in provider
+            ? provider.provide === CRAFT_SECURITY_POLICY
+            : 'token' in provider && provider.token === CRAFT_SECURITY_POLICY));
+    const controller = new AbortController();
+    const removeExternalAbort = forwardAbort(options.signal, controller);
+    const timeoutMs = options.timeoutMs ?? defaultPolicy.ssr.timeoutMs;
+    const timeout = setTimeout(() => controller.abort(new Error(`Craft SSR timed out after ${timeoutMs}ms.`)), timeoutMs);
     const dom = createStringDomAdapter();
     const platform = createServerPlatform({
         url: options.url,
         document: dom.document,
-        signal: options.signal,
+        signal: controller.signal,
     });
-    const coordinator = new CraftSsrCoordinator((source, mode) => platform.serverResources?.decide(source, mode));
+    const coordinator = new CraftSsrCoordinator((source, mode) => platform.serverResources?.decide(source, mode), defaultPolicy.ssr.sourceTimeoutMs);
     const injector = ɵcreateCraftApplicationInjector(options.config, [
         { provide: CRAFT_PLATFORM, useValue: platform },
         { provide: CRAFT_SSR_RUNTIME, useValue: coordinator },
-    ]);
+        ...(requestedPolicy || !hasConfiguredPolicy
+            ? [
+                {
+                    provide: CRAFT_SECURITY_POLICY,
+                    useValue: requestedPolicy ?? defaultPolicy,
+                },
+            ]
+            : []),
+        ...(options.cspNonce
+            ? [
+                {
+                    provide: CraftCspNonce,
+                    useValue: assertCraftCspNonce(options.cspNonce),
+                },
+            ]
+            : []),
+    ], options.mode);
     let mounted;
     try {
+        const securityPolicy = injector.get(CRAFT_SECURITY_POLICY, defaultPolicy);
         await Promise.all(ɵrunCraftAppInitializers(injector));
         const root = injector.get(CRAFT_ROOT_COMPONENT);
         if (!root) {
@@ -39,16 +69,21 @@ export async function renderCraft(options) {
             ssr: coordinator,
             serverStyles,
         });
-        await coordinator.untilSettled(options.timeoutMs ?? 5_000, options.signal);
+        await coordinator.untilSettled(timeoutMs, controller.signal);
         const styles = serverStyles.cssText();
-        const snapshot = captureCraftTransferSnapshot(injector.get(CRAFT_PRIMITIVE_REGISTRY));
+        const snapshot = captureCraftTransferSnapshot(injector.get(CRAFT_PRIMITIVE_REGISTRY), { policy: securityPolicy.transfer });
         const rootHtml = dom.serialize(host);
+        const htmlSize = byteLength(rootHtml) + byteLength(styles);
+        if (htmlSize > securityPolicy.ssr.maxHtmlBytes) {
+            throw new Error(`CRAFT_SSR_HTML_TOO_LARGE: generated HTML exceeds ${securityPolicy.ssr.maxHtmlBytes} bytes.`);
+        }
+        const nonce = injector.get(CraftCspNonce, null);
         const styleHtml = options.includeStyles === false || !styles
             ? ''
-            : `<style data-craft-ssr>${escapeStyleText(styles)}</style>`;
+            : `<style data-craft-ssr${nonce ? ` nonce="${escapeAttribute(nonce)}"` : ''}>${escapeStyleText(styles)}</style>`;
         const snapshotHtml = options.includeSnapshotScript === false
             ? ''
-            : `<script id="${CRAFT_TRANSFER_SCRIPT_ID}" type="application/json">${serializeCraftTransferSnapshot(snapshot)}</script>`;
+            : `<script id="${CRAFT_TRANSFER_SCRIPT_ID}" type="application/json">${serializeCraftTransferSnapshot(snapshot, securityPolicy.transfer)}</script>`;
         return {
             html: `${styleHtml}${rootHtml}${snapshotHtml}`,
             rootHtml,
@@ -57,6 +92,9 @@ export async function renderCraft(options) {
         };
     }
     finally {
+        clearTimeout(timeout);
+        removeExternalAbort();
+        coordinator.dispose();
         mounted?.destroy();
         platform.history.dispose();
         injector.destroy?.();
@@ -75,10 +113,31 @@ export async function renderToString(component, options = {}) {
         url: options.url,
         timeoutMs: options.timeoutMs,
         signal: options.signal,
+        mode: options.mode,
+        ...(options.securityPolicy ? { securityPolicy: options.securityPolicy } : {}),
+        ...(options.cspNonce ? { cspNonce: options.cspNonce } : {}),
     });
     return result.html;
 }
 function escapeStyleText(value) {
     return value.replace(/<\/style/gi, '<\\/style');
 }
-//# sourceMappingURL=server-render.js.map
+function escapeAttribute(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function byteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+function forwardAbort(source, target) {
+    if (!source)
+        return () => undefined;
+    const abort = () => target.abort(source.reason);
+    if (source.aborted)
+        abort();
+    else
+        source.addEventListener('abort', abort, { once: true });
+    return () => source.removeEventListener('abort', abort);
+}

package/src/lib/start.d.ts

@@ -1,5 +1,5 @@
-import { type CraftAppRef } from './bootstrap';
-import { type HydrateCraftOptions, type HydratedCraftAppRef } from './hydrate';
+import { type CraftAppRef } from './bootstrap.js';
+import { type HydrateCraftOptions, type HydratedCraftAppRef } from './hydrate.js';
 /** Options shared by a normal browser start and an SSR hydration. */
 export type StartCraftOptions = HydrateCraftOptions;
 export type StartedCraftAppRef = CraftAppRef | HydratedCraftAppRef;
@@ -10,4 +10,3 @@ export type StartedCraftAppRef = CraftAppRef | HydratedCraftAppRef;
  * hydrated; otherwise a fresh client render is mounted.
  */
 export declare function startCraft(options: StartCraftOptions): StartedCraftAppRef;
-//# sourceMappingURL=start.d.ts.map

package/src/lib/start.js

@@ -1,5 +1,5 @@
-import { bootstrapCraft, } from './bootstrap';
-import { hydrateCraft, } from './hydrate';
+import { bootstrapCraft, } from './bootstrap.js';
+import { hydrateCraft, } from './hydrate.js';
 /**
  * Starts a Craft application in the browser.
  *
@@ -14,7 +14,7 @@ export function startCraft(options) {
     const bootstrapOptions = {
         config: options.config,
         host,
+        mode: options.mode,
     };
     return bootstrapCraft(bootstrapOptions);
 }
-//# sourceMappingURL=start.js.map

package/src/lib/template-contract.d.ts

@@ -1,6 +1,6 @@
-import type { CraftComponent, ComponentTemplateOf, ComponentTemplateNameOf, FactoryContext, Output, PropsOf, TemplateMethodUse } from './types';
+import type { CraftComponent, ComponentTemplateOf, ComponentTemplateNameOf, FactoryContext, Output, PropsOf, TemplateMethodUse } from './types.js';
 import type { NamedYieldableValue, Yieldable, YieldableMethod } from '@craft-ts/core';
-import type { ComponentNode, CraftDirectiveNode, CraftNodeChildren, DeferNode, EachNode, IfBlockNode, ElementNodeBase } from './render/vnode';
+import type { ComponentNode, CraftDirectiveNode, CraftNodeChildren, DeferNode, ForNode, IfNode, ElementNodeBase } from './render/vnode.js';
 export type TemplateContractError<Message extends string> = {
     readonly error: Message;
 };
@@ -32,7 +32,7 @@ type InvalidOutputCallbacks<ActualProps, Component extends CraftComponent<any, a
 type ComponentOfNode<Node> = Node extends {
     readonly component: infer Component;
 } ? Component extends CraftComponent<any, any> ? Component : never : never;
-type VisitChildren<Children, Registry extends readonly CraftComponent<any, any>[], Seen extends readonly unknown[]> = Children extends readonly (infer Child)[] ? VisitChildren<Child, Registry, Seen> : Children extends ElementNodeBase<any, any, infer Props, infer Nested> ? InvalidElementCallbacks<Props> | VisitChildren<Nested, Registry, Seen> : Children extends ComponentNode<infer ActualProps, any, any> ? ComponentPropsMatch<ActualProps, ComponentOfNode<Children>> | InvalidOutputCallbacks<ActualProps, ComponentOfNode<Children>> | VisitComponent<ComponentOfNode<Children>, Registry, Seen> : Children extends CraftDirectiveNode<any> ? VisitChildren<Children['node'], Registry, Seen> : Children extends EachNode<infer _Item, infer _Key, infer _Dependencies> ? VisitChildren<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Registry, Seen> : Children extends DeferNode<infer Loaded, infer _Dependencies> ? VisitChildren<Loaded extends CraftComponent<any, any> ? ComponentNode<PropsOf<Loaded>, {}, Loaded> : ReturnType<Children['resolve']>, Registry, Seen> : true;
+type VisitChildren<Children, Registry extends readonly CraftComponent<any, any>[], Seen extends readonly unknown[]> = Children extends readonly (infer Child)[] ? VisitChildren<Child, Registry, Seen> : Children extends ElementNodeBase<any, any, infer Props, infer Nested> ? InvalidElementCallbacks<Props> | VisitChildren<Nested, Registry, Seen> : Children extends ComponentNode<infer ActualProps, any, any> ? ComponentPropsMatch<ActualProps, ComponentOfNode<Children>> | InvalidOutputCallbacks<ActualProps, ComponentOfNode<Children>> | VisitComponent<ComponentOfNode<Children>, Registry, Seen> : Children extends CraftDirectiveNode<any> ? VisitChildren<Children['node'], Registry, Seen> : Children extends ForNode<infer _Item, infer _Key, infer _Dependencies> ? VisitChildren<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Registry, Seen> : Children extends DeferNode<infer Loaded, infer _Dependencies> ? VisitChildren<Loaded extends CraftComponent<any, any> ? ComponentNode<PropsOf<Loaded>, {}, Loaded> : ReturnType<Children['resolve']>, Registry, Seen> : true;
 type VisitComponent<Component extends CraftComponent<any, any>, Registry extends readonly CraftComponent<any, any>[], Seen extends readonly unknown[]> = IsAny<Component> extends true ? TemplateContractError<'Dynamic component references cannot be resolved.'> : IsUnion<Component> extends true ? TemplateContractError<'Union component references cannot be resolved by the template contract; register a concrete component.'> : Registered<Component, Registry> extends true ? Component extends Seen[number] ? true : VisitChildren<ReturnType<ComponentTemplateOf<Component>>, Registry, [
     ...Seen,
     Component
@@ -51,21 +51,21 @@ export type TemplateContractAssertions<Component extends CraftComponent<any, any
  */
 export type SetupTestComponentTemplate<Component extends CraftComponent<any, any>, Registry extends readonly CraftComponent<any, any>[] = []> = ContractResult<RootVisit<Component, Registry>> extends infer Result ? Result extends TemplateContractError<any> ? Result : TemplateContractAssertions<Component, Registry> : never;
 type ElementMatching<Children, Tag extends string, Props> = Children extends ElementNodeBase<any, infer ActualTag, infer ActualProps> ? ActualTag extends Tag ? [Props] extends [never] ? true : ActualProps extends Props ? Props extends ActualProps ? true : false : false : false : never;
-type FindElement<Children, Tag extends string, Props = never> = Children extends readonly (infer Child)[] ? FindElement<Child, Tag, Props> : Children extends ElementNodeBase<any, infer ActualTag, any> ? ActualTag extends Tag ? ElementMatching<Children, Tag, Props> : FindElement<Children['children'], Tag, Props> : Children extends CraftDirectiveNode<any> ? FindElement<Children['node'], Tag, Props> : Children extends ComponentNode<any, any, infer Component> ? FindElement<ReturnType<ComponentTemplateOf<Component>>, Tag, Props> : Children extends EachNode<any, any> ? FindElement<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Tag, Props> : Children extends IfBlockNode<infer ConditionName, any, infer True, infer False> ? FindElement<True | False, Tag, Props> : Children extends DeferNode<infer Loaded> ? FindElement<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Props> : false;
+type FindElement<Children, Tag extends string, Props = never> = Children extends readonly (infer Child)[] ? FindElement<Child, Tag, Props> : Children extends ElementNodeBase<any, infer ActualTag, any> ? ActualTag extends Tag ? ElementMatching<Children, Tag, Props> : FindElement<Children['children'], Tag, Props> : Children extends CraftDirectiveNode<any> ? FindElement<Children['node'], Tag, Props> : Children extends ComponentNode<any, any, infer Component> ? FindElement<ReturnType<ComponentTemplateOf<Component>>, Tag, Props> : Children extends ForNode<any, any> ? FindElement<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Tag, Props> : Children extends IfNode<infer ConditionName, any, infer True, infer False> ? FindElement<True | False, Tag, Props> : Children extends DeferNode<infer Loaded> ? FindElement<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Props> : false;
 export type TemplateHasElement<Children extends CraftNodeChildren, Tag extends string> = FindElement<Children, Tag>;
 /** Checks the exact tag and props of a matching element. */
 export type TemplateHasElementWithProps<Children extends CraftNodeChildren, Tag extends string, Props extends object> = FindElement<Children, Tag, Props>;
-type VisitProperty<Children, Tag extends string, Property extends string, Value> = Children extends readonly (infer Child)[] ? VisitProperty<Child, Tag, Property, Value> : Children extends ElementNodeBase<any, infer ActualTag, infer Props, infer Nested> ? ActualTag extends Tag ? Property extends keyof Props ? NonNullable<Props[Property]> extends Value ? true : false : false : VisitProperty<Nested, Tag, Property, Value> : Children extends CraftDirectiveNode<any> ? VisitProperty<Children['node'], Tag, Property, Value> : Children extends ComponentNode<any, any, infer Component> ? VisitProperty<ReturnType<ComponentTemplateOf<Component>>, Tag, Property, Value> : Children extends EachNode<any, any> ? VisitProperty<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Tag, Property, Value> : Children extends DeferNode<infer Loaded> ? VisitProperty<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Property, Value> : false;
+type VisitProperty<Children, Tag extends string, Property extends string, Value> = Children extends readonly (infer Child)[] ? VisitProperty<Child, Tag, Property, Value> : Children extends ElementNodeBase<any, infer ActualTag, infer Props, infer Nested> ? ActualTag extends Tag ? Property extends keyof Props ? NonNullable<Props[Property]> extends Value ? true : false : false : VisitProperty<Nested, Tag, Property, Value> : Children extends CraftDirectiveNode<any> ? VisitProperty<Children['node'], Tag, Property, Value> : Children extends ComponentNode<any, any, infer Component> ? VisitProperty<ReturnType<ComponentTemplateOf<Component>>, Tag, Property, Value> : Children extends ForNode<any, any> ? VisitProperty<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Tag, Property, Value> : Children extends DeferNode<infer Loaded> ? VisitProperty<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Property, Value> : false;
 /** Checks the type of a static or dynamic property on an element. */
 export type TemplateHasProperty<Children extends CraftNodeChildren, Tag extends string, Property extends string, Value> = VisitProperty<Children, Tag, Property, Value>;
 /** Checks that an element property is driven by a no-argument generator. */
 export type TemplateHasYieldableProperty<Children extends CraftNodeChildren, Tag extends string, Property extends string, Result> = TemplateHasProperty<Children, Tag, Property, Yieldable<[], Result, unknown>>;
-type VisitContextUse<Children, Tag extends string, Property extends string, ContextMethod extends string> = Children extends readonly (infer Child)[] ? VisitContextUse<Child, Tag, Property, ContextMethod> : Children extends ElementNodeBase<any, infer ActualTag, infer Props, infer Nested> ? ActualTag extends Tag ? Property extends keyof Props ? NonNullable<Props[Property]> extends (...args: any[]) => Generator<infer Yielded, infer Returned, any> ? TemplateMethodUse<ContextMethod> extends Yielded | Returned ? true : Extract<Yielded | Returned, TemplateMethodUse<ContextMethod>> extends never ? false : true : false : false : VisitContextUse<Nested, Tag, Property, ContextMethod> : Children extends CraftDirectiveNode<any> ? VisitContextUse<Children['node'], Tag, Property, ContextMethod> : Children extends ComponentNode<any, any, infer Component> ? VisitContextUse<ReturnType<ComponentTemplateOf<Component>>, Tag, Property, ContextMethod> : Children extends EachNode<any, any> ? VisitContextUse<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Tag, Property, ContextMethod> : Children extends DeferNode<infer Loaded> ? VisitContextUse<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Property, ContextMethod> : false;
+type VisitContextUse<Children, Tag extends string, Property extends string, ContextMethod extends string> = Children extends readonly (infer Child)[] ? VisitContextUse<Child, Tag, Property, ContextMethod> : Children extends ElementNodeBase<any, infer ActualTag, infer Props, infer Nested> ? ActualTag extends Tag ? Property extends keyof Props ? NonNullable<Props[Property]> extends (...args: any[]) => Generator<infer Yielded, infer Returned, any> ? TemplateMethodUse<ContextMethod> extends Yielded | Returned ? true : Extract<Yielded | Returned, TemplateMethodUse<ContextMethod>> extends never ? false : true : false : false : VisitContextUse<Nested, Tag, Property, ContextMethod> : Children extends CraftDirectiveNode<any> ? VisitContextUse<Children['node'], Tag, Property, ContextMethod> : Children extends ComponentNode<any, any, infer Component> ? VisitContextUse<ReturnType<ComponentTemplateOf<Component>>, Tag, Property, ContextMethod> : Children extends ForNode<any, any> ? VisitContextUse<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Tag, Property, ContextMethod> : Children extends DeferNode<infer Loaded> ? VisitContextUse<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Tag, Property, ContextMethod> : false;
 /** Checks that a property callback delegates to a named template context member. */
 export type TemplateDelegatesToContext<Children extends CraftNodeChildren, Tag extends string, Property extends string, ContextMethod extends string = Property> = VisitContextUse<Children, Tag, Property, ContextMethod>;
 type EventHandlerOf<Props, EventName extends string> = EventName extends keyof Props ? Props[EventName] : `on${Capitalize<EventName>}` extends keyof Props ? Props[`on${Capitalize<EventName>}`] : never;
 type VisitEvent<Children, Tag extends string, EventName extends string, Handler extends (...args: any[]) => any> = Children extends readonly (infer Child)[] ? VisitEvent<Child, Tag, EventName, Handler> : Children extends ElementNodeBase<any, infer ActualTag, infer Props> ? ActualTag extends Tag ? EventHandlerOf<Props, EventName> extends Handler ? Handler extends EventHandlerOf<Props, EventName> ? true : false : false : VisitEvent<Children['children'], Tag, EventName, Handler> : Children extends CraftDirectiveNode<any> ? VisitEvent<Children['node'], Tag, EventName, Handler> : Children extends ComponentNode<any, any, infer Component> ? VisitEvent<ReturnType<ComponentTemplateOf<Component>>, Tag, EventName, Handler> : false;
-type VisitOutput<Children, Target extends CraftComponent<any, any>, Name extends keyof PropsOf<Target> & string, Handler extends (...args: any[]) => any> = Children extends readonly (infer Child)[] ? VisitOutput<Child, Target, Name, Handler> : Children extends ElementNodeBase<any, any, any, infer Nested> ? VisitOutput<Nested, Target, Name, Handler> : Children extends CraftDirectiveNode<any> ? VisitOutput<Children['node'], Target, Name, Handler> : Children extends ComponentNode<infer Props, any, infer Actual> ? [Actual] extends [Target] ? Name extends keyof Props ? Props[Name] extends Handler ? Handler extends Props[Name] ? true : false : false : false : VisitOutput<ReturnType<ComponentTemplateOf<Actual>>, Target, Name, Handler> : Children extends EachNode<any, any> ? VisitOutput<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Target, Name, Handler> : Children extends DeferNode<infer Loaded> ? VisitOutput<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Target, Name, Handler> : false;
+type VisitOutput<Children, Target extends CraftComponent<any, any>, Name extends keyof PropsOf<Target> & string, Handler extends (...args: any[]) => any> = Children extends readonly (infer Child)[] ? VisitOutput<Child, Target, Name, Handler> : Children extends ElementNodeBase<any, any, any, infer Nested> ? VisitOutput<Nested, Target, Name, Handler> : Children extends CraftDirectiveNode<any> ? VisitOutput<Children['node'], Target, Name, Handler> : Children extends ComponentNode<infer Props, any, infer Actual> ? [Actual] extends [Target] ? Name extends keyof Props ? Props[Name] extends Handler ? Handler extends Props[Name] ? true : false : false : false : VisitOutput<ReturnType<ComponentTemplateOf<Actual>>, Target, Name, Handler> : Children extends ForNode<any, any> ? VisitOutput<ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never), Target, Name, Handler> : Children extends DeferNode<infer Loaded> ? VisitOutput<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Target, Name, Handler> : false;
 /** Checks an event callback and therefore preserves its argument type. */
 export type TemplateHasEvent<Children extends CraftNodeChildren, Tag extends string, EventName extends string, Handler extends (...args: any[]) => any> = VisitEvent<Children, Tag, EventName, Handler>;
 /** Checks that a DOM event is a generator callback with the given arguments. */
@@ -75,7 +75,7 @@ export type TemplateHasYieldableMethodEvent<Children extends CraftNodeChildren,
 type VisitYieldableEvent<Children, Tag extends string, EventName extends string, Args extends unknown[]> = Children extends readonly (infer Child)[] ? VisitYieldableEvent<Child, Tag, EventName, Args> : Children extends ElementNodeBase<any, infer ActualTag, infer Props> ? ActualTag extends Tag ? EventHandlerOf<Props, EventName> extends (...args: infer ActualArgs) => Generator<any, any, any> ? ActualArgs extends Args ? Args extends ActualArgs ? true : false : false : false : VisitYieldableEvent<Children['children'], Tag, EventName, Args> : Children extends CraftDirectiveNode<any> ? VisitYieldableEvent<Children['node'], Tag, EventName, Args> : Children extends ComponentNode<any, any, infer Component> ? VisitYieldableEvent<ReturnType<ComponentTemplateOf<Component>>, Tag, EventName, Args> : false;
 /** Checks an output callback passed to a concrete Craft child component. */
 export type TemplateHasOutput<Children extends CraftNodeChildren, Component extends CraftComponent<any, any>, Name extends keyof PropsOf<Component> & string, Handler extends (...args: any[]) => any> = VisitOutput<Children, Component, Name, Handler>;
-export type TemplateUsesComponent<Children extends CraftNodeChildren, Component extends CraftComponent<any, any>> = Children extends readonly (infer Child)[] ? TemplateUsesComponent<Child & CraftNodeChildren, Component> : Children extends ComponentNode<any, any, infer Actual> ? [Actual] extends [Component] ? true : TemplateUsesComponent<ReturnType<ComponentTemplateOf<Actual>>, Component> : Children extends ElementNodeBase<any, any, any, infer Nested> ? TemplateUsesComponent<Nested, Component> : Children extends CraftDirectiveNode<any> ? TemplateUsesComponent<Children['node'], Component> : Children extends EachNode<any, any> ? TemplateUsesComponent<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Component> : Children extends DeferNode<infer Loaded> ? Loaded extends CraftComponent<any, any> ? [Loaded] extends [Component] ? true : TemplateUsesComponent<ReturnType<ComponentTemplateOf<Loaded>>, Component> : TemplateUsesComponent<ReturnType<Children['resolve']>, Component> : false;
+export type TemplateUsesComponent<Children extends CraftNodeChildren, Component extends CraftComponent<any, any>> = Children extends readonly (infer Child)[] ? TemplateUsesComponent<Child & CraftNodeChildren, Component> : Children extends ComponentNode<any, any, infer Actual> ? [Actual] extends [Component] ? true : TemplateUsesComponent<ReturnType<ComponentTemplateOf<Actual>>, Component> : Children extends ElementNodeBase<any, any, any, infer Nested> ? TemplateUsesComponent<Nested, Component> : Children extends CraftDirectiveNode<any> ? TemplateUsesComponent<Children['node'], Component> : Children extends ForNode<any, any> ? TemplateUsesComponent<(ReturnType<Children['itemTemplate']> | (Children['empty'] extends (...args: any[]) => infer Empty ? Empty : never)) & CraftNodeChildren, Component> : Children extends DeferNode<infer Loaded> ? Loaded extends CraftComponent<any, any> ? [Loaded] extends [Component] ? true : TemplateUsesComponent<ReturnType<ComponentTemplateOf<Loaded>>, Component> : TemplateUsesComponent<ReturnType<Children['resolve']>, Component> : false;
 type VisibilityValue = boolean | 'nonEmpty' | 'empty';
 type Visibility = Readonly<Record<string, VisibilityValue>>;
 type VisibilityMatches<Actual extends Visibility, Expected extends Visibility> = keyof Expected extends never ? keyof Actual extends never ? true : false : {
@@ -105,13 +105,13 @@ type VisitRenderedState<Children, StateName extends string, Expected extends Vis
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitRenderedState<Item, StateName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
+]> : Children extends ForNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitRenderedState<Item, StateName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
     ...Depth,
     unknown
 ]> | VisitRenderedState<Empty, StateName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'empty'>, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<infer ConditionName, any, infer True, infer False> ? VisitRenderedState<True, StateName, Expected, AddVisibility<Current, ConditionName, true>, Seen, [
+]> : Children extends IfNode<infer ConditionName, any, infer True, infer False> ? VisitRenderedState<True, StateName, Expected, AddVisibility<Current, ConditionName, true>, Seen, [
     ...Depth,
     unknown
 ]> | VisitRenderedState<False, StateName, Expected, AddVisibility<Current, ConditionName, false>, Seen, [
@@ -145,13 +145,13 @@ type VisitAvailableAction<Children, EventName extends string, LocalName extends
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitAvailableAction<Item, EventName, LocalName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
+]> : Children extends ForNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitAvailableAction<Item, EventName, LocalName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
     ...Depth,
     unknown
 ]> | VisitAvailableAction<Empty, EventName, LocalName, Expected, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'empty'>, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<infer ConditionName, any, infer True, infer False> ? VisitAvailableAction<True, EventName, LocalName, Expected, AddVisibility<Current, ConditionName, true>, Seen, [
+]> : Children extends IfNode<infer ConditionName, any, infer True, infer False> ? VisitAvailableAction<True, EventName, LocalName, Expected, AddVisibility<Current, ConditionName, true>, Seen, [
     ...Depth,
     unknown
 ]> | VisitAvailableAction<False, EventName, LocalName, Expected, AddVisibility<Current, ConditionName, false>, Seen, [
@@ -191,10 +191,10 @@ type VisitNamedElementIdentities<Children, Owner extends string = never, Seen ex
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, any, infer Item, infer Empty> ? VisitNamedElementIdentities<Item | Empty, Owner, Seen, [
+]> : Children extends ForNode<any, any, any, any, infer Item, infer Empty> ? VisitNamedElementIdentities<Item | Empty, Owner, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<any, any, infer True, infer False> ? VisitNamedElementIdentities<True | False, Owner, Seen, [
+]> : Children extends IfNode<any, any, infer True, infer False> ? VisitNamedElementIdentities<True | False, Owner, Seen, [
     ...Depth,
     unknown
 ]> : Children extends DeferNode<infer Loaded> ? VisitNamedElementIdentities<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Owner, Seen, [
@@ -227,10 +227,10 @@ type NamedElementPropsOf<Children, Identity extends string, Owner extends string
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, any, infer Item, infer Empty> ? NamedElementPropsOf<Item | Empty, Identity, Owner, Seen, [
+]> : Children extends ForNode<any, any, any, any, infer Item, infer Empty> ? NamedElementPropsOf<Item | Empty, Identity, Owner, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<any, any, infer True, infer False> ? NamedElementPropsOf<True | False, Identity, Owner, Seen, [
+]> : Children extends IfNode<any, any, infer True, infer False> ? NamedElementPropsOf<True | False, Identity, Owner, Seen, [
     ...Depth,
     unknown
 ]> : Children extends DeferNode<infer Loaded> ? NamedElementPropsOf<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Identity, Owner, Seen, [
@@ -256,10 +256,10 @@ type NamedElementDelegatesToContextOf<Children, Identity extends string, Propert
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, any, infer Item, infer Empty> ? NamedElementDelegatesToContextOf<Item | Empty, Identity, Property, ContextMethod, Owner, Seen, [
+]> : Children extends ForNode<any, any, any, any, infer Item, infer Empty> ? NamedElementDelegatesToContextOf<Item | Empty, Identity, Property, ContextMethod, Owner, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<any, any, infer True, infer False> ? NamedElementDelegatesToContextOf<True | False, Identity, Property, ContextMethod, Owner, Seen, [
+]> : Children extends IfNode<any, any, infer True, infer False> ? NamedElementDelegatesToContextOf<True | False, Identity, Property, ContextMethod, Owner, Seen, [
     ...Depth,
     unknown
 ]> : Children extends DeferNode<infer Loaded> ? NamedElementDelegatesToContextOf<Loaded extends CraftComponent<any, any> ? ReturnType<ComponentTemplateOf<Loaded>> : ReturnType<Children['resolve']>, Identity, Property, ContextMethod, Owner, Seen, [
@@ -283,13 +283,13 @@ type NamedElementRendersStateWhenOf<Children, Identity extends string, Property
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, infer SourceName, infer Item, infer Empty> ? NamedElementRendersStateWhenOf<Item, Identity, Property, StateName, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
+]> : Children extends ForNode<any, any, any, infer SourceName, infer Item, infer Empty> ? NamedElementRendersStateWhenOf<Item, Identity, Property, StateName, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
     ...Depth,
     unknown
 ]> | NamedElementRendersStateWhenOf<Empty, Identity, Property, StateName, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'empty'>, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<infer ConditionName, any, infer True, infer False> ? NamedElementRendersStateWhenOf<True, Identity, Property, StateName, Expected, Owner, AddVisibility<Current, ConditionName, true>, Seen, [
+]> : Children extends IfNode<infer ConditionName, any, infer True, infer False> ? NamedElementRendersStateWhenOf<True, Identity, Property, StateName, Expected, Owner, AddVisibility<Current, ConditionName, true>, Seen, [
     ...Depth,
     unknown
 ]> | NamedElementRendersStateWhenOf<False, Identity, Property, StateName, Expected, Owner, AddVisibility<Current, ConditionName, false>, Seen, [
@@ -320,13 +320,13 @@ type VisitNamedElement<Children, Identity extends string, Expected extends Visib
 ], [
     ...Depth,
     unknown
-]> : Children extends EachNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitNamedElement<Item, Identity, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
+]> : Children extends ForNode<any, any, any, infer SourceName, infer Item, infer Empty> ? VisitNamedElement<Item, Identity, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'nonEmpty'>, Seen, [
     ...Depth,
     unknown
 ]> | VisitNamedElement<Empty, Identity, Expected, Owner, Extract<SourceName, string> extends never ? Current : AddVisibility<Current, Extract<SourceName, string>, 'empty'>, Seen, [
     ...Depth,
     unknown
-]> : Children extends IfBlockNode<infer ConditionName, any, infer True, infer False> ? VisitNamedElement<True, Identity, Expected, Owner, AddVisibility<Current, ConditionName, true>, Seen, [
+]> : Children extends IfNode<infer ConditionName, any, infer True, infer False> ? VisitNamedElement<True, Identity, Expected, Owner, AddVisibility<Current, ConditionName, true>, Seen, [
     ...Depth,
     unknown
 ]> | VisitNamedElement<False, Identity, Expected, Owner, AddVisibility<Current, ConditionName, false>, Seen, [
@@ -344,4 +344,3 @@ export type TemplateRendersNamedElementWhen<Children, Identity extends TemplateN
     readonly when: infer When extends Visibility;
 } ? When : {}, TemplateContractOwner<Children>>>;
 export {};
-//# sourceMappingURL=template-contract.d.ts.map

package/src/lib/template-contract.js

@@ -1 +0,0 @@
-//# sourceMappingURL=template-contract.js.map

package/src/lib/template.d.ts

@@ -1,5 +1,5 @@
-import type { CraftNodeChildren, CraftNodeChildrenDependencies, TemplateNode } from './render/vnode';
-import { type CraftTemplate, type InputValue } from './types';
+import type { CraftNodeChildren, CraftNodeChildrenDependencies, TemplateNode } from './render/vnode.js';
+import { type CraftTemplate, type InputValue } from './types.js';
 type TemplateContextInput<Context> = Context extends object ? {
     [Key in keyof Context]: Context[Key] | InputValue<Context[Key]>;
 } : Context | InputValue<Context>;
@@ -8,4 +8,3 @@ export declare function craftTemplate<Context, Output extends CraftNodeChildren
 /** Schedules a typed template for rendering without evaluating it eagerly. */
 export declare function renderTemplate<Context, Output extends CraftNodeChildren>(template: CraftTemplate<Context, Output>, context: TemplateContextInput<NoInfer<Context>>): TemplateNode<Context, Output, CraftNodeChildrenDependencies<Output>>;
 export {};
-//# sourceMappingURL=template.d.ts.map

package/src/lib/template.js

@@ -1,5 +1,5 @@
-import { CRAFT_TEMPLATE, } from './types';
-import { currentCraftRenderContext } from './render/vnode';
+import { CRAFT_TEMPLATE, } from './types.js';
+import { currentCraftRenderContext } from './render/vnode.js';
 /** Creates an inert, reusable and context-checked Craft template fragment. */
 export function craftTemplate(renderer) {
     const template = ((context) => renderer(context));
@@ -18,4 +18,3 @@ export function renderTemplate(template, context) {
         declarationContext: currentCraftRenderContext(),
     };
 }
-//# sourceMappingURL=template.js.map

package/src/lib/testing.d.ts

@@ -1,6 +1,6 @@
 import { type CraftServiceProvider, type CompleteServiceDependencyMapFromYielded, type FlattenDependencyTree } from '@craft-ts/core';
-import { type ComponentFactory, type ComponentTemplate, type CraftComponent, type CraftDirective, type FactoryContext, type FactoryYielded, type PropsOf, type TemplateDependencies } from './types';
-import type { CraftTemplateLocatorApi } from './locator';
+import { type ComponentFactory, type ComponentTemplate, type CraftComponent, type CraftDirective, type FactoryContext, type FactoryYielded, type PropsOf, type TemplateDependencies } from './types.js';
+import type { CraftTemplateLocatorApi } from './locator.js';
 type IsAny<T> = 0 extends 1 & T ? true : false;
 type ComponentFactoryOf<Component> = Component extends CraftComponent<any, any, infer Factory extends ComponentFactory> ? Factory : ComponentFactory;
 type ComponentTemplateDepsOf<Component> = Component extends CraftComponent<any, any, any, any, any, infer TemplateDeps> ? TemplateDeps : {};
@@ -105,7 +105,7 @@ export declare function renderCraftComponent<Component extends CraftComponent<an
 }): Promise<{
     nativeElement: HTMLDivElement;
     element: HTMLDivElement;
-    mounted: import("./render/interpreter").MountedCraftComponent<PropsOf<Component>>;
+    mounted: import("./render/interpreter.js").MountedCraftComponent<PropsOf<Component>>;
     injector: import("@craft-ts/core").ɵEnvironmentInjector & import("@craft-ts/core").CraftInjector;
     detectChanges: () => void;
     flush: () => Promise<void>;
@@ -154,4 +154,3 @@ export declare const setupCraftDirectiveTemplateTest: typeof setupCraftDirective
  */
 export declare function assertAccessible(container: Element): Promise<void>;
 export {};
-//# sourceMappingURL=testing.d.ts.map

package/src/lib/testing.js

@@ -1,9 +1,9 @@
-import { createEnvironmentInjector, ElementRef, Injector, runInInjectionContext, ɵEffectScheduler, ɵINJECTOR_SCOPE, } from './host-runtime';
+import { createEnvironmentInjector, ElementRef, Injector, runInInjectionContext, ɵEffectScheduler, ɵINJECTOR_SCOPE, } from './host-runtime.js';
 import { CRAFT_SERVICE_PROVIDER_BRAND, createExposedServiceValue, getRegisteredAppStartServices, getServiceMetaData, runServiceAppStart, SERVICE_RUNTIME_OVERRIDES, } from '@craft-ts/core';
-import { mountInterpretedComponent, mountInterpretedComponentTemplate, } from './render/interpreter';
-import { craftComponent } from './component';
-import { executeCraftComponentFactory } from './factory-runtime';
-import { CRAFT_COMPONENT, CRAFT_DIRECTIVE, } from './types';
+import { mountInterpretedComponent, mountInterpretedComponentTemplate, } from './render/interpreter.js';
+import { craftComponent } from './component.js';
+import { executeCraftComponentFactory } from './factory-runtime.js';
+import { CRAFT_COMPONENT, CRAFT_DIRECTIVE, } from './types.js';
 function isProvider(value) {
     return (typeof value === 'object' &&
         value !== null &&
@@ -413,4 +413,3 @@ export async function assertAccessible(container) {
         throw new Error(`Accessibility violations:\n- ${violations.join('\n- ')}`);
     }
 }
-//# sourceMappingURL=testing.js.map