@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-node-directive.js

@@ -0,0 +1,22 @@
+import { InjectionToken, } from './host/craft-compat';
+import { CRAFT_REGISTRATION_TARGET, } from './craft-register-for-runtime';
+/** Runtime marker shared by core-authored DOM directives and the Craft renderer. */
+export const CRAFT_NODE_DIRECTIVE = Symbol.for('@craft-ts/core/craft-node-directive');
+export const CRAFT_NODE_EFFECT_FACTORY = new InjectionToken('CRAFT_NODE_EFFECT_FACTORY');
+/** Creates a functional directive mounted directly on a rendered DOM node. */
+export function craftNodeDirective(name, inputs, mount) {
+    const directive = (() => undefined);
+    Object.defineProperty(directive, CRAFT_NODE_DIRECTIVE, {
+        value: { name, inputs, mount },
+        enumerable: false,
+    });
+    Object.defineProperty(directive, CRAFT_REGISTRATION_TARGET, {
+        value: { kind: 'directive', name },
+        enumerable: false,
+    });
+    return directive;
+}
+export function isCraftNodeDirective(value) {
+    return typeof value === 'function' && CRAFT_NODE_DIRECTIVE in value;
+}
+//# sourceMappingURL=craft-node-directive.js.map

package/src/lib/craft-node-directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-node-directive.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-node-directive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,GAE1B,MAAM,8BAA8B,CAAC;AAGtC,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAC5C,qCAAqC,CACtC,CAAC;AAQF,MAAM,CAAC,MAAM,yBAAyB,GACpC,IAAI,cAAc,CAAyB,2BAA2B,CAAC,CAAC;AA8C1E,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAGhC,IAAY,EACZ,MAAyC,EACzC,KAAqC;IAErC,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAyC,CAAC;IAE5E,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,oBAAoB,EAAE;QACrD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;QAC9B,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,yBAAyB,EAAE;QAC1D,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QAClC,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,oBAAoB,IAAI,KAAK,CAAC;AACtE,CAAC","sourcesContent":["import {\n  InjectionToken,\n  type EffectRef,\n  type Injector,\n} from './host/craft-compat';\nimport {\n  CRAFT_REGISTRATION_TARGET,\n  type CraftRegistrationTarget,\n} from './craft-register-for-runtime';\nimport type { CraftDomAdapter } from './host/craft-dom';\n\n/** Runtime marker shared by core-authored DOM directives and the Craft renderer. */\nexport const CRAFT_NODE_DIRECTIVE = Symbol.for(\n  '@craft-ts/core/craft-node-directive',\n);\n\n/** Creates a reactive effect owned by the current node-directive mount. */\nexport type CraftNodeEffectFactory = (\n  name: string,\n  effectFn: () => void,\n) => EffectRef;\n\nexport const CRAFT_NODE_EFFECT_FACTORY =\n  new InjectionToken<CraftNodeEffectFactory>('CRAFT_NODE_EFFECT_FACTORY');\n\n/** The element-scoped services and reactive inputs available to a DOM directive. */\nexport interface CraftNodeDirectiveContext<\n  Props extends Readonly<Record<string, unknown>> = Readonly<\n    Record<string, unknown>\n  >,\n> {\n  readonly element: Element;\n  readonly injector: Injector;\n  readonly renderer: CraftDomAdapter;\n  /**\n   * The current directive inputs. Reading this property inside an effect tracks\n   * input updates without remounting the directive.\n   */\n  readonly props: Props;\n}\n\nexport type CraftNodeDirectiveMount<\n  Props extends Readonly<Record<string, unknown>> = Readonly<\n    Record<string, unknown>\n  >,\n> = (context: CraftNodeDirectiveContext<Props>) => void | (() => void);\n\nexport interface CraftNodeDirectiveDefinition<\n  Props extends Readonly<Record<string, unknown>> = Readonly<\n    Record<string, unknown>\n  >,\n> {\n  readonly name: string;\n  readonly inputs: readonly (keyof Props & string)[];\n  readonly mount: CraftNodeDirectiveMount<Props>;\n}\n\nexport interface CraftNodeDirective<\n  Props extends Readonly<Record<string, unknown>> = Readonly<\n    Record<string, unknown>\n  >,\n> extends CraftRegistrationTarget<\n    string,\n    'directive',\n    CraftNodeDirectiveContext<Props>\n  > {\n  readonly [CRAFT_NODE_DIRECTIVE]: CraftNodeDirectiveDefinition<Props>;\n}\n\n/** Creates a functional directive mounted directly on a rendered DOM node. */\nexport function craftNodeDirective<\n  const Props extends Readonly<Record<string, unknown>>,\n>(\n  name: string,\n  inputs: readonly (keyof Props & string)[],\n  mount: CraftNodeDirectiveMount<Props>,\n): CraftNodeDirective<Props> {\n  const directive = (() => undefined) as unknown as CraftNodeDirective<Props>;\n\n  Object.defineProperty(directive, CRAFT_NODE_DIRECTIVE, {\n    value: { name, inputs, mount },\n    enumerable: false,\n  });\n  Object.defineProperty(directive, CRAFT_REGISTRATION_TARGET, {\n    value: { kind: 'directive', name },\n    enumerable: false,\n  });\n\n  return directive;\n}\n\nexport function isCraftNodeDirective(\n  value: unknown,\n): value is CraftNodeDirective<any> {\n  return typeof value === 'function' && CRAFT_NODE_DIRECTIVE in value;\n}\n"]}

package/src/lib/craft-pending.d.ts

