@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-register-for.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-register-for.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-register-for.ts"],"names":[],"mappings":"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","sourcesContent":["import { HOST_TAG_LIST } from './host-tag';\nimport {\n  getServiceMetaData,\n  type GetServiceReferenceMeta,\n  type GetServiceReferenceOutput,\n  type ServiceReference,\n} from './craft-service';\nimport {\n  CRAFT_REGISTRATION_TARGET,\n  createRegisterForRegistry,\n  REGISTER_FOR_REGISTRY,\n  registerResolvedService,\n  type CraftRegistrationTarget,\n  type RegisterForEntry,\n  type RegisterForRegistry,\n  type RegisterForSignal,\n  type RegisterForTargetDescriptor,\n} from './craft-register-for-runtime';\nimport {\n  isGenerator,\n  provideServiceYieldWrapper,\n} from './craft-generator-runtime';\nimport { provideCraftTargetWrapper } from './craft-target-runtime';\nimport {\n  assertInInjectionContext,\n  inject,\n  InjectionToken,\n  Injector,\n  type Provider,\n} from './host/craft-compat';\n\nexport {\n  CRAFT_REGISTRATION_TARGET,\n  REGISTER_FOR_REGISTRY,\n  type CraftRegistrationTarget,\n  type RegisterForEntry,\n  type RegisterForRegistry,\n  type RegisterForSignal,\n};\n\nexport type RegisterForOptions = Readonly<{\n  /** Track global services resolved below this register. Defaults to true. */\n  includeGlobal?: boolean;\n}>;\n\nexport type RegisterForExposureTokens<Value> = Readonly<{\n  /** The complete live signal for the selected register group. */\n  $self: RegisterForSignal<Value>;\n}>;\n\nexport type RegisterForExposureSelector<Value, Exposed> = (\n  tokens: RegisterForExposureTokens<Value>,\n) => Exposed | Generator<unknown, Exposed, unknown>;\n\ntype AnyRegisterTarget = ServiceReference | CraftRegistrationTarget;\n\ntype TargetName<Target> = Target extends ServiceReference\n  ? GetServiceReferenceMeta<Target>['name']\n  : Target extends CraftRegistrationTarget<infer Name, any, any>\n    ? Name\n    : never;\n\ntype TargetReference<Target> = Target extends ServiceReference\n  ? GetServiceReferenceOutput<Target>\n  : Target extends CraftRegistrationTarget<any, any, infer Instance>\n    ? Instance\n    : never;\n\ntype TargetNames<Targets extends readonly AnyRegisterTarget[]> = Extract<\n  TargetName<Targets[number]>,\n  string\n>;\n\ntype GroupKey<Name extends string> = Capitalize<Name>;\n\ntype SignalForTarget<Target> = RegisterForSignal<TargetReference<Target>>;\n\ntype RegisterForProjectionResult<Result> =\n  Result extends Generator<infer Yielded, infer Output, unknown>\n    ? { yielded: Yielded; output: Output }\n    : { yielded: never; output: Result };\n\ntype RegisterForDirectValue<Value, Derived> = RegisterForSignal<Value> &\n  ([Derived] extends [never] ? {} : Derived);\n\ntype RegisterForTargetHelper<Value, Derived = never> = {\n  (): Generator<never, RegisterForDirectValue<Value, Derived>, unknown>;\n  <Projection extends (tokens: RegisterForExposureTokens<Value>) => unknown>(\n    bindings: undefined,\n    expose: Projection,\n  ): Generator<\n    RegisterForProjectionResult<ReturnType<Projection>>['yielded'],\n    RegisterForProjectionResult<ReturnType<Projection>>['output'],\n    unknown\n  >;\n};\n\ntype RegisterForAdditionalGroups<Targets extends readonly AnyRegisterTarget[]> =\n  Targets extends readonly [AnyRegisterTarget, ...infer Rest]\n    ? {\n        [Name in TargetNames<\n          readonly [Extract<Rest[number], AnyRegisterTarget>]\n        > as GroupKey<Name>]: RegisterForTargetHelper<\n          TargetReference<\n            TargetForKey<\n              Extract<Rest[number], AnyRegisterTarget>[],\n              GroupKey<Name>\n            >\n          >\n        >;\n      }\n    : Record<never, never>;\n\ntype TargetForKey<\n  Targets extends readonly AnyRegisterTarget[],\n  Key extends string,\n> = Targets[number] extends infer Target\n  ? Target extends AnyRegisterTarget\n    ? GroupKey<Extract<TargetName<Target>, string>> extends Key\n      ? Target\n      : never\n    : never\n  : never;\n\nexport type RegisterForGroups<Targets extends readonly AnyRegisterTarget[]> = {\n  [Name in TargetNames<Targets> as GroupKey<Name>]: SignalForTarget<\n    TargetForKey<Targets, GroupKey<Name>>\n  >;\n};\n\ntype RegisterForDerivedHelper<Derived> = [Derived] extends [never]\n  ? Record<never, never>\n  : {\n      [Name in Extract<keyof Derived, string>]: () => Generator<\n        never,\n        Derived[Name],\n        unknown\n      >;\n    };\n\ntype RegisterForHelper<\n  Targets extends readonly AnyRegisterTarget[],\n  Derived = never,\n> = Targets extends readonly [infer Primary, ...unknown[]]\n  ? Primary extends AnyRegisterTarget\n    ? RegisterForTargetHelper<TargetReference<Primary>, Derived> &\n        RegisterForAdditionalGroups<Targets> &\n        RegisterForDerivedHelper<Derived>\n    : never\n  : never;\n\nexport type CraftRegisterForApi<\n  RegistryName extends string,\n  Targets extends readonly AnyRegisterTarget[],\n  Derived = never,\n> = Readonly<\n  {\n    [Name in `RegisterFor${Capitalize<RegistryName>}`]: RegisterForHelper<\n      Targets,\n      Derived\n    >;\n  } & {\n    [Name in `provideRegisterFor${Capitalize<RegistryName>}`]: () => Provider[];\n  }\n>;\n\nexport type RegisterForDerivedSelector<\n  Targets extends readonly AnyRegisterTarget[],\n  Derived extends object,\n> = (groups: RegisterForGroups<Targets>) => Derived;\n\n/**\n * Creates a typed, DI-scoped view of live Craft service/component/directive\n * instances. The returned helper is yieldable from Craft factories.\n */\nexport function craftRegisterFor<\n  const RegistryName extends string,\n  const Targets extends readonly AnyRegisterTarget[],\n  const Derived extends object,\n>(\n  registryName: RegistryName,\n  targets: Targets,\n  derive: RegisterForDerivedSelector<Targets, Derived>,\n): CraftRegisterForApi<RegistryName, Targets, Derived>;\nexport function craftRegisterFor<\n  const RegistryName extends string,\n  const Target extends AnyRegisterTarget,\n  const Derived extends object,\n>(\n  registryName: RegistryName,\n  target: Target,\n  derive: RegisterForDerivedSelector<readonly [Target], Derived>,\n): CraftRegisterForApi<RegistryName, readonly [Target], Derived>;\nexport function craftRegisterFor<\n  const RegistryName extends string,\n  const Targets extends readonly AnyRegisterTarget[],\n>(\n  registryName: RegistryName,\n  targets: Targets,\n  options?: RegisterForOptions,\n): CraftRegisterForApi<RegistryName, Targets>;\nexport function craftRegisterFor<\n  const RegistryName extends string,\n  const Target extends AnyRegisterTarget,\n>(\n  registryName: RegistryName,\n  target: Target,\n  options?: RegisterForOptions,\n): CraftRegisterForApi<RegistryName, readonly [Target]>;\nexport function craftRegisterFor(\n  registryName: string,\n  targetsOrTarget: readonly AnyRegisterTarget[] | AnyRegisterTarget,\n  optionsOrDerive:\n    | RegisterForOptions\n    | ((groups: Record<string, RegisterForSignal>) => object) = {},\n): CraftRegisterForApi<string, readonly AnyRegisterTarget[], object> {\n  const targets: readonly AnyRegisterTarget[] = Array.isArray(targetsOrTarget)\n    ? targetsOrTarget\n    : [targetsOrTarget];\n  return createCraftRegisterFor(registryName, targets, optionsOrDerive);\n}\n\nfunction createCraftRegisterFor(\n  registryName: string,\n  targets: readonly AnyRegisterTarget[],\n  optionsOrDerive:\n    | RegisterForOptions\n    | ((groups: Record<string, RegisterForSignal>) => object),\n): CraftRegisterForApi<string, readonly AnyRegisterTarget[], object> {\n  if (!registryName) {\n    throw new Error('craftRegisterFor requires a non-empty registry name.');\n  }\n  if (targets.length === 0) {\n    throw new Error('craftRegisterFor requires at least one target.');\n  }\n\n  const descriptors = targets.map(toDescriptor);\n  assertUniqueDescriptorKeys(descriptors);\n  const derive =\n    typeof optionsOrDerive === 'function' ? optionsOrDerive : undefined;\n  const options = typeof optionsOrDerive === 'function' ? {} : optionsOrDerive;\n  const includeGlobal = options.includeGlobal ?? true;\n  const registryToken = new InjectionToken<RegisterForRegistry>(\n    `REGISTER_FOR_REGISTRY_${registryName}`,\n  );\n  const registerForName = `RegisterFor${capitalize(registryName)}`;\n  const provideRegisterForName = `provideRegisterFor${capitalize(\n    registryName,\n  )}`;\n  const derivedByInjector = new WeakMap<Injector, Record<string, unknown>>();\n\n  const createTargetHelper = (\n    descriptor: RegisterForTargetDescriptor,\n    exposeDerived: boolean,\n  ) =>\n    function* (\n      _bindings?: undefined,\n      expose?: (tokens: RegisterForExposureTokens<unknown>) => unknown,\n    ) {\n      const value = requireRegistry().signalFor(descriptor.key);\n      if (expose === undefined) {\n        return exposeDerived ? extendWithDerived(value) : value;\n      }\n\n      const exposed = expose({ $self: value });\n      if (isGenerator(exposed)) {\n        return yield* exposed as Generator<unknown, unknown, unknown>;\n      }\n      return exposed;\n    };\n\n  const helper = createTargetHelper(descriptors[0]!, true) as RegisterForHelper<\n    readonly [AnyRegisterTarget],\n    object\n  >;\n  for (const descriptor of descriptors.slice(1)) {\n    Object.defineProperty(helper, descriptor.key, {\n      value: createTargetHelper(descriptor, false),\n      enumerable: false,\n    });\n  }\n\n  const registerFor = new Proxy(helper, {\n    get(target, property, receiver) {\n      const value = Reflect.get(target, property, receiver);\n      if (\n        value !== undefined ||\n        typeof property !== 'string' ||\n        derive === undefined ||\n        property === 'then'\n      ) {\n        return value;\n      }\n\n      return function* () {\n        const derived = getDerivedForCurrentInjector();\n        if (!Object.prototype.hasOwnProperty.call(derived, property)) {\n          throw new Error(`Unknown RegisterFor property \"${property}\".`);\n        }\n        return derived[property];\n      };\n    },\n  }) as RegisterForHelper<readonly [AnyRegisterTarget], object>;\n\n  function extendWithDerived<Value>(\n    value: RegisterForSignal<Value>,\n  ): RegisterForDirectValue<Value, object> {\n    if (derive === undefined) {\n      return value as RegisterForDirectValue<Value, object>;\n    }\n\n    const derived = getDerivedForCurrentInjector();\n    return new Proxy(value, {\n      get(target, property, receiver) {\n        if (\n          typeof property === 'string' &&\n          Object.prototype.hasOwnProperty.call(derived, property)\n        ) {\n          return derived[property];\n        }\n        return Reflect.get(target, property, receiver);\n      },\n    }) as RegisterForDirectValue<Value, object>;\n  }\n\n  const provideRegisterFor = (): Provider[] => {\n    const registryProvider: Provider = {\n      provide: registryToken,\n      useFactory: () =>\n        createRegisterForRegistry(descriptors, { includeGlobal }),\n    };\n    const registryCollectionProvider: Provider = {\n      provide: REGISTER_FOR_REGISTRY,\n      useExisting: registryToken,\n      multi: true,\n    };\n    const targetWrapper = provideCraftTargetWrapper(\n      'Warning: dependency injection here is not type-safe and may fail at runtime',\n      function* (context, next) {\n        const registry = context.injector.get(registryToken, null);\n        if (registry === null) {\n          return yield* next();\n        }\n\n        const release = registry.registerTarget(\n          context.target,\n          context.ref,\n          context.hostName,\n        );\n        const downstreamRelease = yield* next();\n\n        return () => {\n          downstreamRelease();\n          release();\n        };\n      },\n    );\n    const yieldWrapper = provideServiceYieldWrapper(\n      'Register Craft service yields for craftRegisterFor.',\n      function* (context, next) {\n        const ref = yield* next();\n        if (context.providedIn !== 'global' || includeGlobal) {\n          const hostTags = context.injector.get(HOST_TAG_LIST, []);\n          registerResolvedService(\n            context.injector,\n            context.name,\n            ref,\n            hostTags[hostTags.length - 1] ?? `service:${context.name}`,\n            context.providedIn,\n          );\n        }\n        return ref;\n      },\n    );\n\n    return [\n      registryProvider,\n      registryCollectionProvider,\n      targetWrapper,\n      yieldWrapper,\n    ];\n  };\n\n  return {\n    [registerForName]: registerFor,\n    [provideRegisterForName]: provideRegisterFor,\n  } as unknown as CraftRegisterForApi<\n    string,\n    readonly AnyRegisterTarget[],\n    object\n  >;\n\n  function getDerivedForCurrentInjector(): Record<string, unknown> {\n    if (derive === undefined) {\n      return {};\n    }\n\n    const injector = currentInjector();\n    const cached = derivedByInjector.get(injector);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const groups = {} as Record<string, RegisterForSignal>;\n    const registry = requireRegistry();\n    for (const descriptor of descriptors) {\n      groups[descriptor.key] = registry.signalFor(descriptor.key);\n    }\n\n    const derived = derive(groups);\n    if (isGenerator(derived)) {\n      throw new Error(\n        'craftRegisterFor derived properties must be returned synchronously.',\n      );\n    }\n\n    const result = derived as Record<string, unknown>;\n    derivedByInjector.set(injector, result);\n    return result;\n  }\n\n  function requireRegistry(): RegisterForRegistry {\n    throwIfNoInjectionContext();\n    const registry = currentInjector().get(registryToken, null);\n    if (registry === null) {\n      throw new Error(\n        `${registerForName} requires ${provideRegisterForName}() in the current Craft injector.`,\n      );\n    }\n    return registry;\n  }\n}\n\nfunction toDescriptor(target: AnyRegisterTarget): RegisterForTargetDescriptor {\n  try {\n    const service = getServiceMetaData(target);\n    return {\n      key: capitalize(service.name),\n      matches(candidate) {\n        return isServiceCandidate(candidate) && candidate.name === service.name;\n      },\n    };\n  } catch {\n    const metadata = (\n      target as {\n        readonly [CRAFT_REGISTRATION_TARGET]?: {\n          readonly name: string;\n        };\n      }\n    )[CRAFT_REGISTRATION_TARGET];\n    if (!metadata) {\n      throw new Error(\n        'craftRegisterFor only accepts Craft services, components, and directives.',\n      );\n    }\n\n    return {\n      key: capitalize(metadata.name),\n      matches(candidate) {\n        return candidate === target;\n      },\n    };\n  }\n}\n\nfunction assertUniqueDescriptorKeys(\n  descriptors: readonly RegisterForTargetDescriptor[],\n): void {\n  const seen = new Set<string>();\n  for (const descriptor of descriptors) {\n    if (seen.has(descriptor.key)) {\n      throw new Error(\n        `craftRegisterFor cannot contain duplicate group name \"${descriptor.key}\".`,\n      );\n    }\n    seen.add(descriptor.key);\n  }\n}\n\nfunction isServiceCandidate(\n  candidate: unknown,\n): candidate is { readonly kind: 'service'; readonly name: string } {\n  return (\n    typeof candidate === 'object' &&\n    candidate !== null &&\n    Reflect.get(candidate, 'kind') === 'service' &&\n    typeof Reflect.get(candidate, 'name') === 'string'\n  );\n}\n\nfunction capitalize(value: string): string {\n  return value ? value.charAt(0).toUpperCase() + value.slice(1) : value;\n}\n\nfunction throwIfNoInjectionContext(): void {\n  assertInInjectionContext(throwIfNoInjectionContext);\n}\n\nfunction currentInjector() {\n  return inject(Injector);\n}\n"]}

