@craft-ts/core 0.7.0-beta.13

package/src/lib/correlation-id-plugin.js

@@ -0,0 +1,73 @@
+import { inject, Injector, provideAppInitializer, runInInjectionContext, untracked, } from './host/craft-compat';
+import { CORRELATION_ID_SERVICE, createCorrelationIdService, getCurrentStartCorrelationId, setCurrentStartCorrelationId, } from './correlation-id';
+import { provideCraftDomEventHook, } from './dom-event-hook';
+import { SERVICE_YIELD_REQUEST_MARKER } from './craft-generator-runtime';
+import { provideFnWrapper } from './fn-wrapper';
+import { CRAFT_TEMPORAL_RUNTIME } from './temporal-runtime';
+const correlationIdDomEventHook = (interaction, next) => {
+    const service = inject(CORRELATION_ID_SERVICE);
+    service?.generateAndSet(interaction.interactionName);
+    return next();
+};
+const POPSTATE_COUNTER_KEY = '__craftTsNavCounter';
+function initPopstateTracking(injector) {
+    if (typeof window === 'undefined')
+        return;
+    // Initialize navigation counter in history state
+    const currentState = window.history.state ?? {};
+    const initialCounter = currentState[POPSTATE_COUNTER_KEY] ?? 0;
+    if (currentState[POPSTATE_COUNTER_KEY] === undefined) {
+        window.history.replaceState({ ...currentState, [POPSTATE_COUNTER_KEY]: initialCounter }, '');
+    }
+    let lastCounter = initialCounter;
+    window.addEventListener('popstate', (event) => {
+        const state = event.state ?? {};
+        const newCounter = state[POPSTATE_COUNTER_KEY] ?? 0;
+        runInInjectionContext(injector, () => {
+            const service = inject(CORRELATION_ID_SERVICE);
+            if (service) {
+                const prefix = newCounter > lastCounter ? 'nav-forward' : 'nav-back';
+                service.generateAndSet(prefix);
+            }
+        });
+        lastCounter = newCounter;
+    });
+}
+// FnWrapper that captures lastCorrelationId at generator invocation time
+const correlationIdFnWrapper = function* (factory, thisArg, args) {
+    const service = (yield {
+        [SERVICE_YIELD_REQUEST_MARKER]: true,
+        providedIn: 'function',
+        resolve: (injector) => injector.get(CORRELATION_ID_SERVICE, null),
+    });
+    // Untracked, and this is load-bearing: this wrapper runs inside EVERY craft
+    // factory execution, template bindings included, so a tracked read here
+    // subscribes every binding in the application to `lastCorrelationId`. The DOM
+    // event hook writes that signal on every interaction — so one click would
+    // invalidate every binding on the page, whatever its real dependencies.
+    // The correlation id is ambient observability metadata: it describes the
+    // computation, it is never an input to it.
+    const startCorrelationId = untracked(() => service?.lastCorrelationId()) ?? null;
+    const previousStartId = getCurrentStartCorrelationId();
+    setCurrentStartCorrelationId(startCorrelationId);
+    try {
+        return yield* factory.apply(thisArg, args);
+    }
+    finally {
+        setCurrentStartCorrelationId(previousStartId);
+    }
+};
+export function provideCorrelationIdTracking() {
+    return [
+        {
+            provide: CORRELATION_ID_SERVICE,
+            useFactory: () => createCorrelationIdService(inject(CRAFT_TEMPORAL_RUNTIME)),
+        },
+        provideCraftDomEventHook(correlationIdDomEventHook),
+        provideAppInitializer(() => {
+            initPopstateTracking(inject(Injector));
+        }),
+        provideFnWrapper('Warning: dependency injection here is not type-safe and may fail at runtime', correlationIdFnWrapper),
+    ];
+}
+//# sourceMappingURL=correlation-id-plugin.js.map