@@ -0,0 +1,115 @@
+import { InjectionToken, type Provider, type Signal } from './host/craft-compat';
+import type { CraftExceptionComponentDescriptor } from './craft-route-exceptions';
+import { type CraftRouteTargetInput } from './craft-route-target';
+/**
+ * The text rendered by {@link DefaultCraftPendingComponent}. A `Signal<string>`
+ * so a reactive translation source can be plugged in via {@link withLoadingText}.
+ *
+ * The default reads {@link LOCALE_ID} and picks a built-in translation (English
+ * and French shipped; unknown locales fall back to English).
+ */
+export declare const CRAFT_LOADING_TEXT: InjectionToken<Signal<string>>;
+/**
+ * Installs the real loader. `@craft-ts/component` calls this on import, since
+ * rendering anything at all needs the renderer that only it owns.
+ */
+export declare function ɵregisterDefaultCraftPendingComponent(component: CraftRouteTargetInput): void;
+/**
+ * The component (loader) shown in the **pending** phase — once both
+ * {@link CRAFT_STAY_MS} and {@link CRAFT_BLANK_MS} have elapsed and the route's
+ * guard/resolve chain is still in flight. Defaults to
+ * {@link DefaultCraftPendingComponent}.
+ */
+export declare const CRAFT_PENDING_COMPONENT: InjectionToken<CraftRouteTargetInput>;
+/**
+ * Phase 1 duration (ms): how long the outlet keeps the **previous page** on
+ * screen after the URL commits, before blanking it. A chain that settles within
+ * this window transitions straight to the target — no blank, no loader.
+ * Defaults to `300`.
+ */
+export declare const CRAFT_STAY_MS: InjectionToken<number>;
+/**
+ * Phase 2 duration (ms): how long the outlet shows a **blank** surface (after
+ * {@link CRAFT_STAY_MS}) before showing the pending component (loader). A chain
+ * that settles within this window transitions straight to the target without
+ * ever flashing the loader. Defaults to `300`.
+ */
+export declare const CRAFT_BLANK_MS: InjectionToken<number>;
+/**
+ * Phase 3 anti-flicker (ms): once the pending component (loader) is shown, keep
+ * it visible for at least this long so a chain that settles right after the
+ * loader appears does not blink it in and out. Defaults to `0` (no minimum).
+ */
+export declare const CRAFT_PENDING_MIN_MS: InjectionToken<number>;
+/**
+ * The application-wide global error component, rendered by the outlet when a
+ * route exception handler delegates to `globalError()`. `null` until configured
+ * via {@link withErrorComponent}; the global error component reads its (typed)
+ * exception with `injectCraftGlobalError()`.
+ */
+export declare const CRAFT_ERROR_COMPONENT: InjectionToken<CraftExceptionComponentDescriptor | null>;
+declare const CRAFT_LOADING_FEATURE: unique symbol;
+/**
+ * An opaque unit of pending/error configuration produced by a `with*` helper and
+ * consumed by {@link provideCraftLoading}. Mirrors Angular's `provideRouter`
+ * feature pattern so config reads as `provideCraftLoading(withX(), withY())`.
+ */
+export interface CraftLoadingFeature {
+    readonly [CRAFT_LOADING_FEATURE]: true;
+    readonly providers: Provider[];
+    readonly routerFeatures?: readonly unknown[];
+    readonly recoveryRoute?: unknown;
+}
+/**
+ * Builds an opaque {@link CraftLoadingFeature} from a provider list. Shared with
+ * sibling loading features (e.g. `withCraftViewTransitions`) so they all flow
+ * through {@link provideCraftLoading} / {@link isCraftLoadingFeature}.
+ */
+export declare function craftLoadingFeature(providers: Provider[]): CraftLoadingFeature;
+/**
+ * Runtime guard distinguishing a {@link CraftLoadingFeature} (produced by a
+ * `with*` loading helper) from any other value — notably an Angular
+ * `RouterFeature`. Lets {@link provideCraftRouter} accept loading and router
+ * features mixed in a single call and split them apart.
+ */
+export declare function isCraftLoadingFeature(value: unknown): value is CraftLoadingFeature;
+/** Override the pending component shown while a route chain is in flight. */
+export declare function withPendingComponent(component: CraftRouteTargetInput): CraftLoadingFeature;
+/**
+ * Override the loading text rendered by {@link DefaultCraftPendingComponent}.
+ * The factory runs in an injection context, so it may read a translation
+ * service and return a reactive `Signal<string>`.
+ */
+export declare function withLoadingText(factory: () => Signal<string>): CraftLoadingFeature;
+/**
+ * Override the navigation transition timings (in ms):
+ *
+ * - `stayMs` — phase 1, how long the previous page is kept on screen;
+ * - `blankMs` — phase 2, how long the blank surface is shown before the loader;
+ * - `pendingMinMs` — phase 3, minimum time the loader stays once shown.
+ *
+ * Only the provided keys are overridden.
+ */
+export declare function withTransitionTimings(thresholds: {
+    stayMs?: number;
+    blankMs?: number;
+    pendingMinMs?: number;
+}): CraftLoadingFeature;
+/** Register the application-wide global error component (see `globalError()`). */
+export declare function withErrorComponent(component: CraftExceptionComponentDescriptor): CraftLoadingFeature;
+/**
+ * Configures the {@link CraftRouterOutletController} pending/error surface.
+ *
+ * ```ts
+ * provideCraftLoading(
+ *   withTransitionTimings({ stayMs: 300, blankMs: 300, pendingMinMs: 500 }),
+ *   withLoadingText(() => computed(() => translate('common.loading'))),
+ *   withPendingComponent(MyBrandedSpinner),
+ *   // Check the functional error SFC separately through ComponentDepsOf.
+ *   withErrorComponent({ component: CraftGlobalErrorComponentHost }),
+ * )
+ * ```
+ */
+export declare function provideCraftLoading(...features: CraftLoadingFeature[]): Provider[];
+export {};
+//# sourceMappingURL=craft-pending.d.ts.map

package/src/lib/craft-pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-pending.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-pending.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAGd,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAuC9B;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,gCAM9B,CAAC;AAIF;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,qBAAqB,GAC/B,IAAI,CAEN;AAWD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,uCAIhC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,aAAa,wBAGxB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,wBAGzB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,wBAGhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,0DAI/B,CAAC;AAEJ,QAAA,MAAM,qBAAqB,eAAkC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,QAAQ,EAAE,GACpB,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAO9B;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,qBAAqB,GAC/B,mBAAmB,CAIrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,GAC5B,mBAAmB,CAIrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAmBtB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iCAAiC,GAC3C,mBAAmB,CAIrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,QAAQ,EAAE,mBAAmB,EAAE,GACjC,QAAQ,EAAE,CAEZ"}

package/src/lib/craft-pending.js

