@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-platform.js

@@ -0,0 +1,175 @@
+import { craftToken } from './host/craft-injector';
+import { createBrowserHistory, createMemoryHistory, } from './host/craft-router-runtime';
+export const CRAFT_PLATFORM = craftToken('CraftPlatform');
+export function createMemoryStorage() {
+    const values = new Map();
+    return {
+        get length() {
+            return values.size;
+        },
+        clear: () => values.clear(),
+        getItem: (key) => values.get(key) ?? null,
+        key: (index) => [...values.keys()][index] ?? null,
+        removeItem: (key) => values.delete(key),
+        setItem: (key, value) => values.set(key, String(value)),
+    };
+}
+export function createBrowserPlatform(win, options = {}) {
+    return {
+        kind: 'browser',
+        hydrating: options.hydrating ?? false,
+        document: win.document,
+        window: win,
+        history: createBrowserHistory(win),
+        localStorage: win.localStorage,
+        sessionStorage: win.sessionStorage,
+        now: () => win.performance.now(),
+        randomUUID: () => win.crypto.randomUUID(),
+        listen: (target, event, handler) => {
+            target.addEventListener(event, handler);
+            return () => target.removeEventListener(event, handler);
+        },
+    };
+}
+export function createServerPlatform(options = {}) {
+    const localStorage = createMemoryStorage();
+    const sessionStorage = createMemoryStorage();
+    const serverResources = createServerResourceController();
+    const history = createMemoryHistory(options.url ?? '/');
+    const window = createServerWindow(history, options.document, localStorage, sessionStorage);
+    return {
+        kind: 'server',
+        hydrating: false,
+        document: options.document,
+        window,
+        history,
+        localStorage,
+        sessionStorage,
+        requestSignal: options.signal,
+        serverResources,
+        now: () => globalThis.performance?.now?.() ?? Date.now(),
+        randomUUID: () => globalThis.crypto?.randomUUID?.() ??
+            // Runtime correlation IDs may still need a value on older Node releases;
+            // hydration identities never use this API.
+            `server-${Date.now().toString(36)}`,
+        listen: () => () => undefined,
+    };
+}
+function createServerWindow(craftHistory, document, localStorage, sessionStorage) {
+    const currentUrl = () => {
+        const location = craftHistory.get();
+        return new URL(`${location.pathname}${location.search}${location.hash}`, 'http://localhost');
+    };
+    const location = {
+        get href() {
+            return currentUrl().href;
+        },
+        get origin() {
+            return currentUrl().origin;
+        },
+        get protocol() {
+            return currentUrl().protocol;
+        },
+        get host() {
+            return currentUrl().host;
+        },
+        get hostname() {
+            return currentUrl().hostname;
+        },
+        get port() {
+            return currentUrl().port;
+        },
+        get pathname() {
+            return currentUrl().pathname;
+        },
+        get search() {
+            return currentUrl().search;
+        },
+        get hash() {
+            return currentUrl().hash;
+        },
+        assign: (url) => craftHistory.push(String(url)),
+        replace: (url) => craftHistory.replace(String(url)),
+        reload: () => undefined,
+    };
+    const history = {
+        get length() {
+            return 1;
+        },
+        get state() {
+            return craftHistory.getState();
+        },
+        back: () => undefined,
+        forward: () => undefined,
+        go: () => undefined,
+        pushState: (data, _unused, url) => craftHistory.push(url === undefined || url === null ? location.href : String(url), data),
+        replaceState: (data, _unused, url) => craftHistory.replace(url === undefined || url === null ? location.href : String(url), data),
+    };
+    return {
+        document,
+        location,
+        history,
+        localStorage,
+        sessionStorage,
+        performance: globalThis.performance,
+        crypto: globalThis.crypto,
+        navigator: {
+            userAgent: 'CraftTS Server',
+            language: 'en',
+            languages: ['en'],
+            onLine: true,
+            cookieEnabled: false,
+            sendBeacon: () => false,
+            share: async () => undefined,
+        },
+        innerWidth: 0,
+        innerHeight: 0,
+        scrollX: 0,
+        scrollY: 0,
+        scrollTo: () => undefined,
+        alert: () => undefined,
+        confirm: () => false,
+        addEventListener: () => undefined,
+        removeEventListener: () => undefined,
+    };
+}
+function createServerResourceController() {
+    const deferred = new Map();
+    const blocking = new Set();
+    const scheduled = new Set();
+    const schedule = (start) => {
+        if (scheduled.has(start))
+            return;
+        scheduled.add(start);
+        queueMicrotask(() => {
+            scheduled.delete(start);
+            start();
+        });
+    };
+    return {
+        defer(source, start) {
+            if (blocking.has(source)) {
+                schedule(start);
+                return;
+            }
+            let starts = deferred.get(source);
+            if (!starts) {
+                starts = new Set();
+                deferred.set(source, starts);
+            }
+            starts.add(start);
+        },
+        decide(source, mode) {
+            if (mode !== 'block')
+                return;
+            blocking.add(source);
+            const starts = deferred.get(source);
+            if (!starts)
+                return;
+            deferred.delete(source);
+            for (const start of starts)
+                schedule(start);
+        },
+    };
+}
+//# sourceMappingURL=craft-platform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-platform.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-platform.ts"],"names":[],"mappings":"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","sourcesContent":["import { craftToken } from './host/craft-injector';\nimport {\n  createBrowserHistory,\n  createMemoryHistory,\n  type CraftHistory,\n} from './host/craft-router-runtime';\nimport type { SsrMode } from './craft-ssr';\n\nexport type CraftPlatformKind = 'browser' | 'server';\n\nexport type CraftStorage = Pick<\n  Storage,\n  'clear' | 'getItem' | 'key' | 'removeItem' | 'setItem'\n> & { readonly length: number };\n\nexport type CraftPlatform = Readonly<{\n  kind: CraftPlatformKind;\n  /** True only during the first client pass over server-rendered DOM. */\n  hydrating: boolean;\n  document?: Document;\n  window?: Window;\n  history: CraftHistory;\n  localStorage: CraftStorage;\n  sessionStorage: CraftStorage;\n  requestSignal?: AbortSignal;\n  serverResources?: CraftServerResourceController;\n  now(): number;\n  randomUUID(): string;\n  listen(\n    target: EventTarget,\n    event: string,\n    handler: EventListener,\n  ): () => void;\n}>;\n\nexport type CraftServerResourceController = Readonly<{\n  defer(source: string, start: () => void): void;\n  decide(source: string, mode: SsrMode): void;\n}>;\n\nexport const CRAFT_PLATFORM = craftToken<CraftPlatform>('CraftPlatform');\n\nexport function createMemoryStorage(): CraftStorage {\n  const values = new Map<string, string>();\n  return {\n    get length() {\n      return values.size;\n    },\n    clear: () => values.clear(),\n    getItem: (key) => values.get(key) ?? null,\n    key: (index) => [...values.keys()][index] ?? null,\n    removeItem: (key) => values.delete(key),\n    setItem: (key, value) => values.set(key, String(value)),\n  };\n}\n\nexport function createBrowserPlatform(\n  win: Window,\n  options: Readonly<{ hydrating?: boolean }> = {},\n): CraftPlatform {\n  return {\n    kind: 'browser',\n    hydrating: options.hydrating ?? false,\n    document: win.document,\n    window: win,\n    history: createBrowserHistory(win),\n    localStorage: win.localStorage,\n    sessionStorage: win.sessionStorage,\n    now: () => win.performance.now(),\n    randomUUID: () => win.crypto.randomUUID(),\n    listen: (target, event, handler) => {\n      target.addEventListener(event, handler);\n      return () => target.removeEventListener(event, handler);\n    },\n  };\n}\n\nexport function createServerPlatform(\n  options: Readonly<{\n    url?: string;\n    document?: Document;\n    signal?: AbortSignal;\n  }> = {},\n): CraftPlatform {\n  const localStorage = createMemoryStorage();\n  const sessionStorage = createMemoryStorage();\n  const serverResources = createServerResourceController();\n  const history = createMemoryHistory(options.url ?? '/');\n  const window = createServerWindow(\n    history,\n    options.document,\n    localStorage,\n    sessionStorage,\n  );\n  return {\n    kind: 'server',\n    hydrating: false,\n    document: options.document,\n    window,\n    history,\n    localStorage,\n    sessionStorage,\n    requestSignal: options.signal,\n    serverResources,\n    now: () => globalThis.performance?.now?.() ?? Date.now(),\n    randomUUID: () =>\n      globalThis.crypto?.randomUUID?.() ??\n      // Runtime correlation IDs may still need a value on older Node releases;\n      // hydration identities never use this API.\n      `server-${Date.now().toString(36)}`,\n    listen: () => () => undefined,\n  };\n}\n\nfunction createServerWindow(\n  craftHistory: CraftHistory,\n  document: Document | undefined,\n  localStorage: CraftStorage,\n  sessionStorage: CraftStorage,\n): Window {\n  const currentUrl = () => {\n    const location = craftHistory.get();\n    return new URL(\n      `${location.pathname}${location.search}${location.hash}`,\n      'http://localhost',\n    );\n  };\n  const location = {\n    get href() {\n      return currentUrl().href;\n    },\n    get origin() {\n      return currentUrl().origin;\n    },\n    get protocol() {\n      return currentUrl().protocol;\n    },\n    get host() {\n      return currentUrl().host;\n    },\n    get hostname() {\n      return currentUrl().hostname;\n    },\n    get port() {\n      return currentUrl().port;\n    },\n    get pathname() {\n      return currentUrl().pathname;\n    },\n    get search() {\n      return currentUrl().search;\n    },\n    get hash() {\n      return currentUrl().hash;\n    },\n    assign: (url: string | URL) => craftHistory.push(String(url)),\n    replace: (url: string | URL) => craftHistory.replace(String(url)),\n    reload: () => undefined,\n  };\n  const history = {\n    get length() {\n      return 1;\n    },\n    get state() {\n      return craftHistory.getState();\n    },\n    back: () => undefined,\n    forward: () => undefined,\n    go: () => undefined,\n    pushState: (data: unknown, _unused: string, url?: string | URL | null) =>\n      craftHistory.push(\n        url === undefined || url === null ? location.href : String(url),\n        data,\n      ),\n    replaceState: (data: unknown, _unused: string, url?: string | URL | null) =>\n      craftHistory.replace(\n        url === undefined || url === null ? location.href : String(url),\n        data,\n      ),\n  };\n  return {\n    document,\n    location,\n    history,\n    localStorage,\n    sessionStorage,\n    performance: globalThis.performance,\n    crypto: globalThis.crypto,\n    navigator: {\n      userAgent: 'CraftTS Server',\n      language: 'en',\n      languages: ['en'],\n      onLine: true,\n      cookieEnabled: false,\n      sendBeacon: () => false,\n      share: async () => undefined,\n    },\n    innerWidth: 0,\n    innerHeight: 0,\n    scrollX: 0,\n    scrollY: 0,\n    scrollTo: () => undefined,\n    alert: () => undefined,\n    confirm: () => false,\n    addEventListener: () => undefined,\n    removeEventListener: () => undefined,\n  } as unknown as Window;\n}\n\nfunction createServerResourceController(): CraftServerResourceController {\n  const deferred = new Map<string, Set<() => void>>();\n  const blocking = new Set<string>();\n  const scheduled = new Set<() => void>();\n\n  const schedule = (start: () => void) => {\n    if (scheduled.has(start)) return;\n    scheduled.add(start);\n    queueMicrotask(() => {\n      scheduled.delete(start);\n      start();\n    });\n  };\n\n  return {\n    defer(source, start) {\n      if (blocking.has(source)) {\n        schedule(start);\n        return;\n      }\n      let starts = deferred.get(source);\n      if (!starts) {\n        starts = new Set();\n        deferred.set(source, starts);\n      }\n      starts.add(start);\n    },\n    decide(source, mode) {\n      if (mode !== 'block') return;\n      blocking.add(source);\n      const starts = deferred.get(source);\n      if (!starts) return;\n      deferred.delete(source);\n      for (const start of starts) schedule(start);\n    },\n  };\n}\n"]}