package/src/lib/craft-render-identity.d.ts

@@ -0,0 +1,19 @@
+/** A deterministic address for one node in a Craft render tree. */
+export type CraftRenderIdentity = Readonly<{
+    path: readonly string[];
+    hydrationKey: string;
+}>;
+/**
+ * Identity of the component currently being created.
+ *
+ * This deliberately lives beside, rather than inside, HOST_TAG_LIST: host tags
+ * remain runtime/debug identities while hydration identities must be stable
+ * across two different processes.
+ */
+export declare const CRAFT_HYDRATION_ID: import("..").CraftToken<Readonly<{
+    path: readonly string[];
+    hydrationKey: string;
+}>>;
+export declare function createCraftRenderIdentity(path: readonly (string | number)[]): CraftRenderIdentity;
+export declare function childCraftRenderIdentity(parent: CraftRenderIdentity, ...segments: readonly (string | number)[]): CraftRenderIdentity;
+//# sourceMappingURL=craft-render-identity.d.ts.map

package/src/lib/craft-render-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-render-identity.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-render-identity.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;UAXvB,SAAS,MAAM,EAAE;kBACT,MAAM;GAW+B,CAAC;AAEtD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,mBAAmB,CAMrB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACxC,mBAAmB,CAErB"}

package/src/lib/craft-render-identity.js