@@ -0,0 +1,187 @@
+import { inject, InjectionToken, LOCALE_ID, signal, } from './host/craft-compat';
+import { craftRouteTarget, } from './craft-route-target';
+/**
+ * The non-blocking router outlet ({@link CraftRouterOutletController}) commits
+ * the URL
+ * immediately, then runs the route's guard/resolve chain through three phases
+ * while it is in flight:
+ *
+ * 1. **stay** ({@link CRAFT_STAY_MS}) — the PREVIOUS page is kept on screen, so a
+ *    chain that settles quickly transitions straight to the target with no flash;
+ * 2. **blank** ({@link CRAFT_BLANK_MS}) — a blank surface, signalling the page is
+ *    changing;
+ * 3. **pending** — the configured pending component (loader), held for at least
+ *    {@link CRAFT_PENDING_MIN_MS} to avoid flicker.
+ *
+ * The target component is mounted only once the chain succeeds.
+ *
+ * This module owns the pending UI surface: the default pending component, the
+ * DI tokens that parameterise it (component, loading text, phase thresholds,
+ * and the global error component), and the {@link provideCraftLoading} feature
+ * builder used to override them at the application root.
+ */
+const CRAFT_LOADING_TEXT_BY_LANGUAGE = {
+    en: 'Loading…',
+    fr: 'Chargement…',
+};
+const DEFAULT_CRAFT_LOADING_LANGUAGE = 'en';
+function resolveLoadingTextForLocale(locale) {
+    const language = locale.split('-')[0]?.toLowerCase() ?? '';
+    return (CRAFT_LOADING_TEXT_BY_LANGUAGE[language] ??
+        CRAFT_LOADING_TEXT_BY_LANGUAGE[DEFAULT_CRAFT_LOADING_LANGUAGE]);
+}
+/**
+ * The text rendered by {@link DefaultCraftPendingComponent}. A `Signal<string>`
+ * so a reactive translation source can be plugged in via {@link withLoadingText}.
+ *
+ * The default reads {@link LOCALE_ID} and picks a built-in translation (English
+ * and French shipped; unknown locales fall back to English).
+ */
+export const CRAFT_LOADING_TEXT = new InjectionToken('CRAFT_LOADING_TEXT', {
+    providedIn: 'root',
+    factory: () => signal(resolveLoadingTextForLocale(inject(LOCALE_ID))),
+});
+let defaultCraftPendingComponent;
+/**
+ * Installs the real loader. `@craft-ts/component` calls this on import, since
+ * rendering anything at all needs the renderer that only it owns.
+ */
+export function ɵregisterDefaultCraftPendingComponent(component) {
+    defaultCraftPendingComponent = component;
+}
+/**
+ * Core alone can render nothing, so the fallback is an empty target rather
+ * than a throw: a router used without `@craft-ts/component` still navigates,
+ * it just shows nothing during the pending phase.
+ */
+function getDefaultCraftPendingComponent() {
+    return defaultCraftPendingComponent ?? craftRouteTarget(null);
+}
+/**
+ * The component (loader) shown in the **pending** phase — once both
+ * {@link CRAFT_STAY_MS} and {@link CRAFT_BLANK_MS} have elapsed and the route's
+ * guard/resolve chain is still in flight. Defaults to
+ * {@link DefaultCraftPendingComponent}.
+ */
+export const CRAFT_PENDING_COMPONENT = new InjectionToken('CRAFT_PENDING_COMPONENT', {
+    providedIn: 'root',
+    factory: () => getDefaultCraftPendingComponent(),
+});
+/**
+ * Phase 1 duration (ms): how long the outlet keeps the **previous page** on
+ * screen after the URL commits, before blanking it. A chain that settles within
+ * this window transitions straight to the target — no blank, no loader.
+ * Defaults to `300`.
+ */
+export const CRAFT_STAY_MS = new InjectionToken('CRAFT_STAY_MS', {
+    providedIn: 'root',
+    factory: () => 300,
+});
+/**
+ * Phase 2 duration (ms): how long the outlet shows a **blank** surface (after
+ * {@link CRAFT_STAY_MS}) before showing the pending component (loader). A chain
+ * that settles within this window transitions straight to the target without
+ * ever flashing the loader. Defaults to `300`.
+ */
+export const CRAFT_BLANK_MS = new InjectionToken('CRAFT_BLANK_MS', {
+    providedIn: 'root',
+    factory: () => 300,
+});
+/**
+ * Phase 3 anti-flicker (ms): once the pending component (loader) is shown, keep
+ * it visible for at least this long so a chain that settles right after the
+ * loader appears does not blink it in and out. Defaults to `0` (no minimum).
+ */
+export const CRAFT_PENDING_MIN_MS = new InjectionToken('CRAFT_PENDING_MIN_MS', { providedIn: 'root', factory: () => 0 });
+/**
+ * The application-wide global error component, rendered by the outlet when a
+ * route exception handler delegates to `globalError()`. `null` until configured
+ * via {@link withErrorComponent}; the global error component reads its (typed)
+ * exception with `injectCraftGlobalError()`.
+ */
+export const CRAFT_ERROR_COMPONENT = new InjectionToken('CRAFT_ERROR_COMPONENT', { providedIn: 'root', factory: () => null });
+const CRAFT_LOADING_FEATURE = Symbol('craft-loading-feature');
+/**
+ * Builds an opaque {@link CraftLoadingFeature} from a provider list. Shared with
+ * sibling loading features (e.g. `withCraftViewTransitions`) so they all flow
+ * through {@link provideCraftLoading} / {@link isCraftLoadingFeature}.
+ */
+export function craftLoadingFeature(providers) {
+    return { [CRAFT_LOADING_FEATURE]: true, providers };
+}
+/**
+ * Runtime guard distinguishing a {@link CraftLoadingFeature} (produced by a
+ * `with*` loading helper) from any other value — notably an Angular
+ * `RouterFeature`. Lets {@link provideCraftRouter} accept loading and router
+ * features mixed in a single call and split them apart.
+ */
+export function isCraftLoadingFeature(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[CRAFT_LOADING_FEATURE] ===
+            true);
+}
+/** Override the pending component shown while a route chain is in flight. */
+export function withPendingComponent(component) {
+    return craftLoadingFeature([
+        { provide: CRAFT_PENDING_COMPONENT, useValue: component },
+    ]);
+}
+/**
+ * Override the loading text rendered by {@link DefaultCraftPendingComponent}.
+ * The factory runs in an injection context, so it may read a translation
+ * service and return a reactive `Signal<string>`.
+ */
+export function withLoadingText(factory) {
+    return craftLoadingFeature([
+        { provide: CRAFT_LOADING_TEXT, useFactory: factory },
+    ]);
+}
+/**
+ * Override the navigation transition timings (in ms):
+ *
+ * - `stayMs` — phase 1, how long the previous page is kept on screen;
+ * - `blankMs` — phase 2, how long the blank surface is shown before the loader;
+ * - `pendingMinMs` — phase 3, minimum time the loader stays once shown.
+ *
+ * Only the provided keys are overridden.
+ */
+export function withTransitionTimings(thresholds) {
+    const providers = [];
+    if (thresholds.stayMs !== undefined) {
+        providers.push({ provide: CRAFT_STAY_MS, useValue: thresholds.stayMs });
+    }
+    if (thresholds.blankMs !== undefined) {
+        providers.push({ provide: CRAFT_BLANK_MS, useValue: thresholds.blankMs });
+    }
+    if (thresholds.pendingMinMs !== undefined) {
+        providers.push({
+            provide: CRAFT_PENDING_MIN_MS,
+            useValue: thresholds.pendingMinMs,
+        });
+    }
+    return craftLoadingFeature(providers);
+}
+/** Register the application-wide global error component (see `globalError()`). */
+export function withErrorComponent(component) {
+    return craftLoadingFeature([
+        { provide: CRAFT_ERROR_COMPONENT, useValue: component },
+    ]);
+}
+/**
+ * Configures the {@link CraftRouterOutletController} pending/error surface.
+ *
+ * ```ts
+ * provideCraftLoading(
+ *   withTransitionTimings({ stayMs: 300, blankMs: 300, pendingMinMs: 500 }),
+ *   withLoadingText(() => computed(() => translate('common.loading'))),
+ *   withPendingComponent(MyBrandedSpinner),
+ *   // Check the functional error SFC separately through ComponentDepsOf.
+ *   withErrorComponent({ component: CraftGlobalErrorComponentHost }),
+ * )
+ * ```
+ */
+export function provideCraftLoading(...features) {
+    return features.flatMap((feature) => feature.providers);
+}
+//# sourceMappingURL=craft-pending.js.map