package/src/lib/craft-primitive-gen.d.ts

@@ -0,0 +1,137 @@
+import { type Injector, type Signal } from './host/craft-compat';
+import { SERVICE_TRACKED_DEPS_REQUEST_MARKER } from './craft-generator-runtime';
+import type { ConcreteServiceScope } from './craft-service.shared';
+import type { SERVICE_HELPER_DEPENDENCIES } from './craft-service';
+import type { CraftGenExceptionMarker } from './craft-gen';
+import { YIELDABLE_VALUE } from './yieldable';
+import { DEEP_YIELDABLE, type YieldableReactiveValue } from './reactive-read';
+/**
+ * Dependency map carried by a primitive (`mutation`, `query`, `asyncProcess`,
+ * `state`, `queryParams`, …) on its phantom
+ * `[SERVICE_HELPER_DEPENDENCIES]` property.
+ */
+export type HelperDependencyMap<Helper> = Helper extends {
+    readonly [SERVICE_HELPER_DEPENDENCIES]?: infer Map extends object;
+} ? Map : {};
+/**
+ * Request yielded by a primitive generator (see {@link CraftPrimitiveGen}).
+ * Type-level only: it carries the primitive's dependency map so the enclosing
+ * `craftService` folds it into its own dependency tree. At runtime it is a
+ * no-op (see `runCraftGenerator`).
+ */
+export type ServiceTrackedDepsRequest<DepMap extends object = object> = Readonly<{
+    [SERVICE_TRACKED_DEPS_REQUEST_MARKER]: true;
+    /** Phantom carrier — never read at runtime. */
+    readonly depMap?: DepMap;
+    providedIn: ConcreteServiceScope;
+    resolve: (injector: Injector, hostScope: ConcreteServiceScope) => unknown;
+}>;
+/**
+ * The generator returned by the craft primitives (`state`, `query`, `mutation`,
+ * `asyncProcess`, `queryParams`). Consume it with `yield*` inside a generator
+ * host (a `craftService` factory, `craftGen`, …) or with `craftUse(...)` in a
+ * component field:
+ *
+ * ```ts
+ * // inside a craftService factory
+ * const users = yield* query({ ... });
+ *
+ * // in a component field
+ * readonly users = craftUse(query({ ... }));
+ * ```
+ *
+ * Yields a single {@link ServiceTrackedDepsRequest} carrying the primitive's
+ * dependency map (type-level only, no-op at runtime), then resolves to the
+ * primitive ref. Like any generator it is single-use: driving it a second time
+ * yields nothing and returns `undefined`.
+ */
+type PrimitiveExceptionUnion<Ref> = Ref extends {
+    readonly exception: Signal<infer Exception>;
+} ? Extract<Exception, {
+    readonly _tag: string;
+}> : never;
+type PrimitiveExceptionMarker<Ref> = [PrimitiveExceptionUnion<Ref>] extends [
+    never
+] ? never : CraftGenExceptionMarker<PrimitiveExceptionUnion<Ref>>;
+/**
+ * A generator's `Yielded` is an INFERRED union, and TypeScript subtype-reduces
+ * those: `ServiceTrackedDepsRequest<{}>` is a supertype of every other tracked
+ * request, so a primitive with no dependency would swallow the requests of every
+ * primitive yielded beside it. Collapsing an empty map to `never` flips the
+ * relation — the dependency-free request is now the subtype, and it is the one
+ * that disappears.
+ */
+type EmptyDepMapToNever<DepMap> = [keyof DepMap] extends [never] ? never : DepMap;
+export type CraftPrimitiveGen<Ref, ExceptionRef = Ref> = Generator<ServiceTrackedDepsRequest<EmptyDepMapToNever<HelperDependencyMap<Ref>>> | PrimitiveExceptionMarker<ExceptionRef>, Ref, unknown>;
+/**
+ * The value a named craft primitive resolves to: the primitive reference itself.
+ * The name remains available for host tagging and reactive template branding,
+ * but it is no longer required as an object key at the call site.
+ *
+ * ```ts
+ * const counter = yield* state('counter', 0);
+ * const userQuery = yield* query('userQuery', { ... });
+ * ```
+ *
+ */
+export type NamedPrimitive<Name extends string, Ref> = Ref extends {
+    type: string;
+    kind: string;
+} ? Ref : Ref extends {
+    readonly [DEEP_YIELDABLE]: true;
+} ? Ref : Ref extends YieldableReactiveValue<infer State, any> ? Omit<Ref, keyof YieldableReactiveValue<State, any>> & YieldableReactiveValue<State, Name> : Ref extends Signal<any> ? Ref & {
+    readonly [YIELDABLE_VALUE]: Name;
+} : Ref;
+/**
+ * Return type of the named craft primitives: a {@link CraftPrimitiveGen}
+ * resolving to the primitive reference itself (see {@link NamedPrimitive}).
+ */
+export type NamedCraftPrimitiveGen<Name extends string, Ref> = CraftPrimitiveGen<NamedPrimitive<Name, Ref>, Ref>;
+type YieldRecordValue<Value> = Value extends Generator<any, infer Output, any> ? Output : Value;
+type YieldRecordOutput<Record extends object> = {
+    [Key in keyof Record]: YieldRecordValue<Record[Key]>;
+};
+type YieldRecordYielded<Record extends object> = Record[keyof Record] extends infer Value ? Value extends Generator<infer Yielded, any, any> ? Yielded : never : never;
+/**
+ * Resolves a record of generator-compatible values while preserving its keys.
+ *
+ * This is useful when a craft service exposes several primitives without
+ * writing a generator only to delegate each one:
+ *
+ * ```ts
+ * const { UserStore } = craftService(
+ *   { name: 'UserStore', providedIn: 'global' },
+ *   () =>
+ *     craftYieldRecord({
+ *       userQuery: query('userQuery', { ... }),
+ *       refresh: state('refresh', 0),
+ *     }),
+ * );
+ * ```
+ *
+ * Plain values are passed through unchanged. Generator values are consumed in
+ * insertion order, so their tracked dependencies are visible to the enclosing
+ * craft generator.
+ */
+export declare function craftYieldRecord<Record extends object>(record: Record): Generator<YieldRecordYielded<Record>, YieldRecordOutput<Record>, unknown>;
+/**
+ * Surfaces a primitive ref as a {@link CraftPrimitiveGen} while retaining its
+ * declared `name` for runtime tagging. Counterpart of
+ * {@link createPrimitiveGen} for the named primitives (`state`, `query`,
+ * `mutation`, `asyncProcess`, `queryParams`).
+ */
+export declare function createNamedPrimitiveGen<Name extends string, Ref>(name: Name, ref: Ref): CraftPrimitiveGen<NamedPrimitive<Name, Ref>, Ref>;
+/**
+ * Wraps an already-created primitive ref into a {@link CraftPrimitiveGen}. The
+ * ref is created eagerly by the primitive (injector captures included); the
+ * generator only surfaces the dependency map to the enclosing host and hands
+ * the ref back.
+ */
+export declare function createPrimitiveGen<Ref>(ref: Ref): CraftPrimitiveGen<Ref>;
+/**
+ * `true` for a generator produced by a craft primitive (`state(...)`,
+ * `query(...)`, …) that has not been consumed through `yield*` / `craftUse`.
+ */
+export declare function isCraftPrimitiveGen(value: unknown): value is CraftPrimitiveGen<unknown>;
+export {};
+//# sourceMappingURL=craft-primitive-gen.d.ts.map