@@ -0,0 +1,23 @@
+import { craftToken } from './host/craft-injector';
+/**
+ * Identity of the component currently being created.
+ *
+ * This deliberately lives beside, rather than inside, HOST_TAG_LIST: host tags
+ * remain runtime/debug identities while hydration identities must be stable
+ * across two different processes.
+ */
+export const CRAFT_HYDRATION_ID = craftToken('CraftHydrationId');
+export function createCraftRenderIdentity(path) {
+    const normalized = path.map(String);
+    return {
+        path: normalized,
+        hydrationKey: normalized.map(encodeHydrationSegment).join('/'),
+    };
+}
+export function childCraftRenderIdentity(parent, ...segments) {
+    return createCraftRenderIdentity([...parent.path, ...segments]);
+}
+function encodeHydrationSegment(segment) {
+    return encodeURIComponent(segment).replaceAll('%2F', '%252F');
+}
+//# sourceMappingURL=craft-render-identity.js.map

package/src/lib/craft-render-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-render-identity.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-render-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,UAAU,CAAsB,kBAAkB,CAAC,CAAC;AAEtD,MAAM,UAAU,yBAAyB,CACvC,IAAkC;IAElC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA2B,EAC3B,GAAG,QAAsC;IAEzC,OAAO,yBAAyB,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe;IAC7C,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import { craftToken } from './host/craft-injector';\n\n/** A deterministic address for one node in a Craft render tree. */\nexport type CraftRenderIdentity = Readonly<{\n  path: readonly string[];\n  hydrationKey: string;\n}>;\n\n/**\n * Identity of the component currently being created.\n *\n * This deliberately lives beside, rather than inside, HOST_TAG_LIST: host tags\n * remain runtime/debug identities while hydration identities must be stable\n * across two different processes.\n */\nexport const CRAFT_HYDRATION_ID =\n  craftToken<CraftRenderIdentity>('CraftHydrationId');\n\nexport function createCraftRenderIdentity(\n  path: readonly (string | number)[],\n): CraftRenderIdentity {\n  const normalized = path.map(String);\n  return {\n    path: normalized,\n    hydrationKey: normalized.map(encodeHydrationSegment).join('/'),\n  };\n}\n\nexport function childCraftRenderIdentity(\n  parent: CraftRenderIdentity,\n  ...segments: readonly (string | number)[]\n): CraftRenderIdentity {\n  return createCraftRenderIdentity([...parent.path, ...segments]);\n}\n\nfunction encodeHydrationSegment(segment: string): string {\n  return encodeURIComponent(segment).replaceAll('%2F', '%252F');\n}\n"]}

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