package/src/lib/craft-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-pending.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-pending.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  inject,\n  InjectionToken,\n  LOCALE_ID,\n  signal,\n  type Provider,\n  type Signal,\n} from './host/craft-compat';\nimport type { CraftExceptionComponentDescriptor } from './craft-route-exceptions';\nimport {\n  craftRouteTarget,\n  type CraftRouteTargetInput,\n} from './craft-route-target';\n\n/**\n * The non-blocking router outlet ({@link CraftRouterOutletController}) commits\n * the URL\n * immediately, then runs the route's guard/resolve chain through three phases\n * while it is in flight:\n *\n * 1. **stay** ({@link CRAFT_STAY_MS}) — the PREVIOUS page is kept on screen, so a\n *    chain that settles quickly transitions straight to the target with no flash;\n * 2. **blank** ({@link CRAFT_BLANK_MS}) — a blank surface, signalling the page is\n *    changing;\n * 3. **pending** — the configured pending component (loader), held for at least\n *    {@link CRAFT_PENDING_MIN_MS} to avoid flicker.\n *\n * The target component is mounted only once the chain succeeds.\n *\n * This module owns the pending UI surface: the default pending component, the\n * DI tokens that parameterise it (component, loading text, phase thresholds,\n * and the global error component), and the {@link provideCraftLoading} feature\n * builder used to override them at the application root.\n */\n\nconst CRAFT_LOADING_TEXT_BY_LANGUAGE: Readonly<Record<string, string>> = {\n  en: 'Loading…',\n  fr: 'Chargement…',\n};\n\nconst DEFAULT_CRAFT_LOADING_LANGUAGE = 'en';\n\nfunction resolveLoadingTextForLocale(locale: string): string {\n  const language = locale.split('-')[0]?.toLowerCase() ?? '';\n\n  return (\n    CRAFT_LOADING_TEXT_BY_LANGUAGE[language] ??\n    CRAFT_LOADING_TEXT_BY_LANGUAGE[DEFAULT_CRAFT_LOADING_LANGUAGE]\n  );\n}\n\n/**\n * The text rendered by {@link DefaultCraftPendingComponent}. A `Signal<string>`\n * so a reactive translation source can be plugged in via {@link withLoadingText}.\n *\n * The default reads {@link LOCALE_ID} and picks a built-in translation (English\n * and French shipped; unknown locales fall back to English).\n */\nexport const CRAFT_LOADING_TEXT = new InjectionToken<Signal<string>>(\n  'CRAFT_LOADING_TEXT',\n  {\n    providedIn: 'root',\n    factory: () => signal(resolveLoadingTextForLocale(inject(LOCALE_ID))),\n  },\n);\n\nlet defaultCraftPendingComponent: CraftRouteTargetInput | undefined;\n\n/**\n * Installs the real loader. `@craft-ts/component` calls this on import, since\n * rendering anything at all needs the renderer that only it owns.\n */\nexport function ɵregisterDefaultCraftPendingComponent(\n  component: CraftRouteTargetInput,\n): void {\n  defaultCraftPendingComponent = component;\n}\n\n/**\n * Core alone can render nothing, so the fallback is an empty target rather\n * than a throw: a router used without `@craft-ts/component` still navigates,\n * it just shows nothing during the pending phase.\n */\nfunction getDefaultCraftPendingComponent(): CraftRouteTargetInput {\n  return defaultCraftPendingComponent ?? craftRouteTarget(null);\n}\n\n/**\n * The component (loader) shown in the **pending** phase — once both\n * {@link CRAFT_STAY_MS} and {@link CRAFT_BLANK_MS} have elapsed and the route's\n * guard/resolve chain is still in flight. Defaults to\n * {@link DefaultCraftPendingComponent}.\n */\nexport const CRAFT_PENDING_COMPONENT =\n  new InjectionToken<CraftRouteTargetInput>('CRAFT_PENDING_COMPONENT', {\n    providedIn: 'root',\n    factory: () => getDefaultCraftPendingComponent(),\n  });\n\n/**\n * Phase 1 duration (ms): how long the outlet keeps the **previous page** on\n * screen after the URL commits, before blanking it. A chain that settles within\n * this window transitions straight to the target — no blank, no loader.\n * Defaults to `300`.\n */\nexport const CRAFT_STAY_MS = new InjectionToken<number>('CRAFT_STAY_MS', {\n  providedIn: 'root',\n  factory: () => 300,\n});\n\n/**\n * Phase 2 duration (ms): how long the outlet shows a **blank** surface (after\n * {@link CRAFT_STAY_MS}) before showing the pending component (loader). A chain\n * that settles within this window transitions straight to the target without\n * ever flashing the loader. Defaults to `300`.\n */\nexport const CRAFT_BLANK_MS = new InjectionToken<number>('CRAFT_BLANK_MS', {\n  providedIn: 'root',\n  factory: () => 300,\n});\n\n/**\n * Phase 3 anti-flicker (ms): once the pending component (loader) is shown, keep\n * it visible for at least this long so a chain that settles right after the\n * loader appears does not blink it in and out. Defaults to `0` (no minimum).\n */\nexport const CRAFT_PENDING_MIN_MS = new InjectionToken<number>(\n  'CRAFT_PENDING_MIN_MS',\n  { providedIn: 'root', factory: () => 0 },\n);\n\n/**\n * The application-wide global error component, rendered by the outlet when a\n * route exception handler delegates to `globalError()`. `null` until configured\n * via {@link withErrorComponent}; the global error component reads its (typed)\n * exception with `injectCraftGlobalError()`.\n */\nexport const CRAFT_ERROR_COMPONENT =\n  new InjectionToken<CraftExceptionComponentDescriptor | null>(\n    'CRAFT_ERROR_COMPONENT',\n    { providedIn: 'root', factory: () => null },\n  );\n\nconst CRAFT_LOADING_FEATURE = Symbol('craft-loading-feature');\n\n/**\n * An opaque unit of pending/error configuration produced by a `with*` helper and\n * consumed by {@link provideCraftLoading}. Mirrors Angular's `provideRouter`\n * feature pattern so config reads as `provideCraftLoading(withX(), withY())`.\n */\nexport interface CraftLoadingFeature {\n  readonly [CRAFT_LOADING_FEATURE]: true;\n  readonly providers: Provider[];\n  readonly routerFeatures?: readonly unknown[];\n  readonly recoveryRoute?: unknown;\n}\n\n/**\n * Builds an opaque {@link CraftLoadingFeature} from a provider list. Shared with\n * sibling loading features (e.g. `withCraftViewTransitions`) so they all flow\n * through {@link provideCraftLoading} / {@link isCraftLoadingFeature}.\n */\nexport function craftLoadingFeature(\n  providers: Provider[],\n): CraftLoadingFeature {\n  return { [CRAFT_LOADING_FEATURE]: true, providers };\n}\n\n/**\n * Runtime guard distinguishing a {@link CraftLoadingFeature} (produced by a\n * `with*` loading helper) from any other value — notably an Angular\n * `RouterFeature`. Lets {@link provideCraftRouter} accept loading and router\n * features mixed in a single call and split them apart.\n */\nexport function isCraftLoadingFeature(\n  value: unknown,\n): value is CraftLoadingFeature {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { [CRAFT_LOADING_FEATURE]?: unknown })[CRAFT_LOADING_FEATURE] ===\n      true\n  );\n}\n\n/** Override the pending component shown while a route chain is in flight. */\nexport function withPendingComponent(\n  component: CraftRouteTargetInput,\n): CraftLoadingFeature {\n  return craftLoadingFeature([\n    { provide: CRAFT_PENDING_COMPONENT, useValue: component },\n  ]);\n}\n\n/**\n * Override the loading text rendered by {@link DefaultCraftPendingComponent}.\n * The factory runs in an injection context, so it may read a translation\n * service and return a reactive `Signal<string>`.\n */\nexport function withLoadingText(\n  factory: () => Signal<string>,\n): CraftLoadingFeature {\n  return craftLoadingFeature([\n    { provide: CRAFT_LOADING_TEXT, useFactory: factory },\n  ]);\n}\n\n/**\n * Override the navigation transition timings (in ms):\n *\n * - `stayMs` — phase 1, how long the previous page is kept on screen;\n * - `blankMs` — phase 2, how long the blank surface is shown before the loader;\n * - `pendingMinMs` — phase 3, minimum time the loader stays once shown.\n *\n * Only the provided keys are overridden.\n */\nexport function withTransitionTimings(thresholds: {\n  stayMs?: number;\n  blankMs?: number;\n  pendingMinMs?: number;\n}): CraftLoadingFeature {\n  const providers: Provider[] = [];\n\n  if (thresholds.stayMs !== undefined) {\n    providers.push({ provide: CRAFT_STAY_MS, useValue: thresholds.stayMs });\n  }\n\n  if (thresholds.blankMs !== undefined) {\n    providers.push({ provide: CRAFT_BLANK_MS, useValue: thresholds.blankMs });\n  }\n\n  if (thresholds.pendingMinMs !== undefined) {\n    providers.push({\n      provide: CRAFT_PENDING_MIN_MS,\n      useValue: thresholds.pendingMinMs,\n    });\n  }\n\n  return craftLoadingFeature(providers);\n}\n\n/** Register the application-wide global error component (see `globalError()`). */\nexport function withErrorComponent(\n  component: CraftExceptionComponentDescriptor,\n): CraftLoadingFeature {\n  return craftLoadingFeature([\n    { provide: CRAFT_ERROR_COMPONENT, useValue: component },\n  ]);\n}\n\n/**\n * Configures the {@link CraftRouterOutletController} pending/error surface.\n *\n * ```ts\n * provideCraftLoading(\n *   withTransitionTimings({ stayMs: 300, blankMs: 300, pendingMinMs: 500 }),\n *   withLoadingText(() => computed(() => translate('common.loading'))),\n *   withPendingComponent(MyBrandedSpinner),\n *   // Check the functional error SFC separately through ComponentDepsOf.\n *   withErrorComponent({ component: CraftGlobalErrorComponentHost }),\n * )\n * ```\n */\nexport function provideCraftLoading(\n  ...features: CraftLoadingFeature[]\n): Provider[] {\n  return features.flatMap((feature) => feature.providers);\n}\n"]}