package/src/lib/craft-primitive-gen.d.ts.map

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

package/src/lib/craft-primitive-gen.js

@@ -0,0 +1,76 @@
+import { isSignal } from './host/craft-compat';
+import { isGenerator, SERVICE_TRACKED_DEPS_REQUEST_MARKER, } from './craft-generator-runtime';
+import { markNamedReactiveProperties, markYieldableValue, YIELDABLE_VALUE, } from './yieldable';
+import { DEEP_YIELDABLE, } from './reactive-read';
+/**
+ * Resolves a record of generator-compatible values while preserving its keys.
+ *
+ * This is useful when a craft service exposes several primitives without
+ * writing a generator only to delegate each one:
+ *
+ * ```ts
+ * const { UserStore } = craftService(
+ *   { name: 'UserStore', providedIn: 'global' },
+ *   () =>
+ *     craftYieldRecord({
+ *       userQuery: query('userQuery', { ... }),
+ *       refresh: state('refresh', 0),
+ *     }),
+ * );
+ * ```
+ *
+ * Plain values are passed through unchanged. Generator values are consumed in
+ * insertion order, so their tracked dependencies are visible to the enclosing
+ * craft generator.
+ */
+export function craftYieldRecord(record) {
+    return (function* () {
+        const output = {};
+        for (const key of Reflect.ownKeys(record)) {
+            const value = record[key];
+            output[key] = (isGenerator(value) ? yield* value : value);
+        }
+        return output;
+    })();
+}
+/**
+ * Surfaces a primitive ref as a {@link CraftPrimitiveGen} while retaining its
+ * declared `name` for runtime tagging. Counterpart of
+ * {@link createPrimitiveGen} for the named primitives (`state`, `query`,
+ * `mutation`, `asyncProcess`, `queryParams`).
+ */
+export function createNamedPrimitiveGen(name, ref) {
+    markNamedReactiveProperties(ref);
+    const namedRef = isSignal(ref) ? markYieldableValue(ref, name) : ref;
+    return createPrimitiveGen(namedRef);
+}
+const CRAFT_PRIMITIVE_GEN_MARKER = Symbol('craft-primitive-gen-marker');
+/**
+ * Wraps an already-created primitive ref into a {@link CraftPrimitiveGen}. The
+ * ref is created eagerly by the primitive (injector captures included); the
+ * generator only surfaces the dependency map to the enclosing host and hands
+ * the ref back.
+ */
+export function createPrimitiveGen(ref) {
+    const gen = (function* () {
+        yield {
+            [SERVICE_TRACKED_DEPS_REQUEST_MARKER]: true,
+            providedIn: 'global',
+            resolve: () => undefined,
+        };
+        return ref;
+    })();
+    return Object.assign(gen, {
+        [CRAFT_PRIMITIVE_GEN_MARKER]: true,
+    });
+}
+/**
+ * `true` for a generator produced by a craft primitive (`state(...)`,
+ * `query(...)`, …) that has not been consumed through `yield*` / `craftUse`.
+ */
+export function isCraftPrimitiveGen(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        CRAFT_PRIMITIVE_GEN_MARKER in value);
+}
+//# sourceMappingURL=craft-primitive-gen.js.map