@@ -0,0 +1,5 @@
+/** `true` while a recorded state is being restored. */
+export declare function isCraftReplaying(): boolean;
+/** Runs `restore` with {@link isCraftReplaying} reporting `true`. */
+export declare function ɵwithCraftReplay<Result>(restore: () => Result): Result;
+//# sourceMappingURL=craft-replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-replay.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-replay.ts"],"names":[],"mappings":"AAcA,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM,CAOtE"}

package/src/lib/craft-replay.js

@@ -0,0 +1,28 @@
+/**
+ * Whether the application is currently restoring a recorded state.
+ *
+ * A replay writes values straight into primitives. Two things must know about
+ * it: a resource loader, which would otherwise refetch and overwrite the value
+ * just restored, and tooling, which would otherwise log a rewind as ordinary
+ * user activity.
+ *
+ * The flag is a synchronous ambient because a restore IS synchronous — the
+ * reactive graph flushes inside the write, so a loader triggered by a restored
+ * parameter runs before the restore returns.
+ */
+let replayDepth = 0;
+/** `true` while a recorded state is being restored. */
+export function isCraftReplaying() {
+    return replayDepth > 0;
+}
+/** Runs `restore` with {@link isCraftReplaying} reporting `true`. */
+export function ɵwithCraftReplay(restore) {
+    replayDepth += 1;
+    try {
+        return restore();
+    }
+    finally {
+        replayDepth -= 1;
+    }
+}
+//# sourceMappingURL=craft-replay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-replay.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,uDAAuD;AACvD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,WAAW,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAS,OAAqB;IAC5D,WAAW,IAAI,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,WAAW,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Whether the application is currently restoring a recorded state.\n *\n * A replay writes values straight into primitives. Two things must know about\n * it: a resource loader, which would otherwise refetch and overwrite the value\n * just restored, and tooling, which would otherwise log a rewind as ordinary\n * user activity.\n *\n * The flag is a synchronous ambient because a restore IS synchronous — the\n * reactive graph flushes inside the write, so a loader triggered by a restored\n * parameter runs before the restore returns.\n */\nlet replayDepth = 0;\n\n/** `true` while a recorded state is being restored. */\nexport function isCraftReplaying(): boolean {\n  return replayDepth > 0;\n}\n\n/** Runs `restore` with {@link isCraftReplaying} reporting `true`. */\nexport function ɵwithCraftReplay<Result>(restore: () => Result): Result {\n  replayDepth += 1;\n  try {\n    return restore();\n  } finally {\n    replayDepth -= 1;\n  }\n}\n"]}

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