package/src/lib/craft-pipe.d.ts

@@ -0,0 +1,63 @@
+import { type YieldableInsertionMethods } from './yieldable';
+type NormalizeIns<T> = [T] extends [never] ? {} : T;
+type CtxWithIns<Ctx, I> = Omit<Ctx, 'insertions'> & {
+    insertions: YieldableInsertionMethods<I>;
+};
+type MergedIns<Ctx extends {
+    insertions?: any;
+}, I> = NormalizeIns<Ctx['insertions']> & I;
+/**
+ * Composes several insertions into a single one, for ANY primitive
+ * (`query`, `mutation`, `asyncProcess`, `state`, `queryParams`) and for the
+ * nested insertions of `insertSelect`.
+ *
+ * ```typescript
+ * const users = yield* query(
+ *   config,
+ *   (context) =>
+ *     craftPipe(
+ *       context,
+ *       insertStoragePersister(craftUnique({
+ *         storeName: 'app',
+ *         key: 'users',
+ *       })),
+ *       insertReactOnMutation(deleteUser, { ... }),
+ *     ),
+ * ));
+ * ```
+ *
+ * Semantics are identical to passing the members directly:
+ * - members run left to right,
+ * - each member sees the previous members' outputs on `context.insertions`,
+ * - the resulting outputs are the intersection of all members' outputs
+ *   (on a key conflict the rightmost member wins at runtime),
+ * - tracked dependencies (primitive generator yields, craft-service yields)
+ *   are the union of all members',
+ * - each member factory is individually wrapped with the fn-wrapper chain
+ *   (correlation-id tracking, app snapshots observe each member).
+ *
+ * Inline lambdas keep the primitive's contextual typing because the outer
+ * `(context) => craftPipe(context, ...)` lambda receives the concrete
+ * context from the primitive. Pipes nest freely, including inside
+ * `insertSelect`: `insertSelect('grid', (gridContext) => craftPipe(gridContext, ...))`.
+ */
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, Y1 = never, Y2 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>): Generator<Y1 | Y2, I1 & I2, unknown>;
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, I3, Y1 = never, Y2 = never, Y3 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>, m3: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>) => I3 | Generator<Y3, I3, unknown>): Generator<Y1 | Y2 | Y3, I1 & I2 & I3, unknown>;
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, I3, I4, Y1 = never, Y2 = never, Y3 = never, Y4 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>, m3: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>) => I3 | Generator<Y3, I3, unknown>, m4: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>) => I4 | Generator<Y4, I4, unknown>): Generator<Y1 | Y2 | Y3 | Y4, I1 & I2 & I3 & I4, unknown>;
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, I3, I4, I5, Y1 = never, Y2 = never, Y3 = never, Y4 = never, Y5 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>, m3: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>) => I3 | Generator<Y3, I3, unknown>, m4: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>) => I4 | Generator<Y4, I4, unknown>, m5: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>>) => I5 | Generator<Y5, I5, unknown>): Generator<Y1 | Y2 | Y3 | Y4 | Y5, I1 & I2 & I3 & I4 & I5, unknown>;
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, I3, I4, I5, I6, Y1 = never, Y2 = never, Y3 = never, Y4 = never, Y5 = never, Y6 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>, m3: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>) => I3 | Generator<Y3, I3, unknown>, m4: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>) => I4 | Generator<Y4, I4, unknown>, m5: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>>) => I5 | Generator<Y5, I5, unknown>, m6: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5>>) => I6 | Generator<Y6, I6, unknown>): Generator<Y1 | Y2 | Y3 | Y4 | Y5 | Y6, I1 & I2 & I3 & I4 & I5 & I6, unknown>;
+export declare function craftPipe<Ctx extends {
+    insertions?: any;
+}, I1, I2, I3, I4, I5, I6, I7, Y1 = never, Y2 = never, Y3 = never, Y4 = never, Y5 = never, Y6 = never, Y7 = never>(context: Ctx, m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>, m2: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>) => I2 | Generator<Y2, I2, unknown>, m3: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>) => I3 | Generator<Y3, I3, unknown>, m4: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>) => I4 | Generator<Y4, I4, unknown>, m5: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>>) => I5 | Generator<Y5, I5, unknown>, m6: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5>>) => I6 | Generator<Y6, I6, unknown>, m7: (context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5 & I6>>) => I7 | Generator<Y7, I7, unknown>): Generator<Y1 | Y2 | Y3 | Y4 | Y5 | Y6 | Y7, I1 & I2 & I3 & I4 & I5 & I6 & I7, unknown>;
+export {};
+//# sourceMappingURL=craft-pipe.d.ts.map