package/src/lib/craft-primitive-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-primitive-gen.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-primitive-gen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA8B,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,WAAW,EACX,mCAAmC,GACpC,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,GAEf,MAAM,iBAAiB,CAAC;AA8HzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc;IAEd,OAAO,CAAC,QAAQ,CAAC;QACf,MAAM,MAAM,GAAG,EAA+B,CAAC;QAE/C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAqB,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,CACZ,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACF,CAAC;QAC5C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,EAID,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAU,EACV,GAAQ;IAER,2BAA2B,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrE,OAAO,kBAAkB,CAAC,QAAQ,CAGjC,CAAC;AACJ,CAAC;AAED,MAAM,0BAA0B,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAM,GAAQ;IAC9C,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;QACpB,MAAM;YACJ,CAAC,mCAAmC,CAAC,EAAE,IAAI;YAC3C,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;SAC8B,CAAC;QACzD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QACxB,CAAC,0BAA0B,CAAC,EAAE,IAAI;KACnC,CAA2B,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,0BAA0B,IAAI,KAAK,CACpC,CAAC;AACJ,CAAC","sourcesContent":["import { isSignal, type Injector, type Signal } from './host/craft-compat';\nimport {\n  isGenerator,\n  SERVICE_TRACKED_DEPS_REQUEST_MARKER,\n} from './craft-generator-runtime';\nimport type { ConcreteServiceScope } from './craft-service.shared';\nimport type { SERVICE_HELPER_DEPENDENCIES } from './craft-service';\nimport type { CraftGenExceptionMarker } from './craft-gen';\nimport {\n  markNamedReactiveProperties,\n  markYieldableValue,\n  YIELDABLE_VALUE,\n} from './yieldable';\nimport {\n  DEEP_YIELDABLE,\n  type YieldableReactiveValue,\n} from './reactive-read';\n\n/**\n * Dependency map carried by a primitive (`mutation`, `query`, `asyncProcess`,\n * `state`, `queryParams`, …) on its phantom\n * `[SERVICE_HELPER_DEPENDENCIES]` property.\n */\nexport type HelperDependencyMap<Helper> = Helper extends {\n  readonly [SERVICE_HELPER_DEPENDENCIES]?: infer Map extends object;\n}\n  ? Map\n  : {};\n\n/**\n * Request yielded by a primitive generator (see {@link CraftPrimitiveGen}).\n * Type-level only: it carries the primitive's dependency map so the enclosing\n * `craftService` folds it into its own dependency tree. At runtime it is a\n * no-op (see `runCraftGenerator`).\n */\nexport type ServiceTrackedDepsRequest<DepMap extends object = object> =\n  Readonly<{\n    [SERVICE_TRACKED_DEPS_REQUEST_MARKER]: true;\n    /** Phantom carrier — never read at runtime. */\n    readonly depMap?: DepMap;\n    providedIn: ConcreteServiceScope;\n    resolve: (injector: Injector, hostScope: ConcreteServiceScope) => unknown;\n  }>;\n\n/**\n * The generator returned by the craft primitives (`state`, `query`, `mutation`,\n * `asyncProcess`, `queryParams`). Consume it with `yield*` inside a generator\n * host (a `craftService` factory, `craftGen`, …) or with `craftUse(...)` in a\n * component field:\n *\n * ```ts\n * // inside a craftService factory\n * const users = yield* query({ ... });\n *\n * // in a component field\n * readonly users = craftUse(query({ ... }));\n * ```\n *\n * Yields a single {@link ServiceTrackedDepsRequest} carrying the primitive's\n * dependency map (type-level only, no-op at runtime), then resolves to the\n * primitive ref. Like any generator it is single-use: driving it a second time\n * yields nothing and returns `undefined`.\n */\ntype PrimitiveExceptionUnion<Ref> = Ref extends {\n  readonly exception: Signal<infer Exception>;\n}\n  ? Extract<Exception, { readonly _tag: string }>\n  : never;\n\ntype PrimitiveExceptionMarker<Ref> = [PrimitiveExceptionUnion<Ref>] extends [\n  never,\n]\n  ? never\n  : CraftGenExceptionMarker<PrimitiveExceptionUnion<Ref>>;\n\n/**\n * A generator's `Yielded` is an INFERRED union, and TypeScript subtype-reduces\n * those: `ServiceTrackedDepsRequest<{}>` is a supertype of every other tracked\n * request, so a primitive with no dependency would swallow the requests of every\n * primitive yielded beside it. Collapsing an empty map to `never` flips the\n * relation — the dependency-free request is now the subtype, and it is the one\n * that disappears.\n */\ntype EmptyDepMapToNever<DepMap> = [keyof DepMap] extends [never]\n  ? never\n  : DepMap;\n\nexport type CraftPrimitiveGen<Ref, ExceptionRef = Ref> = Generator<\n  | ServiceTrackedDepsRequest<EmptyDepMapToNever<HelperDependencyMap<Ref>>>\n  | PrimitiveExceptionMarker<ExceptionRef>,\n  Ref,\n  unknown\n>;\n\n/**\n * The value a named craft primitive resolves to: the primitive reference itself.\n * The name remains available for host tagging and reactive template branding,\n * but it is no longer required as an object key at the call site.\n *\n * ```ts\n * const counter = yield* state('counter', 0);\n * const userQuery = yield* query('userQuery', { ... });\n * ```\n *\n */\nexport type NamedPrimitive<Name extends string, Ref> = Ref extends {\n  type: string;\n  kind: string;\n}\n  ? Ref\n  : Ref extends { readonly [DEEP_YIELDABLE]: true }\n    ? Ref\n  : Ref extends YieldableReactiveValue<infer State, any>\n    ? Omit<Ref, keyof YieldableReactiveValue<State, any>> &\n        YieldableReactiveValue<State, Name>\n    : Ref extends Signal<any>\n      ? Ref & { readonly [YIELDABLE_VALUE]: Name }\n      : Ref;\n\n/**\n * Return type of the named craft primitives: a {@link CraftPrimitiveGen}\n * resolving to the primitive reference itself (see {@link NamedPrimitive}).\n */\nexport type NamedCraftPrimitiveGen<\n  Name extends string,\n  Ref,\n> = CraftPrimitiveGen<NamedPrimitive<Name, Ref>, Ref>;\n\ntype YieldRecordValue<Value> =\n  Value extends Generator<any, infer Output, any> ? Output : Value;\n\ntype YieldRecordOutput<Record extends object> = {\n  [Key in keyof Record]: YieldRecordValue<Record[Key]>;\n};\n\ntype YieldRecordYielded<Record extends object> =\n  Record[keyof Record] extends infer Value\n    ? Value extends Generator<infer Yielded, any, any>\n      ? Yielded\n      : never\n    : never;\n\n/**\n * Resolves a record of generator-compatible values while preserving its keys.\n *\n * This is useful when a craft service exposes several primitives without\n * writing a generator only to delegate each one:\n *\n * ```ts\n * const { UserStore } = craftService(\n *   { name: 'UserStore', providedIn: 'global' },\n *   () =>\n *     craftYieldRecord({\n *       userQuery: query('userQuery', { ... }),\n *       refresh: state('refresh', 0),\n *     }),\n * );\n * ```\n *\n * Plain values are passed through unchanged. Generator values are consumed in\n * insertion order, so their tracked dependencies are visible to the enclosing\n * craft generator.\n */\nexport function craftYieldRecord<Record extends object>(\n  record: Record,\n): Generator<YieldRecordYielded<Record>, YieldRecordOutput<Record>, unknown> {\n  return (function* () {\n    const output = {} as YieldRecordOutput<Record>;\n\n    for (const key of Reflect.ownKeys(record) as (keyof Record)[]) {\n      const value = record[key];\n      output[key] = (\n        isGenerator(value) ? yield* value : value\n      ) as YieldRecordValue<Record[typeof key]>;\n    }\n\n    return output;\n  })() as Generator<\n    YieldRecordYielded<Record>,\n    YieldRecordOutput<Record>,\n    unknown\n  >;\n}\n\n/**\n * Surfaces a primitive ref as a {@link CraftPrimitiveGen} while retaining its\n * declared `name` for runtime tagging. Counterpart of\n * {@link createPrimitiveGen} for the named primitives (`state`, `query`,\n * `mutation`, `asyncProcess`, `queryParams`).\n */\nexport function createNamedPrimitiveGen<Name extends string, Ref>(\n  name: Name,\n  ref: Ref,\n): CraftPrimitiveGen<NamedPrimitive<Name, Ref>, Ref> {\n  markNamedReactiveProperties(ref);\n  const namedRef = isSignal(ref) ? markYieldableValue(ref, name) : ref;\n  return createPrimitiveGen(namedRef) as CraftPrimitiveGen<\n    NamedPrimitive<Name, Ref>,\n    Ref\n  >;\n}\n\nconst CRAFT_PRIMITIVE_GEN_MARKER = Symbol('craft-primitive-gen-marker');\n\n/**\n * Wraps an already-created primitive ref into a {@link CraftPrimitiveGen}. The\n * ref is created eagerly by the primitive (injector captures included); the\n * generator only surfaces the dependency map to the enclosing host and hands\n * the ref back.\n */\nexport function createPrimitiveGen<Ref>(ref: Ref): CraftPrimitiveGen<Ref> {\n  const gen = (function* () {\n    yield {\n      [SERVICE_TRACKED_DEPS_REQUEST_MARKER]: true,\n      providedIn: 'global',\n      resolve: () => undefined,\n    } as ServiceTrackedDepsRequest<HelperDependencyMap<Ref>>;\n    return ref;\n  })();\n\n  return Object.assign(gen, {\n    [CRAFT_PRIMITIVE_GEN_MARKER]: true,\n  }) as CraftPrimitiveGen<Ref>;\n}\n\n/**\n * `true` for a generator produced by a craft primitive (`state(...)`,\n * `query(...)`, …) that has not been consumed through `yield*` / `craftUse`.\n */\nexport function isCraftPrimitiveGen(\n  value: unknown,\n): value is CraftPrimitiveGen<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    CRAFT_PRIMITIVE_GEN_MARKER in value\n  );\n}\n"]}