package/src/lib/correlation-id-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-id-plugin.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/correlation-id-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  inject,\n  Injector,\n  provideAppInitializer,\n  runInInjectionContext,\n  untracked,\n  type EnvironmentProviders,\n  type Provider,\n} from './host/craft-compat';\nimport {\n  CORRELATION_ID_SERVICE,\n  createCorrelationIdService,\n  getCurrentStartCorrelationId,\n  setCurrentStartCorrelationId,\n} from './correlation-id';\nimport {\n  provideCraftDomEventHook,\n  type CraftDomEventHook,\n} from './dom-event-hook';\nimport { SERVICE_YIELD_REQUEST_MARKER } from './craft-generator-runtime';\nimport { provideFnWrapper, type FnWrapper } from './fn-wrapper';\nimport { CRAFT_TEMPORAL_RUNTIME } from './temporal-runtime';\n\nconst correlationIdDomEventHook: CraftDomEventHook = (interaction, next) => {\n  const service = inject(CORRELATION_ID_SERVICE);\n  service?.generateAndSet(interaction.interactionName);\n  return next();\n};\n\nconst POPSTATE_COUNTER_KEY = '__craftTsNavCounter';\n\nfunction initPopstateTracking(injector: Injector): void {\n  if (typeof window === 'undefined') return;\n\n  // Initialize navigation counter in history state\n  const currentState = window.history.state ?? {};\n  const initialCounter = (currentState[POPSTATE_COUNTER_KEY] as number) ?? 0;\n  if (currentState[POPSTATE_COUNTER_KEY] === undefined) {\n    window.history.replaceState(\n      { ...currentState, [POPSTATE_COUNTER_KEY]: initialCounter },\n      '',\n    );\n  }\n\n  let lastCounter = initialCounter;\n\n  window.addEventListener('popstate', (event) => {\n    const state = event.state ?? {};\n    const newCounter = (state[POPSTATE_COUNTER_KEY] as number) ?? 0;\n\n    runInInjectionContext(injector, () => {\n      const service = inject(CORRELATION_ID_SERVICE);\n      if (service) {\n        const prefix = newCounter > lastCounter ? 'nav-forward' : 'nav-back';\n        service.generateAndSet(prefix);\n      }\n    });\n\n    lastCounter = newCounter;\n  });\n}\n\n// FnWrapper that captures lastCorrelationId at generator invocation time\nconst correlationIdFnWrapper: FnWrapper = function* (factory, thisArg, args) {\n  const service = (yield {\n    [SERVICE_YIELD_REQUEST_MARKER]: true,\n    providedIn: 'function' as const,\n    resolve: (injector: Injector) => injector.get(CORRELATION_ID_SERVICE, null),\n  }) as ReturnType<typeof createCorrelationIdService> | null;\n\n  // Untracked, and this is load-bearing: this wrapper runs inside EVERY craft\n  // factory execution, template bindings included, so a tracked read here\n  // subscribes every binding in the application to `lastCorrelationId`. The DOM\n  // event hook writes that signal on every interaction — so one click would\n  // invalidate every binding on the page, whatever its real dependencies.\n  // The correlation id is ambient observability metadata: it describes the\n  // computation, it is never an input to it.\n  const startCorrelationId =\n    untracked(() => service?.lastCorrelationId()) ?? null;\n  const previousStartId = getCurrentStartCorrelationId();\n  setCurrentStartCorrelationId(startCorrelationId);\n\n  try {\n    return yield* (\n      factory as (...a: unknown[]) => Generator<unknown, unknown, unknown>\n    ).apply(thisArg as object, args);\n  } finally {\n    setCurrentStartCorrelationId(previousStartId);\n  }\n};\n\nexport function provideCorrelationIdTracking(): (\n  | Provider\n  | EnvironmentProviders\n)[] {\n  return [\n    {\n      provide: CORRELATION_ID_SERVICE,\n      useFactory: () =>\n        createCorrelationIdService(inject(CRAFT_TEMPORAL_RUNTIME)),\n    },\n    provideCraftDomEventHook(correlationIdDomEventHook),\n    provideAppInitializer(() => {\n      initPopstateTracking(inject(Injector));\n    }),\n    provideFnWrapper(\n      'Warning: dependency injection here is not type-safe and may fail at runtime',\n      correlationIdFnWrapper,\n    ),\n  ];\n}\n"]}

package/src/lib/correlation-id.d.ts

@@ -0,0 +1,30 @@
+import { Injector, InjectionToken, type Signal } from './host/craft-compat';
+import { SERVICE_YIELD_REQUEST_MARKER } from './craft-generator-runtime';
+import type { ConcreteServiceScope } from './craft-service.shared';
+import { type CraftTemporalRuntime } from './temporal-runtime';
+/** A human-readable prefix describing the operation that started a flow. */
+export type CorrelationIdPrefix = 'click' | 'enter' | 'nav-back' | 'nav-forward' | (string & {});
+export interface CorrelationIdMetadata {
+    lastCorrelationId: string | null;
+    mayCorrelatedIds: readonly string[];
+    startCorrelationId: string | null;
+}
+export interface CorrelationIdServiceApi {
+    readonly lastCorrelationId: Signal<string | null>;
+    readonly mayCorrelatedIds: Signal<readonly string[]>;
+    generateAndSet(prefix: CorrelationIdPrefix): string;
+    startOperation(id: string): void;
+    endOperation(id: string): void;
+}
+export declare const CORRELATION_ID_SERVICE: InjectionToken<CorrelationIdServiceApi | null>;
+export declare function createCorrelationIdService(temporalRuntime?: CraftTemporalRuntime): CorrelationIdServiceApi;
+export declare function setCurrentStartCorrelationId(id: string | null): void;
+export declare function getCurrentStartCorrelationId(): string | null;
+export type CorrelationIdYield = Readonly<{
+    [SERVICE_YIELD_REQUEST_MARKER]: true;
+    providedIn: 'function';
+    resolve: (injector: Injector, hostScope: ConcreteServiceScope) => CorrelationIdMetadata;
+}>;
+export declare function CorrelationId(): Generator<CorrelationIdYield, CorrelationIdMetadata, unknown>;
+export declare function injectCorrelationIdService(): CorrelationIdServiceApi | null;
+//# sourceMappingURL=correlation-id.d.ts.map

package/src/lib/correlation-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-id.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/correlation-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,QAAQ,EACR,cAAc,EAGd,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAE5B,4EAA4E;AAC5E,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,OAAO,GACP,UAAU,GACV,aAAa,GACb,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACrD,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC;IACpD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,sBAAsB,gDAI/B,CAAC;AAEL,wBAAgB,0BAA0B,CACxC,eAAe,CAAC,EAAE,oBAAoB,GACrC,uBAAuB,CAgDzB;AAcD,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAE5D;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,CAAC,4BAA4B,CAAC,EAAE,IAAI,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,CACP,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,oBAAoB,KAC5B,qBAAqB,CAAC;CAC5B,CAAC,CAAC;AAEH,wBAAiB,aAAa,IAAI,SAAS,CACzC,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,CACR,CAiBA;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,GAAG,IAAI,CAE3E"}

package/src/lib/correlation-id.js

@@ -0,0 +1,86 @@
+import { computed, inject, InjectionToken, signal, untracked, } from './host/craft-compat';
+import { SERVICE_YIELD_REQUEST_MARKER } from './craft-generator-runtime';
+import { RealCraftTemporalRuntime, } from './temporal-runtime';
+export const CORRELATION_ID_SERVICE = new InjectionToken('CORRELATION_ID_SERVICE', {
+    providedIn: 'root',
+    factory: () => null,
+});
+export function createCorrelationIdService(temporalRuntime) {
+    const _lastCorrelationId = signal(null);
+    const _inFlightIds = signal(new Set());
+    const _mayCorrelatedIds = computed(() => [..._inFlightIds()]);
+    const runtime = temporalRuntime ?? new RealCraftTemporalRuntime();
+    const _debounceTimers = new Map();
+    function generateAndSet(prefix) {
+        const id = `${prefix}:${generateUUID()}`;
+        _lastCorrelationId.set(id);
+        return id;
+    }
+    function startOperation(id) {
+        const existingTimer = _debounceTimers.get(id);
+        if (existingTimer !== undefined) {
+            existingTimer.cancel();
+            _debounceTimers.delete(id);
+        }
+        _inFlightIds.update((s) => new Set([...s, id]));
+    }
+    function endOperation(id) {
+        const timer = runtime.schedule(() => {
+            _debounceTimers.delete(id);
+            _inFlightIds.update((s) => {
+                const next = new Set(s);
+                next.delete(id);
+                return next;
+            });
+        }, 500, {
+            kind: 'debounce',
+            owner: `correlation:${id}`,
+        });
+        _debounceTimers.set(id, timer);
+    }
+    return {
+        lastCorrelationId: _lastCorrelationId.asReadonly(),
+        mayCorrelatedIds: _mayCorrelatedIds,
+        generateAndSet,
+        startOperation,
+        endOperation,
+    };
+}
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return Math.random().toString(36).slice(2) + Date.now().toString(36);
+}
+// Module-level variable tracking startCorrelationId within a generator execution.
+// JavaScript is single-threaded: safe to use as a call-stack variable.
+// Set by the CorrelationId FnWrapper before the generator runs, reset after.
+let _currentStartCorrelationId = null;
+export function setCurrentStartCorrelationId(id) {
+    _currentStartCorrelationId = id;
+}
+export function getCurrentStartCorrelationId() {
+    return _currentStartCorrelationId;
+}
+export function* CorrelationId() {
+    return (yield {
+        [SERVICE_YIELD_REQUEST_MARKER]: true,
+        providedIn: 'function',
+        resolve: (injector) => {
+            const service = injector.get(CORRELATION_ID_SERVICE, null);
+            // Untracked for the same reason as the correlation-id fn wrapper: this
+            // metadata is read from inside whatever computation is logging, and it
+            // changes on every interaction. Tracking it would make every logging
+            // caller depend on the id of the flow it happens to run in.
+            return untracked(() => ({
+                lastCorrelationId: service?.lastCorrelationId() ?? null,
+                mayCorrelatedIds: service?.mayCorrelatedIds() ?? [],
+                startCorrelationId: _currentStartCorrelationId,
+            }));
+        },
+    });
+}
+export function injectCorrelationIdService() {
+    return inject(CORRELATION_ID_SERVICE);
+}
+//# sourceMappingURL=correlation-id.js.map