package/src/lib/craft-pipe.d.ts.map

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

package/src/lib/craft-pipe.js

@@ -0,0 +1,57 @@
+import { inject, Injector, isSignal, runInInjectionContext, } from './host/craft-compat';
+import { isGenerator } from './craft-generator-runtime';
+import { injectFnWrapper } from './fn-wrapper';
+import { ɵcreateHostTaggedInjector } from './craft-service';
+import { isSource } from './util/util';
+import { createYieldableInsertionMethod, isNonYieldableInsertionMethod, isYieldableMethod, } from './yieldable';
+import { isYieldableReactiveValue, nameInsertedReactiveValue, } from './reactive-read';
+export function* craftPipe(context, ...members) {
+    // This generator is driven by the primitive's craft-generator runtime,
+    // inside `runInInjectionContext(injector)`: inject() is available on the
+    // first synchronous segment. Capture the fn-wrapper adapter here so each
+    // member keeps its own wrapping (per-member observability), exactly like
+    // the primitives' own insertion loop.
+    const wrap = injectFnWrapper();
+    const injector = inject(Injector);
+    let acc = {};
+    let exposedAcc = {};
+    for (const member of members) {
+        const wrappedMember = wrap(member);
+        const result = wrappedMember({
+            ...context,
+            insertions: { ...(context.insertions ?? {}), ...exposedAcc },
+        });
+        const output = isGenerator(result)
+            ? yield* result
+            : result;
+        const rawOutput = output;
+        acc = { ...acc, ...rawOutput };
+        const nextExposed = Object.entries(rawOutput).reduce((previous, [key, value]) => {
+            if (isYieldableReactiveValue(value)) {
+                previous[key] = nameInsertedReactiveValue(value, key, 'craftPipe', `craftPipe.${key}`);
+                return previous;
+            }
+            if (isSource(value) || isSignal(value) || isYieldableMethod(value)) {
+                previous[key] = value;
+                return previous;
+            }
+            if (typeof value === 'function' &&
+                !isNonYieldableInsertionMethod(value)) {
+                const methodInjector = ɵcreateHostTaggedInjector(injector, `method:${key}`);
+                const wrappedFn = runInInjectionContext(methodInjector, () => injectFnWrapper()(value));
+                previous[key] = createYieldableInsertionMethod(wrappedFn, {
+                    injector: methodInjector,
+                    invalidYieldErrorMessage: 'craftPipe insertion method generators can only yield craftService dependencies or exposed dependency helpers.',
+                    multipleAppStartErrorMessage: 'craftPipe insertion methods do not support multiple onAppStart(...) declarations.',
+                    onAppStartNotSupportedErrorMessage: 'craftPipe insertion methods do not support onAppStart(...).',
+                });
+                return previous;
+            }
+            previous[key] = value;
+            return previous;
+        }, {});
+        exposedAcc = { ...exposedAcc, ...nextExposed };
+    }
+    return acc;
+}
+//# sourceMappingURL=craft-pipe.js.map