package/src/lib/craft-primitive-registry.d.ts

@@ -0,0 +1,113 @@
+import { InjectionToken, type Injector } from './host/craft-compat';
+/**
+ * Primitives that hold a value the registry can read back and write into.
+ * `source$` is deliberately absent: an event stream has no state to restore.
+ */
+export type CraftPrimitiveKind = 'state' | 'query' | 'mutation' | 'asyncProcess' | 'queryParams';
+/**
+ * One addressable primitive instance.
+ *
+ * The address is the host-tag chain plus the primitive's own name, which is
+ * already unique per INSTANCE: `provideHostName` stamps a creation ordinal on
+ * every component tag, so two rows of the same list read as
+ * `component:Row#1 / …` and `component:Row#2 / …`.
+ *
+ * That ordinal is stable for the lifetime of a session but not across reloads,
+ * and a row destroyed and re-created takes a new one. It is enough to replay a
+ * machine inside one session; it is not a persistence key.
+ */
+export type CraftPrimitiveEntry = Readonly<{
+    address: string;
+    kind: CraftPrimitiveKind;
+    name: string;
+    hostTags: readonly string[];
+    read(): unknown;
+    write(value: unknown): void;
+    status?(): string;
+    error?(): unknown;
+    /**
+     * Re-runs the primitive's loader, when it has one. A resource the snapshot
+     * does not cover is reloaded rather than left showing data that belongs to
+     * another parameter.
+     */
+    reload?(): boolean;
+}>;
+/** A value snapshot of part of the registry, keyed by address. */
+export type CraftPrimitiveSnapshot = Readonly<Record<string, unknown>>;
+export declare class CraftPrimitiveRegistry {
+    private readonly entries;
+    private readonly occurrences;
+    private readonly primedValues;
+    /** Public primitive ref → address, so a caller can name what it holds. */
+    private readonly addresses;
+    /** Associates the ref an application holds with its registered address. */
+    link(ref: unknown, address: string): void;
+    /**
+     * The address of a primitive from the ref an application holds — how a
+     * feature names a primitive declared outside the host it is scoped to.
+     */
+    addressOf(ref: unknown): string | undefined;
+    /**
+     * Registers one instance under `base`, suffixed with an occurrence number.
+     *
+     * The counter only ever grows: an address is never handed out twice, even
+     * after the instance holding it is destroyed. A snapshot captured against
+     * `…#2` can therefore never be restored into a different primitive that
+     * happened to take the freed slot — it simply finds nothing.
+     */
+    register(base: string, entry: Omit<CraftPrimitiveEntry, 'address'>): {
+        readonly address: string;
+        readonly release: () => void;
+    };
+    list(): readonly CraftPrimitiveEntry[];
+    get(address: string): CraftPrimitiveEntry | undefined;
+    /**
+     * Every entry whose host-tag chain starts with `hostTags` — the primitives a
+     * given host owns, transitively. An empty prefix matches the whole app.
+     */
+    under(hostTags: readonly string[]): readonly CraftPrimitiveEntry[];
+    /**
+     * Reads the current value of the given entries. A primitive that throws on
+     * read (a suspended resource, a computation in error) contributes nothing
+     * rather than failing the whole capture.
+     */
+    capture(entries?: readonly CraftPrimitiveEntry[]): CraftPrimitiveSnapshot;
+    /**
+     * Writes a captured snapshot back. Addresses the registry no longer knows
+     * are skipped: a row that has been destroyed since the capture has nothing
+     * to restore into.
+     */
+    restore(snapshot: CraftPrimitiveSnapshot): void;
+    /**
+     * Restores current entries and remembers future ones. Used by hydration,
+     * where primitives are constructed during the first component render.
+     */
+    prime(snapshot: CraftPrimitiveSnapshot): void;
+}
+export declare const CRAFT_PRIMITIVE_REGISTRY: InjectionToken<CraftPrimitiveRegistry>;
+/** Builds the address of a primitive from its host chain and its own name. */
+export declare function ɵcraftPrimitiveAddress(hostTags: readonly string[], kind: CraftPrimitiveKind, name: string): string;
+type RegisterOptions = Readonly<{
+    kind: CraftPrimitiveKind;
+    name: string;
+    read(): unknown;
+    write(value: unknown): void;
+    reload?(): boolean;
+    status?(): string;
+    error?(): unknown;
+    /** Resolved from the ambient injection context when omitted. */
+    injector?: Injector;
+}>;
+/** What a primitive gets back from registering itself. */
+export type CraftPrimitiveRegistration = Readonly<{
+    /** Associates the public ref with this registration. */
+    link(ref: unknown): void;
+}>;
+/**
+ * Registers a primitive instance so tooling can read and write it by address.
+ * Called by the primitives themselves at creation; a no-op when no injection
+ * context is available, so a primitive built outside one keeps working.
+ */
+export declare function ɵregisterCraftPrimitive(options: RegisterOptions): CraftPrimitiveRegistration;
+export {};
+//# sourceMappingURL=craft-primitive-registry.d.ts.map

package/src/lib/craft-primitive-registry.d.ts.map

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