package/src/lib/correlation-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-id.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/correlation-id.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  computed,\n  inject,\n  Injector,\n  InjectionToken,\n  signal,\n  untracked,\n  type Signal,\n} from './host/craft-compat';\nimport { SERVICE_YIELD_REQUEST_MARKER } from './craft-generator-runtime';\nimport type { ConcreteServiceScope } from './craft-service.shared';\nimport {\n  RealCraftTemporalRuntime,\n  type CraftTemporalRuntime,\n  type TemporalTaskHandle,\n} from './temporal-runtime';\n\n/** A human-readable prefix describing the operation that started a flow. */\nexport type CorrelationIdPrefix =\n  | 'click'\n  | 'enter'\n  | 'nav-back'\n  | 'nav-forward'\n  | (string & {});\n\nexport interface CorrelationIdMetadata {\n  lastCorrelationId: string | null;\n  mayCorrelatedIds: readonly string[];\n  startCorrelationId: string | null;\n}\n\nexport interface CorrelationIdServiceApi {\n  readonly lastCorrelationId: Signal<string | null>;\n  readonly mayCorrelatedIds: Signal<readonly string[]>;\n  generateAndSet(prefix: CorrelationIdPrefix): string;\n  startOperation(id: string): void;\n  endOperation(id: string): void;\n}\n\nexport const CORRELATION_ID_SERVICE =\n  new InjectionToken<CorrelationIdServiceApi | null>('CORRELATION_ID_SERVICE', {\n    providedIn: 'root',\n    factory: () => null,\n  });\n\nexport function createCorrelationIdService(\n  temporalRuntime?: CraftTemporalRuntime,\n): CorrelationIdServiceApi {\n  const _lastCorrelationId = signal<string | null>(null);\n  const _inFlightIds = signal<ReadonlySet<string>>(new Set());\n  const _mayCorrelatedIds = computed(() => [..._inFlightIds()]);\n  const runtime = temporalRuntime ?? new RealCraftTemporalRuntime();\n  const _debounceTimers = new Map<string, TemporalTaskHandle>();\n\n  function generateAndSet(prefix: CorrelationIdPrefix): string {\n    const id = `${prefix}:${generateUUID()}`;\n    _lastCorrelationId.set(id);\n    return id;\n  }\n\n  function startOperation(id: string): void {\n    const existingTimer = _debounceTimers.get(id);\n    if (existingTimer !== undefined) {\n      existingTimer.cancel();\n      _debounceTimers.delete(id);\n    }\n    _inFlightIds.update((s) => new Set([...s, id]));\n  }\n\n  function endOperation(id: string): void {\n    const timer = runtime.schedule(\n      () => {\n        _debounceTimers.delete(id);\n        _inFlightIds.update((s) => {\n          const next = new Set(s);\n          next.delete(id);\n          return next;\n        });\n      },\n      500,\n      {\n        kind: 'debounce',\n        owner: `correlation:${id}`,\n      },\n    );\n    _debounceTimers.set(id, timer);\n  }\n\n  return {\n    lastCorrelationId: _lastCorrelationId.asReadonly(),\n    mayCorrelatedIds: _mayCorrelatedIds,\n    generateAndSet,\n    startOperation,\n    endOperation,\n  };\n}\n\nfunction generateUUID(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n  return Math.random().toString(36).slice(2) + Date.now().toString(36);\n}\n\n// Module-level variable tracking startCorrelationId within a generator execution.\n// JavaScript is single-threaded: safe to use as a call-stack variable.\n// Set by the CorrelationId FnWrapper before the generator runs, reset after.\nlet _currentStartCorrelationId: string | null = null;\n\nexport function setCurrentStartCorrelationId(id: string | null): void {\n  _currentStartCorrelationId = id;\n}\n\nexport function getCurrentStartCorrelationId(): string | null {\n  return _currentStartCorrelationId;\n}\n\nexport type CorrelationIdYield = Readonly<{\n  [SERVICE_YIELD_REQUEST_MARKER]: true;\n  providedIn: 'function';\n  resolve: (\n    injector: Injector,\n    hostScope: ConcreteServiceScope,\n  ) => CorrelationIdMetadata;\n}>;\n\nexport function* CorrelationId(): Generator<\n  CorrelationIdYield,\n  CorrelationIdMetadata,\n  unknown\n> {\n  return (yield {\n    [SERVICE_YIELD_REQUEST_MARKER]: true,\n    providedIn: 'function' as const,\n    resolve: (injector: Injector) => {\n      const service = injector.get(CORRELATION_ID_SERVICE, null);\n      // Untracked for the same reason as the correlation-id fn wrapper: this\n      // metadata is read from inside whatever computation is logging, and it\n      // changes on every interaction. Tracking it would make every logging\n      // caller depend on the id of the flow it happens to run in.\n      return untracked(() => ({\n        lastCorrelationId: service?.lastCorrelationId() ?? null,\n        mayCorrelatedIds: service?.mayCorrelatedIds() ?? [],\n        startCorrelationId: _currentStartCorrelationId,\n      }));\n    },\n  }) as CorrelationIdMetadata;\n}\n\nexport function injectCorrelationIdService(): CorrelationIdServiceApi | null {\n  return inject(CORRELATION_ID_SERVICE);\n}\n"]}

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

@@ -0,0 +1,22 @@
+import { InjectionToken } from './host/craft-compat';
+import { TitleStrategy } from './host/craft-router-types';
+import { type CraftLoadingFeature } from './craft-pending';
+/**
+ * When true, {@link CraftRouterOutletController} moves keyboard focus to
+ * `#main` / `<main>` after a completed navigation (not the initial load).
+ */
+export declare const CRAFT_A11Y_NAVIGATION_FOCUS: InjectionToken<boolean>;
+/**
+ * Opt-in: after each in-app navigation, focus the page `<main>` so keyboard
+ * and screen-reader users are not left on the previous link. Pair with a
+ * skip link (`skipLink()`) and `main({ id: 'main' })`.
+ */
+export declare function withA11yNavigationFocus(): CraftLoadingFeature;
+/**
+ * Binds Angular route `title` to `BrowserDocument.setTitle`. Registered by
+ * default from {@link provideCraftRouter}.
+ */
+export type CraftTitleStrategy = TitleStrategy;
+export declare const CRAFT_TITLE_STRATEGY: import("..").CraftToken<TitleStrategy>;
+export declare function createCraftTitleStrategy(): CraftTitleStrategy;
+//# sourceMappingURL=craft-a11y.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-a11y.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-a11y.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA4B,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGhF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,yBAGvC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,mBAAmB,CAI7D;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAE/C,eAAO,MAAM,oBAAoB,wCACqB,CAAC;AAEvD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAS7D"}

package/src/lib/craft-a11y.js