package/src/lib/craft-pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-pipe.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-pipe.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  inject,\n  Injector,\n  isSignal,\n  runInInjectionContext,\n} from './host/craft-compat';\nimport { isGenerator } from './craft-generator-runtime';\nimport { injectFnWrapper } from './fn-wrapper';\nimport { ɵcreateHostTaggedInjector } from './craft-service';\nimport { isSource } from './util/util';\nimport {\n  createYieldableInsertionMethod,\n  isNonYieldableInsertionMethod,\n  isYieldableMethod,\n  type YieldableInsertionMethods,\n} from './yieldable';\nimport {\n  isYieldableReactiveValue,\n  nameInsertedReactiveValue,\n} from './reactive-read';\n\n// `craftPipe` composes several insertions into ONE, with the primitive's\n// context passed EXPLICITLY: `primitive(config, (context) => craftPipe(context, m1, m2))`.\n//\n// Why explicit context: the outer lambda is context-sensitive, so the\n// primitive types `context` concretely BEFORE the pipe call is resolved, and\n// the pipe's `Ctx` generic infers from a VALUE argument. No per-primitive\n// alias, no conditional resource/by-id handling, and the pipe also works\n// INSIDE `insertSelect` (each level re-passes its own context) — none of\n// which the previous implicit dedicated pipes could do.\n//\n// In member parameter types, `Ctx` is wrapped in `NoInfer` so member\n// arguments (e.g. non-higher-order factories) can never pollute the context\n// inference; only the `context` argument is an inference source.\n\n// Primitives type `insertions` as `keyof P extends string ? P : never`;\n// normalize `never` (empty previous outputs) back to `{}` before merging.\ntype NormalizeIns<T> = [T] extends [never] ? {} : T;\ntype CtxWithIns<Ctx, I> = Omit<Ctx, 'insertions'> & {\n  insertions: YieldableInsertionMethods<I>;\n};\ntype MergedIns<Ctx extends { insertions?: any }, I> = NormalizeIns<\n  Ctx['insertions']\n> &\n  I;\n\n/**\n * Composes several insertions into a single one, for ANY primitive\n * (`query`, `mutation`, `asyncProcess`, `state`, `queryParams`) and for the\n * nested insertions of `insertSelect`.\n *\n * ```typescript\n * const users = yield* query(\n *   config,\n *   (context) =>\n *     craftPipe(\n *       context,\n *       insertStoragePersister(craftUnique({\n *         storeName: 'app',\n *         key: 'users',\n *       })),\n *       insertReactOnMutation(deleteUser, { ... }),\n *     ),\n * ));\n * ```\n *\n * Semantics are identical to passing the members directly:\n * - members run left to right,\n * - each member sees the previous members' outputs on `context.insertions`,\n * - the resulting outputs are the intersection of all members' outputs\n *   (on a key conflict the rightmost member wins at runtime),\n * - tracked dependencies (primitive generator yields, craft-service yields)\n *   are the union of all members',\n * - each member factory is individually wrapped with the fn-wrapper chain\n *   (correlation-id tracking, app snapshots observe each member).\n *\n * Inline lambdas keep the primitive's contextual typing because the outer\n * `(context) => craftPipe(context, ...)` lambda receives the concrete\n * context from the primitive. Pipes nest freely, including inside\n * `insertSelect`: `insertSelect('grid', (gridContext) => craftPipe(gridContext, ...))`.\n */\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  Y1 = never,\n  Y2 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n): Generator<Y1 | Y2, I1 & I2, unknown>;\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  I3,\n  Y1 = never,\n  Y2 = never,\n  Y3 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n  m3: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>,\n  ) => I3 | Generator<Y3, I3, unknown>,\n): Generator<Y1 | Y2 | Y3, I1 & I2 & I3, unknown>;\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  I3,\n  I4,\n  Y1 = never,\n  Y2 = never,\n  Y3 = never,\n  Y4 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n  m3: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>,\n  ) => I3 | Generator<Y3, I3, unknown>,\n  m4: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>,\n  ) => I4 | Generator<Y4, I4, unknown>,\n): Generator<Y1 | Y2 | Y3 | Y4, I1 & I2 & I3 & I4, unknown>;\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  I3,\n  I4,\n  I5,\n  Y1 = never,\n  Y2 = never,\n  Y3 = never,\n  Y4 = never,\n  Y5 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n  m3: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>,\n  ) => I3 | Generator<Y3, I3, unknown>,\n  m4: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>,\n  ) => I4 | Generator<Y4, I4, unknown>,\n  m5: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>\n    >,\n  ) => I5 | Generator<Y5, I5, unknown>,\n): Generator<Y1 | Y2 | Y3 | Y4 | Y5, I1 & I2 & I3 & I4 & I5, unknown>;\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  I3,\n  I4,\n  I5,\n  I6,\n  Y1 = never,\n  Y2 = never,\n  Y3 = never,\n  Y4 = never,\n  Y5 = never,\n  Y6 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n  m3: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>,\n  ) => I3 | Generator<Y3, I3, unknown>,\n  m4: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>,\n  ) => I4 | Generator<Y4, I4, unknown>,\n  m5: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>\n    >,\n  ) => I5 | Generator<Y5, I5, unknown>,\n  m6: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5>\n    >,\n  ) => I6 | Generator<Y6, I6, unknown>,\n): Generator<Y1 | Y2 | Y3 | Y4 | Y5 | Y6, I1 & I2 & I3 & I4 & I5 & I6, unknown>;\nexport function craftPipe<\n  Ctx extends { insertions?: any },\n  I1,\n  I2,\n  I3,\n  I4,\n  I5,\n  I6,\n  I7,\n  Y1 = never,\n  Y2 = never,\n  Y3 = never,\n  Y4 = never,\n  Y5 = never,\n  Y6 = never,\n  Y7 = never,\n>(\n  context: Ctx,\n  m1: (context: NoInfer<Ctx>) => I1 | Generator<Y1, I1, unknown>,\n  m2: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1>>,\n  ) => I2 | Generator<Y2, I2, unknown>,\n  m3: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2>>,\n  ) => I3 | Generator<Y3, I3, unknown>,\n  m4: (\n    context: CtxWithIns<NoInfer<Ctx>, MergedIns<NoInfer<Ctx>, I1 & I2 & I3>>,\n  ) => I4 | Generator<Y4, I4, unknown>,\n  m5: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4>\n    >,\n  ) => I5 | Generator<Y5, I5, unknown>,\n  m6: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5>\n    >,\n  ) => I6 | Generator<Y6, I6, unknown>,\n  m7: (\n    context: CtxWithIns<\n      NoInfer<Ctx>,\n      MergedIns<NoInfer<Ctx>, I1 & I2 & I3 & I4 & I5 & I6>\n    >,\n  ) => I7 | Generator<Y7, I7, unknown>,\n): Generator<\n  Y1 | Y2 | Y3 | Y4 | Y5 | Y6 | Y7,\n  I1 & I2 & I3 & I4 & I5 & I6 & I7,\n  unknown\n>;\nexport function* craftPipe(\n  context: { insertions?: Record<string, unknown> },\n  ...members: Array<(context: any) => unknown>\n): Generator<unknown, Record<string, unknown>, unknown> {\n  // This generator is driven by the primitive's craft-generator runtime,\n  // inside `runInInjectionContext(injector)`: inject() is available on the\n  // first synchronous segment. Capture the fn-wrapper adapter here so each\n  // member keeps its own wrapping (per-member observability), exactly like\n  // the primitives' own insertion loop.\n  const wrap = injectFnWrapper();\n  const injector = inject(Injector);\n  let acc: Record<string, unknown> = {};\n  let exposedAcc: Record<string, unknown> = {};\n  for (const member of members) {\n    const wrappedMember = wrap(member);\n    const result = wrappedMember({\n      ...context,\n      insertions: { ...(context.insertions ?? {}), ...exposedAcc },\n    });\n    const output = isGenerator(result)\n      ? yield* result as Generator<unknown, Record<string, unknown>, unknown>\n      : result;\n    const rawOutput = output as Record<string, unknown>;\n    acc = { ...acc, ...rawOutput };\n\n    const nextExposed = Object.entries(rawOutput).reduce(\n      (previous, [key, value]) => {\n        if (isYieldableReactiveValue(value)) {\n          previous[key] = nameInsertedReactiveValue(\n            value,\n            key,\n            'craftPipe',\n            `craftPipe.${key}`,\n          );\n          return previous;\n        }\n\n        if (isSource(value) || isSignal(value) || isYieldableMethod(value)) {\n          previous[key] = value;\n          return previous;\n        }\n\n        if (\n          typeof value === 'function' &&\n          !isNonYieldableInsertionMethod(value)\n        ) {\n          const methodInjector = ɵcreateHostTaggedInjector(\n            injector,\n            `method:${key}`,\n          );\n          const wrappedFn = runInInjectionContext(methodInjector, () =>\n            injectFnWrapper()(value as (...args: unknown[]) => unknown),\n          );\n          previous[key] = createYieldableInsertionMethod(wrappedFn, {\n            injector: methodInjector,\n            invalidYieldErrorMessage:\n              'craftPipe insertion method generators can only yield craftService dependencies or exposed dependency helpers.',\n            multipleAppStartErrorMessage:\n              'craftPipe insertion methods do not support multiple onAppStart(...) declarations.',\n            onAppStartNotSupportedErrorMessage:\n              'craftPipe insertion methods do not support onAppStart(...).',\n          });\n          return previous;\n        }\n\n        previous[key] = value;\n        return previous;\n      },\n      {} as Record<string, unknown>,\n    );\n    exposedAcc = { ...exposedAcc, ...nextExposed };\n  }\n  return acc;\n}\n"]}