@@ -0,0 +1,39 @@
+import type { ActivatedRouteSnapshot, RouterStateSnapshot } from './host/craft-router-types';
+import type { StripCraftException } from './craft-exception';
+/**
+ * The optional data step of a craft route. Mirrors a route's `canActivate` guard
+ * but yields a value rather than a guard decision: it `yield*`s craft services and
+ * `yield* craftUntilSettled(...)`, then returns the data the target component reads
+ * through the generated `injectXxxResolvedData()` helper.
+ *
+ * Like the guards, it carries no inline exception handling — any `craftException`
+ * it produces flows into the route's exhaustive `handleExceptions` map, and the
+ * non-blocking {@link CraftRouterOutletController} drives it after the URL
+ * commits (so the
+ * target is rendered only once the data resolves).
+ *
+ * ```ts
+ * resolve: craftResolve(function* () {
+ *   return yield* craftUntilSettled(CraftHttpClient.get<Profile>('/api/profile'));
+ * }),
+ * ```
+ */
+export type CraftResolveFn = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Generator<unknown, unknown, unknown>;
+type CraftResolveYielded<Fn> = Fn extends (...args: any[]) => Generator<infer Yielded, any, any> ? Yielded : never;
+type CraftResolveReturn<Fn> = Fn extends (...args: any[]) => Generator<any, infer Output, any> ? Output : never;
+/**
+ * The resolver returned by {@link craftResolve}. Its generator `Yielded`
+ * preserves the resolve body's dependency requests *and* its
+ * `CraftGenExceptionMarker`s (so route DI tracking and `handleExceptions`
+ * exhaustiveness both see them); its return is the success value (exceptions
+ * stripped) surfaced to `injectXxxResolvedData`.
+ */
+export type CraftResolveResultFn<Fn> = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Generator<CraftResolveYielded<Fn>, StripCraftException<CraftResolveReturn<Fn>>, unknown>;
+/**
+ * Packages a resolve generator for the route's `resolve` field. Identity at
+ * runtime (the outlet drives the generator); the precise return type carries the
+ * resolved data + reachable exceptions for the route's type machinery.
+ */
+export declare function craftResolve<Fn extends CraftResolveFn>(resolveFn: Fn): CraftResolveResultFn<Fn>;
+export {};
+//# sourceMappingURL=craft-resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resolve.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,mBAAmB,KACvB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE1C,KAAK,mBAAmB,CAAC,EAAE,IAAI,EAAE,SAAS,CACxC,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,SAAS,CAAC,MAAM,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GACnC,OAAO,GACP,KAAK,CAAC;AAEV,KAAK,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,CACvC,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,SAAS,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,CAAC,GAClC,MAAM,GACN,KAAK,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,EAAE,IAAI,CACrC,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,mBAAmB,KACvB,SAAS,CACZ,mBAAmB,CAAC,EAAE,CAAC,EACvB,mBAAmB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAC3C,OAAO,CACR,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,cAAc,EACpD,SAAS,EAAE,EAAE,GACZ,oBAAoB,CAAC,EAAE,CAAC,CAE1B"}

package/src/lib/craft-resolve.js

@@ -0,0 +1,9 @@
+/**
+ * Packages a resolve generator for the route's `resolve` field. Identity at
+ * runtime (the outlet drives the generator); the precise return type carries the
+ * resolved data + reachable exceptions for the route's type machinery.
+ */
+export function craftResolve(resolveFn) {
+    return resolveFn;
+}
+//# sourceMappingURL=craft-resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resolve.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-resolve.ts"],"names":[],"mappings":"AAsDA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAa;IAEb,OAAO,SAAgD,CAAC;AAC1D,CAAC","sourcesContent":["import type { ActivatedRouteSnapshot, RouterStateSnapshot } from './host/craft-router-types';\nimport type { StripCraftException } from './craft-exception';\n\n/**\n * The optional data step of a craft route. Mirrors a route's `canActivate` guard\n * but yields a value rather than a guard decision: it `yield*`s craft services and\n * `yield* craftUntilSettled(...)`, then returns the data the target component reads\n * through the generated `injectXxxResolvedData()` helper.\n *\n * Like the guards, it carries no inline exception handling — any `craftException`\n * it produces flows into the route's exhaustive `handleExceptions` map, and the\n * non-blocking {@link CraftRouterOutletController} drives it after the URL\n * commits (so the\n * target is rendered only once the data resolves).\n *\n * ```ts\n * resolve: craftResolve(function* () {\n *   return yield* craftUntilSettled(CraftHttpClient.get<Profile>('/api/profile'));\n * }),\n * ```\n */\nexport type CraftResolveFn = (\n  route: ActivatedRouteSnapshot,\n  state: RouterStateSnapshot,\n) => Generator<unknown, unknown, unknown>;\n\ntype CraftResolveYielded<Fn> = Fn extends (\n  ...args: any[]\n) => Generator<infer Yielded, any, any>\n  ? Yielded\n  : never;\n\ntype CraftResolveReturn<Fn> = Fn extends (\n  ...args: any[]\n) => Generator<any, infer Output, any>\n  ? Output\n  : never;\n\n/**\n * The resolver returned by {@link craftResolve}. Its generator `Yielded`\n * preserves the resolve body's dependency requests *and* its\n * `CraftGenExceptionMarker`s (so route DI tracking and `handleExceptions`\n * exhaustiveness both see them); its return is the success value (exceptions\n * stripped) surfaced to `injectXxxResolvedData`.\n */\nexport type CraftResolveResultFn<Fn> = (\n  route: ActivatedRouteSnapshot,\n  state: RouterStateSnapshot,\n) => Generator<\n  CraftResolveYielded<Fn>,\n  StripCraftException<CraftResolveReturn<Fn>>,\n  unknown\n>;\n\n/**\n * Packages a resolve generator for the route's `resolve` field. Identity at\n * runtime (the outlet drives the generator); the precise return type carries the\n * resolved data + reachable exceptions for the route's type machinery.\n */\nexport function craftResolve<Fn extends CraftResolveFn>(\n  resolveFn: Fn,\n): CraftResolveResultFn<Fn> {\n  return resolveFn as unknown as CraftResolveResultFn<Fn>;\n}\n"]}

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

@@ -0,0 +1,11 @@
+import { type ResourceLoaderParams, type ResourceOptions } from './host/craft-compat';
+import { CraftResourceRef } from './util/craft-resource-ref';
+type CraftResourceOptions<Value, Params> = Omit<ResourceOptions<Value, Params>, 'loader' | 'stream'> & {
+    loader?: (params: ResourceLoaderParams<Params>) => Value | PromiseLike<Value>;
+    stream?: ResourceOptions<Value, Params>['stream'];
+    /** @internal Source name used by the server policy gate. */
+    ssrSourceName?: string;
+};
+export declare function craftResource<Value, Params>(options: CraftResourceOptions<Value, Params>): CraftResourceRef<Value, Params>;
+export {};
+//# sourceMappingURL=craft-resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EAIrB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAK7D,KAAK,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI,IAAI,CAC7C,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9B,QAAQ,GAAG,QAAQ,CACpB,GAAG;IACF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EACzC,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC3C,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAwRjC"}

package/src/lib/craft-resource.js