@@ -0,0 +1,32 @@
+import { InjectionToken } from './host/craft-compat';
+import { TitleStrategy } from './host/craft-router-types';
+import { ɵapplyBrowserDocumentTitle } from './browser-boundaries';
+import { craftLoadingFeature } from './craft-pending';
+import { craftToken } from './host/craft-injector';
+/**
+ * When true, {@link CraftRouterOutletController} moves keyboard focus to
+ * `#main` / `<main>` after a completed navigation (not the initial load).
+ */
+export const CRAFT_A11Y_NAVIGATION_FOCUS = new InjectionToken('CRAFT_A11Y_NAVIGATION_FOCUS', { providedIn: 'root', factory: () => false });
+/**
+ * Opt-in: after each in-app navigation, focus the page `<main>` so keyboard
+ * and screen-reader users are not left on the previous link. Pair with a
+ * skip link (`skipLink()`) and `main({ id: 'main' })`.
+ */
+export function withA11yNavigationFocus() {
+    return craftLoadingFeature([
+        { provide: CRAFT_A11Y_NAVIGATION_FOCUS, useValue: true },
+    ]);
+}
+export const CRAFT_TITLE_STRATEGY = craftToken('CraftTitleStrategy');
+export function createCraftTitleStrategy() {
+    return new (class extends TitleStrategy {
+        updateTitle(snapshot) {
+            const title = this.buildTitle(snapshot);
+            if (title !== undefined) {
+                ɵapplyBrowserDocumentTitle(title);
+            }
+        }
+    })();
+}
+//# sourceMappingURL=craft-a11y.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-a11y.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-a11y.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA4B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAA4B,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,cAAc,CAC3D,6BAA6B,EAC7B,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,mBAAmB,CAAC;QACzB,EAAE,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE;KACzD,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,CAAC,MAAM,oBAAoB,GAC/B,UAAU,CAAqB,oBAAoB,CAAC,CAAC;AAEvD,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,CAAC,KAAM,SAAQ,aAAa;QAC5B,WAAW,CAAC,QAA6B;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,0BAA0B,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;KACF,CAAC,EAAE,CAAC;AACP,CAAC","sourcesContent":["import { InjectionToken } from './host/craft-compat';\nimport { TitleStrategy, type RouterStateSnapshot } from './host/craft-router-types';\nimport { ɵapplyBrowserDocumentTitle } from './browser-boundaries';\nimport { craftLoadingFeature, type CraftLoadingFeature } from './craft-pending';\nimport { craftToken } from './host/craft-injector';\n\n/**\n * When true, {@link CraftRouterOutletController} moves keyboard focus to\n * `#main` / `<main>` after a completed navigation (not the initial load).\n */\nexport const CRAFT_A11Y_NAVIGATION_FOCUS = new InjectionToken<boolean>(\n  'CRAFT_A11Y_NAVIGATION_FOCUS',\n  { providedIn: 'root', factory: () => false },\n);\n\n/**\n * Opt-in: after each in-app navigation, focus the page `<main>` so keyboard\n * and screen-reader users are not left on the previous link. Pair with a\n * skip link (`skipLink()`) and `main({ id: 'main' })`.\n */\nexport function withA11yNavigationFocus(): CraftLoadingFeature {\n  return craftLoadingFeature([\n    { provide: CRAFT_A11Y_NAVIGATION_FOCUS, useValue: true },\n  ]);\n}\n\n/**\n * Binds Angular route `title` to `BrowserDocument.setTitle`. Registered by\n * default from {@link provideCraftRouter}.\n */\nexport type CraftTitleStrategy = TitleStrategy;\n\nexport const CRAFT_TITLE_STRATEGY =\n  craftToken<CraftTitleStrategy>('CraftTitleStrategy');\n\nexport function createCraftTitleStrategy(): CraftTitleStrategy {\n  return new (class extends TitleStrategy {\n    override updateTitle(snapshot: RouterStateSnapshot): void {\n      const title = this.buildTitle(snapshot);\n      if (title !== undefined) {\n        ɵapplyBrowserDocumentTitle(title);\n      }\n    }\n  })();\n}\n"]}

package/src/lib/craft-activated-route.d.ts

@@ -0,0 +1,21 @@
+import { ActivatedRoute } from './host/craft-router-types';
+import { type SERVICE_HELPER_DEPENDENCIES, type ServiceYieldRequest, type ServiceTrackingMetadata } from './craft-service';
+type CraftActivatedRouteTrackingMetadata = ServiceTrackingMetadata<'CraftActivatedRoute', 'global', ActivatedRoute, never, undefined, never, false>;
+type CraftActivatedRouteTrackedHelper = {
+    readonly [SERVICE_HELPER_DEPENDENCIES]?: CraftActivatedRouteTrackingMetadata;
+};
+type CraftActivatedRouteYieldRequest = ServiceYieldRequest<'global', ActivatedRoute, CraftActivatedRouteTrackingMetadata>;
+type CraftActivatedRouteHelper = CraftActivatedRouteTrackedHelper & {
+    (): Generator<CraftActivatedRouteYieldRequest, ActivatedRoute, unknown>;
+};
+/**
+ * Yields the current Angular `ActivatedRoute` through the Craft service
+ * dependency system.
+ *
+ * ```ts
+ * const activatedRoute = yield* CraftActivatedRoute();
+ * ```
+ */
+export declare const CraftActivatedRoute: CraftActivatedRouteHelper;
+export {};
+//# sourceMappingURL=craft-activated-route.d.ts.map

package/src/lib/craft-activated-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-activated-route.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-activated-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,KAAK,mCAAmC,GAAG,uBAAuB,CAChE,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,KAAK,EACL,SAAS,EACT,KAAK,EACL,KAAK,CACN,CAAC;AAEF,KAAK,gCAAgC,GAAG;IACtC,QAAQ,CAAC,CAAC,2BAA2B,CAAC,CAAC,EAAE,mCAAmC,CAAC;CAC9E,CAAC;AAEF,KAAK,+BAA+B,GAAG,mBAAmB,CACxD,QAAQ,EACR,cAAc,EACd,mCAAmC,CACpC,CAAC;AAEF,KAAK,yBAAyB,GAAG,gCAAgC,GAAG;IAClE,IAAI,SAAS,CAAC,+BAA+B,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;CACzE,CAAC;AAaF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,2BACgB,CAAC"}

package/src/lib/craft-activated-route.js

@@ -0,0 +1,20 @@
+import { ActivatedRoute } from './host/craft-router-types';
+import { ɵtoCraftService as toCraftService, } from './craft-service';
+// Keep the internal `toCraftService` type out of the public declaration. Its
+// runtime helper contains private symbol markers that TypeScript cannot emit
+// from this package boundary.
+const craftActivatedRouteService = toCraftService({
+    name: 'CraftActivatedRoute',
+    providedIn: 'global',
+    token: ActivatedRoute,
+});
+/**
+ * Yields the current Angular `ActivatedRoute` through the Craft service
+ * dependency system.
+ *
+ * ```ts
+ * const activatedRoute = yield* CraftActivatedRoute();
+ * ```
+ */
+export const CraftActivatedRoute = craftActivatedRouteService.CraftActivatedRoute;
+//# sourceMappingURL=craft-activated-route.js.map