package/src/lib/craft-platform.d.ts

@@ -0,0 +1,50 @@
+import { type CraftHistory } from './host/craft-router-runtime';
+import type { SsrMode } from './craft-ssr';
+export type CraftPlatformKind = 'browser' | 'server';
+export type CraftStorage = Pick<Storage, 'clear' | 'getItem' | 'key' | 'removeItem' | 'setItem'> & {
+    readonly length: number;
+};
+export type CraftPlatform = Readonly<{
+    kind: CraftPlatformKind;
+    /** True only during the first client pass over server-rendered DOM. */
+    hydrating: boolean;
+    document?: Document;
+    window?: Window;
+    history: CraftHistory;
+    localStorage: CraftStorage;
+    sessionStorage: CraftStorage;
+    requestSignal?: AbortSignal;
+    serverResources?: CraftServerResourceController;
+    now(): number;
+    randomUUID(): string;
+    listen(target: EventTarget, event: string, handler: EventListener): () => void;
+}>;
+export type CraftServerResourceController = Readonly<{
+    defer(source: string, start: () => void): void;
+    decide(source: string, mode: SsrMode): void;
+}>;
+export declare const CRAFT_PLATFORM: import("..").CraftToken<Readonly<{
+    kind: CraftPlatformKind;
+    /** True only during the first client pass over server-rendered DOM. */
+    hydrating: boolean;
+    document?: Document;
+    window?: Window;
+    history: CraftHistory;
+    localStorage: CraftStorage;
+    sessionStorage: CraftStorage;
+    requestSignal?: AbortSignal;
+    serverResources?: CraftServerResourceController;
+    now(): number;
+    randomUUID(): string;
+    listen(target: EventTarget, event: string, handler: EventListener): () => void;
+}>>;
+export declare function createMemoryStorage(): CraftStorage;
+export declare function createBrowserPlatform(win: Window, options?: Readonly<{
+    hydrating?: boolean;
+}>): CraftPlatform;
+export declare function createServerPlatform(options?: Readonly<{
+    url?: string;
+    document?: Document;
+    signal?: AbortSignal;
+}>): CraftPlatform;
+//# sourceMappingURL=craft-platform.d.ts.map

package/src/lib/craft-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-platform.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-platform.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,OAAO,EACP,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CACvD,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,iBAAiB,CAAC;IACxB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,YAAY,CAAC;IAC7B,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,eAAe,CAAC,EAAE,6BAA6B,CAAC;IAChD,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,IAAI,MAAM,CAAC;IACrB,MAAM,CACJ,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,MAAM,IAAI,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACnD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C,CAAC,CAAC;AAEH,eAAO,MAAM,cAAc;UAxBnB,iBAAiB;IACvB,uEAAuE;eAC5D,OAAO;eACP,QAAQ;aACV,MAAM;aACN,YAAY;kBACP,YAAY;oBACV,YAAY;oBACZ,WAAW;sBACT,6BAA6B;WACxC,MAAM;kBACC,MAAM;mBAEV,WAAW,SACZ,MAAM,WACJ,aAAa,GACrB,MAAM,IAAI;GAQyD,CAAC;AAEzE,wBAAgB,mBAAmB,IAAI,YAAY,CAYlD;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,QAAQ,CAAC;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAM,GAC9C,aAAa,CAgBf;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAM,GACN,aAAa,CA6Bf"}