@@ -0,0 +1,264 @@
+import { DestroyRef, effect, inject, Injector, } from './host/craft-compat';
+import { craftBatch, craftComputed, craftSignal, craftWatch, untracked, } from './host/craft-signal';
+import { isCraftReplaying } from './craft-replay';
+import { ɵcraftInjectorFromHost } from './host/craft-injector-host';
+import { CRAFT_PLATFORM } from './craft-platform';
+export function craftResource(options) {
+    const injector = ɵcraftInjectorFromHost(options.injector ?? inject(Injector));
+    const valueState = craftSignal(options.defaultValue, {
+        equal: options.equal,
+    });
+    const statusState = craftSignal('idle');
+    const errorState = craftSignal(undefined);
+    const isLoading = craftComputed(() => {
+        const status = statusState();
+        return status === 'loading' || status === 'reloading';
+    });
+    let currentParams;
+    let hasCurrentParams = false;
+    let destroyed = false;
+    let requestVersion = 0;
+    let abortController;
+    let stopStream;
+    const finishWithError = (version, error) => {
+        if (destroyed || version !== requestVersion)
+            return;
+        craftBatch(() => {
+            valueState.set(undefined);
+            errorState.set(error instanceof Error ? error : new Error(String(error)));
+            statusState.set('error');
+        });
+    };
+    const startLoad = (params, reload) => {
+        abortController?.abort();
+        stopStream?.();
+        stopStream = undefined;
+        const controller = new AbortController();
+        abortController = controller;
+        const version = ++requestVersion;
+        const previousStatus = statusState();
+        // One transition, one notification. These writes describe a single state,
+        // and every write notifies synchronously — a reader let in between them
+        // sees a resource half in its old state and half in its new one, and code
+        // it wakes (a cache restoring a value, say) is then overwritten by the
+        // rest of this very function.
+        craftBatch(() => {
+            errorState.set(undefined);
+            if (reload && valueState() !== undefined) {
+                statusState.set('reloading');
+            }
+            else {
+                statusState.set('loading');
+                valueState.set(options.defaultValue);
+            }
+        });
+        const loaderParams = {
+            params: params,
+            abortSignal: controller.signal,
+            previous: { status: previousStatus },
+        };
+        if (options.loader) {
+            let result;
+            try {
+                result = options.loader(loaderParams);
+            }
+            catch (error) {
+                finishWithError(version, error);
+                return;
+            }
+            Promise.resolve(result).then((value) => {
+                if (destroyed ||
+                    controller.signal.aborted ||
+                    version !== requestVersion) {
+                    return;
+                }
+                craftBatch(() => {
+                    valueState.set(value);
+                    statusState.set('resolved');
+                });
+            }, (error) => finishWithError(version, error));
+            return;
+        }
+        if (options.stream) {
+            Promise.resolve(options.stream(loaderParams)).then((stream) => {
+                if (destroyed ||
+                    controller.signal.aborted ||
+                    version !== requestVersion) {
+                    return;
+                }
+                const streamEffect = effect(() => {
+                    const item = typeof stream === 'function'
+                        ? stream()
+                        : { value: undefined };
+                    if (!item) {
+                        return;
+                    }
+                    if ('error' in item) {
+                        finishWithError(version, item.error);
+                    }
+                    else {
+                        craftBatch(() => {
+                            valueState.set(item.value);
+                            statusState.set('resolved');
+                        });
+                    }
+                }, { injector });
+                stopStream = () => streamEffect.destroy();
+            }, (error) => finishWithError(version, error));
+        }
+    };
+    const synchronizeParams = (params) => {
+        if (destroyed)
+            return;
+        if (hasCurrentParams && Object.is(currentParams, params))
+            return;
+        currentParams = params;
+        hasCurrentParams = true;
+        // A replay restores a parameter and the value that belongs to it as one
+        // pair. Claiming the parameter without loading is what `set` already does
+        // for a locally set value — "this value belongs to the params in force, do
+        // not reload over it" — and it is the same statement here.
+        if (isCraftReplaying())
+            return;
+        if (params === undefined) {
+            abortController?.abort();
+            ++requestVersion;
+            craftBatch(() => {
+                errorState.set(undefined);
+                if (statusState() !== 'local') {
+                    valueState.set(options.defaultValue);
+                    statusState.set('idle');
+                }
+            });
+            return;
+        }
+        startLoad(params, false);
+    };
+    // The params source is a craft signal like everything else, so one watch
+    // keeps the resource in step with it. This used to be an Angular linkedSignal,
+    // an effect reading it, and a craft watch underneath — three ways of noticing
+    // the same change, needed only while two reactive systems had to agree.
+    const startParamsWatch = () => options.params
+        ? craftWatch(() => {
+            const params = options.params();
+            untracked(() => synchronizeParams(params));
+        })
+        : undefined;
+    let paramsWatch;
+    const platform = injector.get(CRAFT_PLATFORM, null);
+    if (platform?.kind === 'server' &&
+        platform.serverResources &&
+        options.params &&
+        options.ssrSourceName) {
+        platform.serverResources.defer(options.ssrSourceName, () => {
+            if (!destroyed)
+                paramsWatch = startParamsWatch();
+        });
+    }
+    else if (platform?.hydrating && options.params) {
+        // The transfer registry is primed synchronously while the component tree
+        // is being created. Delaying only this first observation lets a restored
+        // query claim its params/value pair before a loader can issue a duplicate
+        // request. Subsequent param changes remain fully synchronous.
+        queueMicrotask(() => {
+            if (!destroyed)
+                paramsWatch = startParamsWatch();
+        });
+    }
+    else {
+        paramsWatch = startParamsWatch();
+    }
+    // Readers are the state signals themselves. They used to be wrappers that
+    // mirrored each value into an Angular signal AND re-synchronized the params on
+    // every read — a lazy pull that could restart a load from inside an unrelated
+    // read, wiping whatever was being written at the time.
+    const value = craftComputed(() => valueState());
+    const status = craftComputed(() => statusState());
+    const publicIsLoading = isLoading;
+    const error = craftComputed(() => errorState());
+    const snapshot = craftComputed(() => (status() === 'error'
+        ? { status: 'error', error: errorState() }
+        : { status: status(), value: value() }));
+    const destroy = () => {
+        if (destroyed)
+            return;
+        destroyed = true;
+        abortController?.abort();
+        stopStream?.();
+        ++requestVersion;
+        craftBatch(() => {
+            valueState.set(options.defaultValue);
+            errorState.set(undefined);
+            statusState.set('idle');
+        });
+        paramsWatch?.destroy();
+    };
+    const publish = (next, status) => {
+        abortController?.abort();
+        stopStream?.();
+        stopStream = undefined;
+        ++requestVersion;
+        // Claim the params before publishing: a locally set value belongs to the
+        // params in force, so the watch must not read the write back as a new
+        // request and reload over it.
+        if (options.params) {
+            currentParams = untracked(() => options.params());
+            hasCurrentParams = true;
+        }
+        craftBatch(() => {
+            valueState.set(next);
+            errorState.set(undefined);
+            statusState.set(status);
+        });
+    };
+    const set = (next) => publish(next, 'local');
+    /**
+     * Puts back a value the resource had produced itself, rather than one an
+     * application decided. `set` means "this is mine now" and marks the resource
+     * local, which detaches it from its loader for good; a restored value came
+     * FROM the loader, so it settles as resolved and the resource stays attached.
+     */
+    const restore = (next) => publish(next, 'resolved');
+    const update = (updater) => set(updater(untracked(valueState)));
+    const reload = () => {
+        if (destroyed || !hasCurrentParams || currentParams === undefined) {
+            return false;
+        }
+        startLoad(currentParams, true);
+        return true;
+    };
+    const resourceRef = {
+        value,
+        hasValue: () => status() !== 'error' && value() !== undefined,
+        snapshot,
+        status,
+        // Internal channel only: `error` is not part of the CraftResourceRef surface
+        // (replaced by the exceptions API) but stays on the object at runtime so
+        // `craftUntilSettled` can rethrow a residual technical failure.
+        error,
+        isLoading: publicIsLoading,
+        reload,
+        destroy,
+        update,
+        set,
+        restore,
+        asReadonly: () => resourceRef,
+        paramSrc: options.params,
+        state: value,
+    };
+    Object.defineProperties(resourceRef, {
+        __craftRawValue: {
+            value: valueState,
+            enumerable: false,
+            configurable: true,
+        },
+        __craftRawStatus: {
+            value: statusState,
+            enumerable: false,
+            configurable: true,
+        },
+    });
+    injector.get(DestroyRef).onDestroy(destroy);
+    return resourceRef;
+}
+//# sourceMappingURL=craft-resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-resource.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DestroyRef,\n  effect,\n  inject,\n  Injector,\n  type ResourceLoaderParams,\n  type ResourceOptions,\n  type ResourceSnapshot,\n  type ResourceStatus,\n  type Signal,\n} from './host/craft-compat';\nimport {\n  craftBatch,\n  craftComputed,\n  craftSignal,\n  craftWatch,\n  untracked,\n} from './host/craft-signal';\nimport { CraftResourceRef } from './util/craft-resource-ref';\nimport { isCraftReplaying } from './craft-replay';\nimport { ɵcraftInjectorFromHost } from './host/craft-injector-host';\nimport { CRAFT_PLATFORM, type CraftPlatform } from './craft-platform';\n\ntype CraftResourceOptions<Value, Params> = Omit<\n  ResourceOptions<Value, Params>,\n  'loader' | 'stream'\n> & {\n  loader?: (params: ResourceLoaderParams<Params>) => Value | PromiseLike<Value>;\n  stream?: ResourceOptions<Value, Params>['stream'];\n  /** @internal Source name used by the server policy gate. */\n  ssrSourceName?: string;\n};\n\nexport function craftResource<Value, Params>(\n  options: CraftResourceOptions<Value, Params>,\n): CraftResourceRef<Value, Params> {\n  const injector = ɵcraftInjectorFromHost(options.injector ?? inject(Injector));\n  const valueState = craftSignal<Value | undefined>(options.defaultValue, {\n    equal: options.equal as\n      | ((a: Value | undefined, b: Value | undefined) => boolean)\n      | undefined,\n  });\n  const statusState = craftSignal<ResourceStatus>('idle');\n  const errorState = craftSignal<Error | undefined>(undefined);\n  const isLoading = craftComputed(() => {\n    const status = statusState();\n    return status === 'loading' || status === 'reloading';\n  });\n  let currentParams: Params | undefined;\n  let hasCurrentParams = false;\n  let destroyed = false;\n  let requestVersion = 0;\n  let abortController: AbortController | undefined;\n  let stopStream: (() => void) | undefined;\n\n  const finishWithError = (version: number, error: unknown): void => {\n    if (destroyed || version !== requestVersion) return;\n    craftBatch(() => {\n      valueState.set(undefined);\n      errorState.set(error instanceof Error ? error : new Error(String(error)));\n      statusState.set('error');\n    });\n  };\n\n  const startLoad = (params: Params, reload: boolean): void => {\n    abortController?.abort();\n    stopStream?.();\n    stopStream = undefined;\n    const controller = new AbortController();\n    abortController = controller;\n    const version = ++requestVersion;\n    const previousStatus = statusState();\n    // One transition, one notification. These writes describe a single state,\n    // and every write notifies synchronously — a reader let in between them\n    // sees a resource half in its old state and half in its new one, and code\n    // it wakes (a cache restoring a value, say) is then overwritten by the\n    // rest of this very function.\n    craftBatch(() => {\n      errorState.set(undefined);\n      if (reload && valueState() !== undefined) {\n        statusState.set('reloading');\n      } else {\n        statusState.set('loading');\n        valueState.set(options.defaultValue);\n      }\n    });\n    const loaderParams: ResourceLoaderParams<Params> = {\n      params: params as Exclude<Params, undefined>,\n      abortSignal: controller.signal,\n      previous: { status: previousStatus },\n    };\n\n    if (options.loader) {\n      let result: Value | PromiseLike<Value>;\n      try {\n        result = options.loader(loaderParams);\n      } catch (error) {\n        finishWithError(version, error);\n        return;\n      }\n      Promise.resolve(result).then(\n        (value) => {\n          if (\n            destroyed ||\n            controller.signal.aborted ||\n            version !== requestVersion\n          ) {\n            return;\n          }\n          craftBatch(() => {\n            valueState.set(value);\n            statusState.set('resolved');\n          });\n        },\n        (error) => finishWithError(version, error),\n      );\n      return;\n    }\n\n    if (options.stream) {\n      Promise.resolve(options.stream(loaderParams)).then(\n        (stream) => {\n          if (\n            destroyed ||\n            controller.signal.aborted ||\n            version !== requestVersion\n          ) {\n            return;\n          }\n          const streamEffect = effect(\n            () => {\n              const item =\n                typeof stream === 'function'\n                  ? stream()\n                  : { value: undefined as Value };\n              if (!item) {\n                return;\n              }\n              if ('error' in item) {\n                finishWithError(version, item.error);\n              } else {\n                craftBatch(() => {\n                  valueState.set(item.value);\n                  statusState.set('resolved');\n                });\n              }\n            },\n            { injector },\n          );\n          stopStream = () => streamEffect.destroy();\n        },\n        (error) => finishWithError(version, error),\n      );\n    }\n  };\n\n  const synchronizeParams = (params: Params | undefined): void => {\n    if (destroyed) return;\n    if (hasCurrentParams && Object.is(currentParams, params)) return;\n    currentParams = params;\n    hasCurrentParams = true;\n    // A replay restores a parameter and the value that belongs to it as one\n    // pair. Claiming the parameter without loading is what `set` already does\n    // for a locally set value — \"this value belongs to the params in force, do\n    // not reload over it\" — and it is the same statement here.\n    if (isCraftReplaying()) return;\n    if (params === undefined) {\n      abortController?.abort();\n      ++requestVersion;\n      craftBatch(() => {\n        errorState.set(undefined);\n        if (statusState() !== 'local') {\n          valueState.set(options.defaultValue);\n          statusState.set('idle');\n        }\n      });\n      return;\n    }\n    startLoad(params, false);\n  };\n\n  // The params source is a craft signal like everything else, so one watch\n  // keeps the resource in step with it. This used to be an Angular linkedSignal,\n  // an effect reading it, and a craft watch underneath — three ways of noticing\n  // the same change, needed only while two reactive systems had to agree.\n  const startParamsWatch = () =>\n    options.params\n      ? craftWatch(() => {\n          const params = options.params!();\n          untracked(() => synchronizeParams(params));\n        })\n      : undefined;\n  let paramsWatch: ReturnType<typeof craftWatch> | undefined;\n  const platform = injector.get(CRAFT_PLATFORM, null) as CraftPlatform | null;\n  if (\n    platform?.kind === 'server' &&\n    platform.serverResources &&\n    options.params &&\n    options.ssrSourceName\n  ) {\n    platform.serverResources.defer(options.ssrSourceName, () => {\n      if (!destroyed) paramsWatch = startParamsWatch();\n    });\n  } else if (platform?.hydrating && options.params) {\n    // The transfer registry is primed synchronously while the component tree\n    // is being created. Delaying only this first observation lets a restored\n    // query claim its params/value pair before a loader can issue a duplicate\n    // request. Subsequent param changes remain fully synchronous.\n    queueMicrotask(() => {\n      if (!destroyed) paramsWatch = startParamsWatch();\n    });\n  } else {\n    paramsWatch = startParamsWatch();\n  }\n\n  // Readers are the state signals themselves. They used to be wrappers that\n  // mirrored each value into an Angular signal AND re-synchronized the params on\n  // every read — a lazy pull that could restart a load from inside an unrelated\n  // read, wiping whatever was being written at the time.\n  const value = craftComputed(() => valueState());\n  const status = craftComputed(() => statusState());\n  const publicIsLoading = isLoading;\n  const error = craftComputed(() => errorState());\n  const snapshot = craftComputed(\n    () =>\n      (status() === 'error'\n        ? { status: 'error', error: errorState() }\n        : { status: status(), value: value() }) as ResourceSnapshot<\n        Value | undefined\n      >,\n  );\n  const destroy = (): void => {\n    if (destroyed) return;\n    destroyed = true;\n    abortController?.abort();\n    stopStream?.();\n    ++requestVersion;\n    craftBatch(() => {\n      valueState.set(options.defaultValue);\n      errorState.set(undefined);\n      statusState.set('idle');\n    });\n    paramsWatch?.destroy();\n  };\n  const publish = (next: Value | undefined, status: ResourceStatus): void => {\n    abortController?.abort();\n    stopStream?.();\n    stopStream = undefined;\n    ++requestVersion;\n    // Claim the params before publishing: a locally set value belongs to the\n    // params in force, so the watch must not read the write back as a new\n    // request and reload over it.\n    if (options.params) {\n      currentParams = untracked(() => options.params!());\n      hasCurrentParams = true;\n    }\n    craftBatch(() => {\n      valueState.set(next);\n      errorState.set(undefined);\n      statusState.set(status);\n    });\n  };\n  const set = (next: Value | undefined): void => publish(next, 'local');\n  /**\n   * Puts back a value the resource had produced itself, rather than one an\n   * application decided. `set` means \"this is mine now\" and marks the resource\n   * local, which detaches it from its loader for good; a restored value came\n   * FROM the loader, so it settles as resolved and the resource stays attached.\n   */\n  const restore = (next: Value | undefined): void => publish(next, 'resolved');\n  const update = (\n    updater: (value: Value | undefined) => Value | undefined,\n  ): void => set(updater(untracked(valueState)));\n  const reload = (): boolean => {\n    if (destroyed || !hasCurrentParams || currentParams === undefined) {\n      return false;\n    }\n    startLoad(currentParams, true);\n    return true;\n  };\n\n  const resourceRef = {\n    value,\n    hasValue: () => status() !== 'error' && value() !== undefined,\n    snapshot,\n    status,\n    // Internal channel only: `error` is not part of the CraftResourceRef surface\n    // (replaced by the exceptions API) but stays on the object at runtime so\n    // `craftUntilSettled` can rethrow a residual technical failure.\n    error,\n    isLoading: publicIsLoading,\n    reload,\n    destroy,\n    update,\n    set,\n    restore,\n    asReadonly: () => resourceRef,\n    paramSrc: options.params as Signal<Params | undefined>,\n    state: value,\n  };\n  Object.defineProperties(resourceRef, {\n    __craftRawValue: {\n      value: valueState,\n      enumerable: false,\n      configurable: true,\n    },\n    __craftRawStatus: {\n      value: statusState,\n      enumerable: false,\n      configurable: true,\n    },\n  });\n\n  injector.get(DestroyRef).onDestroy(destroy);\n  return resourceRef as unknown as CraftResourceRef<Value, Params>;\n}\n"]}