package/src/lib/craft-activated-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-activated-route.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-activated-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EACL,eAAe,IAAI,cAAc,GAIlC,MAAM,iBAAiB,CAAC;AA0BzB,6EAA6E;AAC7E,6EAA6E;AAC7E,8BAA8B;AAC9B,MAAM,0BAA0B,GAAG,cAAc,CAAC;IAChD,IAAI,EAAE,qBAAqB;IAC3B,UAAU,EAAE,QAAQ;IACpB,KAAK,EAAE,cAAc;CACtB,CAEA,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,0BAA0B,CAAC,mBAAmB,CAAC","sourcesContent":["import { ActivatedRoute } from './host/craft-router-types';\nimport {\n  ɵtoCraftService as toCraftService,\n  type SERVICE_HELPER_DEPENDENCIES,\n  type ServiceYieldRequest,\n  type ServiceTrackingMetadata,\n} from './craft-service';\n\ntype CraftActivatedRouteTrackingMetadata = ServiceTrackingMetadata<\n  'CraftActivatedRoute',\n  'global',\n  ActivatedRoute,\n  never,\n  undefined,\n  never,\n  false\n>;\n\ntype CraftActivatedRouteTrackedHelper = {\n  readonly [SERVICE_HELPER_DEPENDENCIES]?: CraftActivatedRouteTrackingMetadata;\n};\n\ntype CraftActivatedRouteYieldRequest = ServiceYieldRequest<\n  'global',\n  ActivatedRoute,\n  CraftActivatedRouteTrackingMetadata\n>;\n\ntype CraftActivatedRouteHelper = CraftActivatedRouteTrackedHelper & {\n  (): Generator<CraftActivatedRouteYieldRequest, ActivatedRoute, unknown>;\n};\n\n// Keep the internal `toCraftService` type out of the public declaration. Its\n// runtime helper contains private symbol markers that TypeScript cannot emit\n// from this package boundary.\nconst craftActivatedRouteService = toCraftService({\n  name: 'CraftActivatedRoute',\n  providedIn: 'global',\n  token: ActivatedRoute,\n}) as unknown as {\n  CraftActivatedRoute: CraftActivatedRouteHelper;\n};\n\n/**\n * Yields the current Angular `ActivatedRoute` through the Craft service\n * dependency system.\n *\n * ```ts\n * const activatedRoute = yield* CraftActivatedRoute();\n * ```\n */\nexport const CraftActivatedRoute =\n  craftActivatedRouteService.CraftActivatedRoute;\n"]}

package/src/lib/craft-app-config.d.ts

@@ -0,0 +1,91 @@
+import { type ApplicationConfig } from './host/craft-compat';
+import type { MissingProvidersFromDepsMap } from './branded-component/branded-component';
+import { type NamedBrandedServiceProvider, type GetServiceReferenceMeta, type ServiceReference } from './craft-service';
+import { type Simplify } from './craft-service.shared';
+type AngularApplicationProvider = ApplicationConfig['providers'][number] | object;
+type AngularApplicationProviders = readonly AngularApplicationProvider[];
+export type AppConfigProvidedServiceNamesKey = '__craftAppProvidedServiceNames__';
+export type AppConfigProvidedDependencyValuesKey = '__craftAppProvidedDependencyValues__';
+export interface CraftAppStartRegistry {
+}
+type DepsMap<Input> = Input extends {
+    deps: infer Deps extends object;
+} ? Deps : {};
+type ProvidedMap<Input> = Input extends {
+    provided: infer Provided extends object;
+} ? Provided : {};
+type ExplicitMissingProviderMap<Input> = Input extends {
+    missingProvider: infer MissingProvider extends object;
+} ? MissingProvider : {};
+type IsAny<Input> = 0 extends 1 & Input ? true : false;
+type AppProvidedServiceNamesFromEntry<Entry> = IsAny<Entry> extends true ? never : Entry extends NamedBrandedServiceProvider<infer Name, any, any> ? Name : Entry extends readonly unknown[] ? AppProvidedServiceNames<Entry> : never;
+type KnownProvidedDependencyValue<Value> = [unknown] extends [Value] ? never : Value;
+type AppProvidedDependencyValuesFromEntry<Entry> = IsAny<Entry> extends true ? never : Entry extends NamedBrandedServiceProvider<any, any, infer Output> ? KnownProvidedDependencyValue<Output> : Entry extends readonly unknown[] ? AppProvidedDependencyValues<Entry> : never;
+type AppProvidedServiceNames<Providers> = Providers extends readonly unknown[] ? AppProvidedServiceNamesFromEntry<Providers[number]> : never;
+type AppProvidedDependencyValues<Providers> = Providers extends readonly unknown[] ? AppProvidedDependencyValuesFromEntry<Providers[number]> : never;
+type AppProvidedValueKeys<MissingProviders extends object, ProvidedValues> = {
+    [Name in Extract<keyof MissingProviders, string>]: MissingProviders[Name] extends ProvidedValues ? Name : never;
+}[Extract<keyof MissingProviders, string>];
+type CraftAppStartRegistryKeys = Extract<keyof CraftAppStartRegistry, string>;
+type RequireCraftAppStartConfig = [CraftAppStartRegistryKeys] extends [never] ? {} : {
+    appStart: CraftAppStartRegistry;
+};
+type InvalidCraftAppStartRegistryEntries = Extract<{
+    [Tag in CraftAppStartRegistryKeys]: CraftAppStartRegistry[Tag] extends ServiceReference ? GetServiceReferenceMeta<CraftAppStartRegistry[Tag]> extends {
+        appStart: true;
+    } ? never : Tag : Tag;
+}[CraftAppStartRegistryKeys], string>;
+type AssertValidCraftAppStartRegistry = [
+    InvalidCraftAppStartRegistryEntries
+] extends [never] ? {} : {
+    ERROR_invalid_craft_app_start_registry: InvalidCraftAppStartRegistryEntries;
+};
+type RegisteredAppStartServiceNames = {
+    [Tag in CraftAppStartRegistryKeys]: CraftAppStartRegistry[Tag] extends ServiceReference ? Extract<GetServiceReferenceMeta<CraftAppStartRegistry[Tag]>['name'], string> : never;
+}[CraftAppStartRegistryKeys];
+type ConfigProvidedServiceNames<Providers> = AppProvidedServiceNames<Providers> | RegisteredAppStartServiceNames;
+type StripProvidedDependency<Dependency, ProvidedNames extends string> = Dependency extends {
+    dependencies: infer Dependencies extends object;
+} ? Simplify<Omit<Dependency, 'dependencies'> & {
+    dependencies: StripProvidedDepsMap<Dependencies, ProvidedNames>;
+}> : Dependency;
+type StripProvidedDepsMap<Deps extends object, ProvidedNames extends string> = Simplify<Omit<{
+    [Name in Extract<keyof Deps, string>]: StripProvidedDependency<Deps[Name], ProvidedNames>;
+}, ProvidedNames>>;
+type ResolvedRouteDepsMap<RouteMetaData, Providers> = StripProvidedDepsMap<DepsMap<RouteMetaData>, ConfigProvidedServiceNames<Providers>>;
+type RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers> = Simplify<MissingProvidersFromDepsMap<ResolvedRouteDepsMap<RouteMetaData, Providers>> & ExplicitMissingProviderMap<RouteMetaData>>;
+type ResolvedRouteMissingProviders<RouteMetaData, Providers> = Simplify<Omit<RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers>, keyof ProvidedMap<RouteMetaData> | ConfigProvidedServiceNames<Providers> | AppProvidedValueKeys<RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers>, AppProvidedDependencyValues<Providers>>>>;
+type ResolveCraftAppRouteMetaData<RouteMetaData, Providers> = Simplify<Omit<RouteMetaData, 'deps' | 'missingProvider'> & (RouteMetaData extends {
+    deps: object;
+} ? {
+    deps: ResolvedRouteDepsMap<RouteMetaData, Providers>;
+} : {}) & ([keyof ResolvedRouteMissingProviders<RouteMetaData, Providers>] extends [
+    never
+] ? {} : {
+    missingProvider: ResolvedRouteMissingProviders<RouteMetaData, Providers>;
+})>;
+export type CraftAppConfigMetaData<RoutingDeps extends readonly unknown[], Providers extends AngularApplicationProviders = readonly AngularApplicationProvider[]> = {
+    [Index in keyof RoutingDeps]: ResolveCraftAppRouteMetaData<RoutingDeps[Index], Providers>;
+} & {
+    readonly __craftAppProvidedServiceNames__?: ConfigProvidedServiceNames<Providers>;
+    readonly __craftAppProvidedDependencyValues__?: AppProvidedDependencyValues<Providers>;
+};
+export type CraftAppConfigResult<RoutingDeps extends readonly unknown[], Providers extends AngularApplicationProviders = readonly AngularApplicationProvider[]> = {
+    readonly providers: readonly AngularApplicationProvider[];
+    readonly APP_CONFIG_META_DATA: CraftAppConfigMetaData<RoutingDeps, Providers>;
+    /** @internal phantom — lets `AppProvidedServiceNamesOf` skip `APP_CONFIG_META_DATA` */
+    readonly __craftAppProvidedServiceNames__?: ConfigProvidedServiceNames<Providers>;
+    /** @internal phantom — lets `AppProvidedDependencyValuesOf` skip `APP_CONFIG_META_DATA` */
+    readonly __craftAppProvidedDependencyValues__?: AppProvidedDependencyValues<Providers>;
+};
+export declare function craftAppConfig<const RoutingDeps extends readonly unknown[]>(config: {
+    routingDeps: RoutingDeps;
+} & AssertValidCraftAppStartRegistry & RequireCraftAppStartConfig): CraftAppConfigResult<RoutingDeps, readonly []>;
+export declare function craftAppConfig<const RoutingDeps extends readonly unknown[], const Providers extends AngularApplicationProviders>(config: {
+    routingDeps: RoutingDeps;
+    providers: Providers;
+} & AssertValidCraftAppStartRegistry & RequireCraftAppStartConfig): CraftAppConfigResult<RoutingDeps, Providers>;
+/** Returns a fresh host application config containing the Craft providers. */
+export declare function toApplicationConfig(config: Pick<CraftAppConfigResult<readonly unknown[]>, 'providers'>): ApplicationConfig;
+export {};
+//# sourceMappingURL=craft-app-config.d.ts.map

package/src/lib/craft-app-config.d.ts.map

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

package/src/lib/craft-app-config.js

@@ -0,0 +1,64 @@
+import { getCraftRootDefaultProviders, provideAppInitializer } from './host/craft-compat';
+import { getRegisteredAppStartServices, getServiceMetaData, runServiceAppStart, } from './craft-service';
+import { CRAFT_SERVICE_PROVIDER_BRAND, } from './craft-service.shared';
+export function craftAppConfig(config) {
+    const providers = [
+        ...getCraftRootDefaultProviders(),
+        ...(config.providers ?? []),
+    ];
+    const providerNames = collectProvidedServiceNames(providers);
+    for (const reference of getRegisteredAppStartServices()) {
+        const metaData = getServiceMetaData(reference);
+        if (metaData.appStart !== true) {
+            throw new Error(`craftAppConfig found craftService "${metaData.name}" registered as appStart without appStart: true.`);
+        }
+        if (Reflect.get(metaData, 'usesProvidedInput') === true &&
+            (metaData.providedIn === 'toProvide' ||
+                metaData.providedIn === 'manuallyProvidedAtRoot')) {
+            throw new Error(`craftAppConfig cannot auto-provide appStart service "${metaData.name}" because provide${metaData.name}(...) requires arguments.`);
+        }
+        if ((metaData.providedIn === 'toProvide' ||
+            metaData.providedIn === 'manuallyProvidedAtRoot') &&
+            typeof metaData.provide === 'function' &&
+            !providerNames.has(metaData.name)) {
+            providers.push(metaData.provide());
+            providerNames.add(metaData.name);
+        }
+        providers.push(provideAppInitializer(() => {
+            const serviceValue = metaData.inject();
+            return runServiceAppStart(reference, serviceValue);
+        }));
+    }
+    return {
+        providers,
+        APP_CONFIG_META_DATA: config.routingDeps,
+    };
+}
+/** Returns a fresh host application config containing the Craft providers. */
+export function toApplicationConfig(config) {
+    return {
+        providers: [...config.providers],
+    };
+}
+function collectProvidedServiceNames(values, names = new Set()) {
+    for (const value of values) {
+        collectProvidedServiceNamesFromValue(value, names);
+    }
+    return names;
+}
+function collectProvidedServiceNamesFromValue(value, names) {
+    if (typeof value === 'object' &&
+        value !== null &&
+        CRAFT_SERVICE_PROVIDER_BRAND in value) {
+        const metaData = Reflect.get(value, CRAFT_SERVICE_PROVIDER_BRAND);
+        if (metaData?.name) {
+            names.add(metaData.name);
+        }
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            collectProvidedServiceNamesFromValue(entry, names);
+        }
+    }
+}
+//# sourceMappingURL=craft-app-config.js.map

package/src/lib/craft-app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-app-config.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-app-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { getCraftRootDefaultProviders, provideAppInitializer, type ApplicationConfig } from './host/craft-compat';\nimport type { MissingProvidersFromDepsMap } from './branded-component/branded-component';\nimport {\n  getRegisteredAppStartServices,\n  getServiceMetaData,\n  runServiceAppStart,\n  type NamedBrandedServiceProvider,\n  type GetServiceReferenceMeta,\n  type ServiceReference,\n} from './craft-service';\nimport {\n  CRAFT_SERVICE_PROVIDER_BRAND,\n  type Simplify,\n} from './craft-service.shared';\n\ntype AngularApplicationProvider = ApplicationConfig['providers'][number] | object;\ntype AngularApplicationProviders = readonly AngularApplicationProvider[];\nexport type AppConfigProvidedServiceNamesKey =\n  '__craftAppProvidedServiceNames__';\nexport type AppConfigProvidedDependencyValuesKey =\n  '__craftAppProvidedDependencyValues__';\n\nexport interface CraftAppStartRegistry {}\n\ntype DepsMap<Input> = Input extends { deps: infer Deps extends object }\n  ? Deps\n  : {};\n\ntype ProvidedMap<Input> = Input extends {\n  provided: infer Provided extends object;\n}\n  ? Provided\n  : {};\n\ntype ExplicitMissingProviderMap<Input> = Input extends {\n  missingProvider: infer MissingProvider extends object;\n}\n  ? MissingProvider\n  : {};\n\ntype IsAny<Input> = 0 extends 1 & Input ? true : false;\n\ntype AppProvidedServiceNamesFromEntry<Entry> =\n  IsAny<Entry> extends true\n    ? never\n    : Entry extends NamedBrandedServiceProvider<infer Name, any, any>\n      ? Name\n      : Entry extends readonly unknown[]\n        ? AppProvidedServiceNames<Entry>\n        : never;\n\ntype KnownProvidedDependencyValue<Value> = [unknown] extends [Value]\n  ? never\n  : Value;\n\ntype AppProvidedDependencyValuesFromEntry<Entry> =\n  IsAny<Entry> extends true\n    ? never\n    : Entry extends NamedBrandedServiceProvider<any, any, infer Output>\n      ? KnownProvidedDependencyValue<Output>\n      : Entry extends readonly unknown[]\n        ? AppProvidedDependencyValues<Entry>\n        : never;\n\ntype AppProvidedServiceNames<Providers> = Providers extends readonly unknown[]\n  ? AppProvidedServiceNamesFromEntry<Providers[number]>\n  : never;\n\ntype AppProvidedDependencyValues<Providers> =\n  Providers extends readonly unknown[]\n    ? AppProvidedDependencyValuesFromEntry<Providers[number]>\n    : never;\n\ntype AppProvidedValueKeys<MissingProviders extends object, ProvidedValues> = {\n  [Name in Extract<\n    keyof MissingProviders,\n    string\n  >]: MissingProviders[Name] extends ProvidedValues ? Name : never;\n}[Extract<keyof MissingProviders, string>];\n\ntype CraftAppStartRegistryKeys = Extract<keyof CraftAppStartRegistry, string>;\n\ntype RequireCraftAppStartConfig = [CraftAppStartRegistryKeys] extends [never]\n  ? {}\n  : {\n      appStart: CraftAppStartRegistry;\n    };\n\ntype InvalidCraftAppStartRegistryEntries = Extract<\n  {\n    [Tag in CraftAppStartRegistryKeys]: CraftAppStartRegistry[Tag] extends ServiceReference\n      ? GetServiceReferenceMeta<CraftAppStartRegistry[Tag]> extends {\n          appStart: true;\n        }\n        ? never\n        : Tag\n      : Tag;\n  }[CraftAppStartRegistryKeys],\n  string\n>;\n\ntype AssertValidCraftAppStartRegistry = [\n  InvalidCraftAppStartRegistryEntries,\n] extends [never]\n  ? {}\n  : {\n      ERROR_invalid_craft_app_start_registry: InvalidCraftAppStartRegistryEntries;\n    };\n\ntype RegisteredAppStartServiceNames = {\n  [Tag in CraftAppStartRegistryKeys]: CraftAppStartRegistry[Tag] extends ServiceReference\n    ? Extract<\n        GetServiceReferenceMeta<CraftAppStartRegistry[Tag]>['name'],\n        string\n      >\n    : never;\n}[CraftAppStartRegistryKeys];\n\ntype ConfigProvidedServiceNames<Providers> =\n  | AppProvidedServiceNames<Providers>\n  | RegisteredAppStartServiceNames;\n\ntype StripProvidedDependency<\n  Dependency,\n  ProvidedNames extends string,\n> = Dependency extends {\n  dependencies: infer Dependencies extends object;\n}\n  ? Simplify<\n      Omit<Dependency, 'dependencies'> & {\n        dependencies: StripProvidedDepsMap<Dependencies, ProvidedNames>;\n      }\n    >\n  : Dependency;\n\ntype StripProvidedDepsMap<\n  Deps extends object,\n  ProvidedNames extends string,\n> = Simplify<\n  Omit<\n    {\n      [Name in Extract<keyof Deps, string>]: StripProvidedDependency<\n        Deps[Name],\n        ProvidedNames\n      >;\n    },\n    ProvidedNames\n  >\n>;\n\ntype ResolvedRouteDepsMap<RouteMetaData, Providers> = StripProvidedDepsMap<\n  DepsMap<RouteMetaData>,\n  ConfigProvidedServiceNames<Providers>\n>;\n\ntype RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers> =\n  Simplify<\n    MissingProvidersFromDepsMap<\n      ResolvedRouteDepsMap<RouteMetaData, Providers>\n    > &\n      ExplicitMissingProviderMap<RouteMetaData>\n  >;\n\ntype ResolvedRouteMissingProviders<RouteMetaData, Providers> = Simplify<\n  Omit<\n    RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers>,\n    | keyof ProvidedMap<RouteMetaData>\n    | ConfigProvidedServiceNames<Providers>\n    | AppProvidedValueKeys<\n        RouteMissingProvidersBeforeAppProviders<RouteMetaData, Providers>,\n        AppProvidedDependencyValues<Providers>\n      >\n  >\n>;\n\ntype ResolveCraftAppRouteMetaData<RouteMetaData, Providers> = Simplify<\n  Omit<RouteMetaData, 'deps' | 'missingProvider'> &\n    (RouteMetaData extends { deps: object }\n      ? {\n          deps: ResolvedRouteDepsMap<RouteMetaData, Providers>;\n        }\n      : {}) &\n    ([keyof ResolvedRouteMissingProviders<RouteMetaData, Providers>] extends [\n      never,\n    ]\n      ? {}\n      : {\n          missingProvider: ResolvedRouteMissingProviders<\n            RouteMetaData,\n            Providers\n          >;\n        })\n>;\n\nexport type CraftAppConfigMetaData<\n  RoutingDeps extends readonly unknown[],\n  Providers extends\n    AngularApplicationProviders = readonly AngularApplicationProvider[],\n> = {\n  [Index in keyof RoutingDeps]: ResolveCraftAppRouteMetaData<\n    RoutingDeps[Index],\n    Providers\n  >;\n} & {\n  readonly __craftAppProvidedServiceNames__?: ConfigProvidedServiceNames<Providers>;\n  readonly __craftAppProvidedDependencyValues__?: AppProvidedDependencyValues<Providers>;\n};\n\nexport type CraftAppConfigResult<\n  RoutingDeps extends readonly unknown[],\n  Providers extends\n    AngularApplicationProviders = readonly AngularApplicationProvider[],\n> = {\n  readonly providers: readonly AngularApplicationProvider[];\n  readonly APP_CONFIG_META_DATA: CraftAppConfigMetaData<RoutingDeps, Providers>;\n  /** @internal phantom — lets `AppProvidedServiceNamesOf` skip `APP_CONFIG_META_DATA` */\n  readonly __craftAppProvidedServiceNames__?: ConfigProvidedServiceNames<Providers>;\n  /** @internal phantom — lets `AppProvidedDependencyValuesOf` skip `APP_CONFIG_META_DATA` */\n  readonly __craftAppProvidedDependencyValues__?: AppProvidedDependencyValues<Providers>;\n};\n\nexport function craftAppConfig<const RoutingDeps extends readonly unknown[]>(\n  config: {\n    routingDeps: RoutingDeps;\n  } & AssertValidCraftAppStartRegistry &\n    RequireCraftAppStartConfig,\n): CraftAppConfigResult<RoutingDeps, readonly []>;\nexport function craftAppConfig<\n  const RoutingDeps extends readonly unknown[],\n  const Providers extends AngularApplicationProviders,\n>(\n  config: {\n    routingDeps: RoutingDeps;\n    providers: Providers;\n  } & AssertValidCraftAppStartRegistry &\n    RequireCraftAppStartConfig,\n): CraftAppConfigResult<RoutingDeps, Providers>;\nexport function craftAppConfig<\n  const RoutingDeps extends readonly unknown[],\n  const Providers extends AngularApplicationProviders,\n>(\n  config: {\n    routingDeps: RoutingDeps;\n    providers?: Providers;\n  } & AssertValidCraftAppStartRegistry &\n    RequireCraftAppStartConfig,\n): CraftAppConfigResult<RoutingDeps, Providers | readonly []> {\n  const providers = [\n    ...getCraftRootDefaultProviders(),\n    ...(config.providers ?? []),\n  ] as AngularApplicationProvider[];\n  const providerNames = collectProvidedServiceNames(providers);\n\n  for (const reference of getRegisteredAppStartServices()) {\n    const metaData = getServiceMetaData(reference);\n\n    if (metaData.appStart !== true) {\n      throw new Error(\n        `craftAppConfig found craftService \"${metaData.name}\" registered as appStart without appStart: true.`,\n      );\n    }\n\n    if (\n      Reflect.get(metaData, 'usesProvidedInput') === true &&\n      (metaData.providedIn === 'toProvide' ||\n        metaData.providedIn === 'manuallyProvidedAtRoot')\n    ) {\n      throw new Error(\n        `craftAppConfig cannot auto-provide appStart service \"${metaData.name}\" because provide${metaData.name}(...) requires arguments.`,\n      );\n    }\n\n    if (\n      (metaData.providedIn === 'toProvide' ||\n        metaData.providedIn === 'manuallyProvidedAtRoot') &&\n      typeof metaData.provide === 'function' &&\n      !providerNames.has(metaData.name)\n    ) {\n      providers.push(metaData.provide());\n      providerNames.add(metaData.name);\n    }\n\n    providers.push(\n      provideAppInitializer(() => {\n        const serviceValue = metaData.inject();\n        return runServiceAppStart(reference, serviceValue);\n      }),\n    );\n  }\n\n  return {\n    providers,\n    APP_CONFIG_META_DATA: config.routingDeps as CraftAppConfigMetaData<\n      RoutingDeps,\n      Providers | readonly []\n    >,\n  };\n}\n\n/** Returns a fresh host application config containing the Craft providers. */\nexport function toApplicationConfig(\n  config: Pick<CraftAppConfigResult<readonly unknown[]>, 'providers'>,\n): ApplicationConfig {\n  return {\n    providers: [...config.providers] as ApplicationConfig['providers'],\n  };\n}\n\nfunction collectProvidedServiceNames(\n  values: readonly unknown[],\n  names: Set<string> = new Set(),\n): Set<string> {\n  for (const value of values) {\n    collectProvidedServiceNamesFromValue(value, names);\n  }\n\n  return names;\n}\n\nfunction collectProvidedServiceNamesFromValue(\n  value: unknown,\n  names: Set<string>,\n) {\n  if (\n    typeof value === 'object' &&\n    value !== null &&\n    CRAFT_SERVICE_PROVIDER_BRAND in value\n  ) {\n    const metaData = Reflect.get(value, CRAFT_SERVICE_PROVIDER_BRAND) as\n      | { name: string }\n      | undefined;\n\n    if (metaData?.name) {\n      names.add(metaData.name);\n    }\n  }\n\n  if (Array.isArray(value)) {\n    for (const entry of value) {\n      collectProvidedServiceNamesFromValue(entry, names);\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,16 @@
+/**
+ * A synchronous bidirectional conversion between a transport representation
+ * and the value used by the application.
+ *
+ * The core only knows this small contract. Integrations for validation
+ * libraries live in separate packages.
+ */
+export interface CraftCodec<Encoded, Decoded> {
+    decode(input: Encoded): Decoded;
+    encode(value: Decoded): Encoded;
+}
+/** A runtime decoder used for successful HTTP response bodies. */
+export interface CraftDecoder<Decoded> {
+    decode(input: unknown): Decoded | Promise<Decoded>;
+}
+//# sourceMappingURL=craft-codec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-codec.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-codec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,OAAO;IAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY,CAAC,OAAO;IACnC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD"}

package/src/lib/craft-codec.js

@@ -0,0 +1 @@
+//# sourceMappingURL=craft-codec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-codec.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-codec.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A synchronous bidirectional conversion between a transport representation\n * and the value used by the application.\n *\n * The core only knows this small contract. Integrations for validation\n * libraries live in separate packages.\n */\nexport interface CraftCodec<Encoded, Decoded> {\n  decode(input: Encoded): Decoded;\n  encode(value: Decoded): Encoded;\n}\n\n/** A runtime decoder used for successful HTTP response bodies. */\nexport interface CraftDecoder<Decoded> {\n  decode(input: unknown): Decoded | Promise<Decoded>;\n}\n"]}

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

@@ -0,0 +1,31 @@
+import { type CreateComputedOptions } from './host/craft-compat';
+import type { SERVICE_HELPER_DEPENDENCIES, ServiceDependencyMapFromYielded } from './craft-service';
+import type { ExtractCraftGenExceptions } from './craft-gen';
+import type { CraftSettledBrand, ExtractCraftPendingSources } from './craft-settled';
+import { REACTIVE_DEPENDENCIES, type ReactiveDependencyMapFromYielded, type YieldableReactiveValue } from './reactive-read';
+type CraftComputedGenerator<This, Yielded, T> = (this: This) => Generator<Yielded, T, unknown>;
+/**
+ * A computation that read a `settledValue` through `yield* settled(...)` inherits
+ * its source's two obligations: the async source must be covered by a
+ * `pendingBlock`, and its exceptions by a `catchBlock`. Both travel as the
+ * {@link CraftSettledBrand} of the resulting signal, so a template rendering it
+ * is checked exactly as if it rendered the `settledValue` itself.
+ *
+ * Computations with no async dependency keep their previous exact type.
+ */
+type SettledBrandFromYielded<Yielded> = [
+    ExtractCraftPendingSources<Yielded>
+] extends [never] ? {} : CraftSettledBrand<ExtractCraftPendingSources<Yielded>, ExtractCraftGenExceptions<Yielded>>;
+type TrackedCraftComputed<Name extends string, T, Yielded> = YieldableReactiveValue<T, Name> & {
+    readonly [SERVICE_HELPER_DEPENDENCIES]?: ServiceDependencyMapFromYielded<Yielded>;
+} & ([ReactiveDependencyMapFromYielded<Yielded>] extends [never] ? {} : {
+    readonly [REACTIVE_DEPENDENCIES]?: ReactiveDependencyMapFromYielded<Yielded>;
+}) & SettledBrandFromYielded<Yielded>;
+export declare function craftComputed<Name extends string, This, Yielded, T>(name: Name, host: This, factory: CraftComputedGenerator<This, Yielded, T>, options?: CreateComputedOptions<T>): TrackedCraftComputed<Name, T, Yielded>;
+export declare function craftComputed<Name extends string, Yielded, T>(name: Name, factory: CraftComputedGenerator<void, Yielded, T>, options?: CreateComputedOptions<T>): TrackedCraftComputed<Name, T, Yielded>;
+export declare function craftComputed<Name extends string, This, T>(name: Name, host: This, computation: (this: This) => T, options?: CreateComputedOptions<T>): TrackedCraftComputed<Name, T, never>;
+export declare function craftComputed<Name extends string, T>(name: Name, computation: () => T, options?: CreateComputedOptions<T>): TrackedCraftComputed<Name, T, never>;
+export declare function craftComputed<Yielded, T>(factory: CraftComputedGenerator<void, Yielded, T>, options?: CreateComputedOptions<T>): TrackedCraftComputed<'computed', T, Yielded>;
+export declare function craftComputed<T>(computation: () => T, options?: CreateComputedOptions<T>): TrackedCraftComputed<'computed', T, never>;
+export {};
+//# sourceMappingURL=craft-computed.d.ts.map