@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-program-runtime.js

@@ -0,0 +1,166 @@
+import { computed, DestroyRef, runInInjectionContext, } from './host/craft-compat';
+import { toObservable } from './host/craft-compat';
+import { filter, take } from 'rxjs';
+import { CraftGenShortCircuit, isCraftGenShortCircuit } from './craft-gen';
+import { GUARD_AWAIT_REQUEST_MARKER, isGenerator, isGuardAwaitRequest, isServiceAppStartRequest, resolveCraftGeneratorYield, } from './craft-generator-runtime';
+import { injectFnWrapper } from './fn-wrapper';
+import { ɵcraftInjectorFromHost } from './host/craft-injector-host';
+import { CRAFT_TEMPORAL_RUNTIME, isTemporalAwaitRequest, RealCraftTemporalRuntime, TemporalCancelledError, } from './temporal-runtime';
+const FOREIGN_YIELD_OUTCOME = Symbol('foreign-yield-outcome');
+function isTaggedForeignYieldOutcome(value) {
+    return (typeof value === 'object' && value !== null && FOREIGN_YIELD_OUTCOME in value);
+}
+let foreignYieldBridge;
+/** Registers the bridge; returns a disposer restoring the previous one. */
+export function setForeignYieldBridge(bridge) {
+    const previous = foreignYieldBridge;
+    foreignYieldBridge = bridge;
+    return () => {
+        foreignYieldBridge = previous;
+    };
+}
+/** @deprecated Prototype spelling, kept for the wave-0 fixtures. */
+export const ɵsetForeignYieldBridge = setForeignYieldBridge;
+// Pumps `iterator` synchronously, resolving craft service yields, until it
+// completes, throws a `CraftGenShortCircuit` (caught and surfaced as the carried
+// exception), or yields an await-request — at which point the iterator is
+// left positioned right after the await so the caller can resume it once the
+// awaited value is available. `resumeValue` feeds the first `next(...)` (used to
+// resume after an await; ignored on the initial pump).
+export function pumpCraftProgramSync(iterator, injector, options, resumeValue) {
+    try {
+        // A resumed foreign yield either carries its value back into the generator
+        // or short-circuits here, so the exception lands on the regular
+        // `shortCircuit` step rather than surfacing as a thrown error.
+        let resumeWith = resumeValue;
+        if (isTaggedForeignYieldOutcome(resumeWith)) {
+            if (resumeWith.kind === 'exception') {
+                throw new CraftGenShortCircuit(resumeWith.exception);
+            }
+            resumeWith = resumeWith.value;
+        }
+        let current = iterator.next(resumeWith);
+        while (!current.done) {
+            const yielded = current.value;
+            if (isGuardAwaitRequest(yielded) || isTemporalAwaitRequest(yielded)) {
+                return { kind: 'await', request: yielded };
+            }
+            const resolution = resolveCraftGeneratorYield(yielded, injector, 'function');
+            if (!resolution.handled) {
+                if (options.appStartNotSupportedErrorMessage &&
+                    isServiceAppStartRequest(yielded)) {
+                    throw new Error(options.appStartNotSupportedErrorMessage);
+                }
+                // Last chance before the invalid-yield error: a bridged foreign yield
+                // suspends through the existing `'promise'` await path.
+                const bridged = foreignYieldBridge?.(yielded, {
+                    injector,
+                    abortSignal: options.abortSignal,
+                });
+                if (bridged) {
+                    return {
+                        kind: 'await',
+                        request: {
+                            [GUARD_AWAIT_REQUEST_MARKER]: true,
+                            kind: 'promise',
+                            value: bridged.then((outcome) => ({
+                                ...outcome,
+                                [FOREIGN_YIELD_OUTCOME]: true,
+                            })),
+                        },
+                    };
+                }
+                throw new Error(options.invalidYieldErrorMessage);
+            }
+            current = iterator.next(resolution.value);
+        }
+        return { kind: 'done', value: current.value };
+    }
+    catch (error) {
+        if (isCraftGenShortCircuit(error)) {
+            return { kind: 'shortCircuit', exception: error.exception };
+        }
+        throw error;
+    }
+}
+function isResourceSettled(resource) {
+    const status = resource.status();
+    // Angular's raw `resource()` reports technical loader failures as `error`,
+    // while Craft resources map business failures to `exception`.
+    return status === 'resolved' || status === 'exception' || status === 'error';
+}
+// Bridges a single await-request to a Promise: `'promise'` requests await
+// the thenable directly; `'settle'` requests subscribe to the resource's settled
+// status (computed off its signals, observed on `injector`) and resolve on the
+// first settle.
+export function awaitCraftProgramRequest(request, injector, abortSignal) {
+    if (isTemporalAwaitRequest(request)) {
+        const temporalRuntime = injector.get(CRAFT_TEMPORAL_RUNTIME, null) ??
+            new RealCraftTemporalRuntime();
+        return temporalRuntime.sleep(request.delayMs, {
+            kind: 'sleep',
+            owner: request.owner,
+            destroyRef: injector.get(DestroyRef, null) ?? undefined,
+            signal: request.signal ?? abortSignal,
+        });
+    }
+    if (request.kind === 'promise') {
+        return Promise.resolve(request.value);
+    }
+    return new Promise((resolve, reject) => {
+        try {
+            const settled$ = runInInjectionContext(injector, () => toObservable(computed(() => isResourceSettled(request.resource)), {
+                injector,
+            })).pipe(filter((settled) => settled), take(1));
+            settled$.subscribe({
+                next: () => resolve(undefined),
+                error: reject,
+            });
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+}
+// Resumes `iterator` across every await it hits until it settles (completes or
+// short-circuits). Each post-await segment runs inside the injection context —
+// ambient context is gone after an `await`, so service resolution and the next
+// `toObservable({ injector })` need it restored.
+export async function driveCraftProgramAsync(iterator, injector, step, options) {
+    let current = step;
+    while (current.kind === 'await') {
+        const value = await awaitCraftProgramRequest(current.request, injector, options.abortSignal);
+        if (options.abortSignal?.aborted) {
+            throw new TemporalCancelledError();
+        }
+        current = runInInjectionContext(injector, () => pumpCraftProgramSync(iterator, injector, options, value));
+    }
+    return current;
+}
+/**
+ * Async counterpart of `executeGeneratorCompatibleFactory`: same contract (a
+ * factory that returns either a plain value or a craft generator), but the
+ * generator path is driven by the async program pump — `craftUntilSettled` /
+ * `craftUntilDefined` awaits suspend instead of erroring, and a
+ * `CraftGenShortCircuit` settles as a `shortCircuit` step instead of throwing.
+ * The `done` value is awaited (generator loaders may return a bare promise).
+ */
+export async function executeGeneratorCompatibleFactoryAsync({ factory, thisArg, getInjector, args, invalidYieldErrorMessage, appStartNotSupportedErrorMessage, abortSignal, }) {
+    const injector = ɵcraftInjectorFromHost(getInjector());
+    const options = {
+        invalidYieldErrorMessage,
+        appStartNotSupportedErrorMessage,
+        abortSignal,
+    };
+    const wrappedFactory = runInInjectionContext(injector, () => injectFnWrapper()(factory));
+    const result = wrappedFactory.apply(thisArg, args);
+    if (!isGenerator(result)) {
+        return { kind: 'done', value: await result };
+    }
+    const first = runInInjectionContext(injector, () => pumpCraftProgramSync(result, injector, options));
+    const settled = await driveCraftProgramAsync(result, injector, first, options);
+    return settled.kind === 'done'
+        ? { kind: 'done', value: await settled.value }
+        : settled;
+}
+//# sourceMappingURL=craft-program-runtime.js.map

package/src/lib/craft-program-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-program-runtime.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-program-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  computed,\n  DestroyRef,\n  Injector,\n  runInInjectionContext,\n} from './host/craft-compat';\nimport { toObservable } from './host/craft-compat';\nimport { filter, take } from 'rxjs';\nimport type { AnyCraftException } from './craft-exception';\nimport { CraftGenShortCircuit, isCraftGenShortCircuit } from './craft-gen';\nimport {\n  GUARD_AWAIT_REQUEST_MARKER,\n  isGenerator,\n  isGuardAwaitRequest,\n  isServiceAppStartRequest,\n  resolveCraftGeneratorYield,\n  type GuardAwaitResourceLike,\n  type RuntimeAwaitRequest,\n} from './craft-generator-runtime';\nimport { injectFnWrapper } from './fn-wrapper';\nimport { ɵcraftInjectorFromHost } from './host/craft-injector-host';\nimport {\n  CRAFT_TEMPORAL_RUNTIME,\n  isTemporalAwaitRequest,\n  RealCraftTemporalRuntime,\n  TemporalCancelledError,\n} from './temporal-runtime';\n\n// ---------------------------------------------------------------------------\n// Generic async craft-program driver.\n//\n// A \"program\" is any craft generator (route guard, resolve stage, exception\n// handler, or a primitive's generator loader): it yields craft service\n// requests — resolved synchronously — and may suspend on an\n// `craftUntilSettled`/`craftUntilDefined` await-request. The driver pumps synchronously\n// between awaits and goes async only across real suspensions; a\n// `CraftGenShortCircuit` (a composed `craftGen` producing a `craftException`)\n// settles as a structured `shortCircuit` step instead of a thrown error.\n// ---------------------------------------------------------------------------\n\n// ---------------------------------------------------------------------------\n// Foreign yields.\n//\n// A \"foreign yield\" is a value the pump cannot resolve as a craft request —\n// canonically an `Effect`, produced by `yield* someEffect`. A registered bridge\n// turns such a yield into a promise of a `ForeignYieldOutcome`; the pump then\n// suspends on the *existing* `'promise'` await path (nothing new to drive) and,\n// on resume, either feeds the success value back into the generator or\n// short-circuits with the carried craft exception.\n//\n// The bridge lives outside this file on purpose, so `libs/core` keeps no\n// dependency on `effect`: see `@craft-ts/effect`. Core only knows that\n// *something* may claim a yield it does not understand.\n// ---------------------------------------------------------------------------\n\n/** What a foreign yield settled to, once its bridge resolved it. */\nexport type ForeignYieldOutcome =\n  | { kind: 'value'; value: unknown }\n  | { kind: 'exception'; exception: AnyCraftException };\n\nconst FOREIGN_YIELD_OUTCOME = Symbol('foreign-yield-outcome');\n\ntype TaggedForeignYieldOutcome = ForeignYieldOutcome & {\n  [FOREIGN_YIELD_OUTCOME]: true;\n};\n\nfunction isTaggedForeignYieldOutcome(\n  value: unknown,\n): value is TaggedForeignYieldOutcome {\n  return (\n    typeof value === 'object' && value !== null && FOREIGN_YIELD_OUTCOME in value\n  );\n}\n\n/** The context a bridge needs in order to resolve and run a foreign yield. */\nexport type ForeignYieldContext = {\n  /**\n   * The injector of the program that yielded. A bridge resolves its runtime\n   * from here, which is what makes per-route runtimes and their inheritance\n   * possible at all.\n   */\n  readonly injector: Injector;\n  /** Aborted when the owning program is superseded or destroyed. */\n  readonly abortSignal?: AbortSignal;\n};\n\n/**\n * Returns a promise for yields it recognises, `undefined` for everything else\n * (which then falls through to the usual invalid-yield error).\n */\nexport type ForeignYieldBridge = (\n  yielded: unknown,\n  context: ForeignYieldContext,\n) => PromiseLike<ForeignYieldOutcome> | undefined;\n\nlet foreignYieldBridge: ForeignYieldBridge | undefined;\n\n/** Registers the bridge; returns a disposer restoring the previous one. */\nexport function setForeignYieldBridge(bridge: ForeignYieldBridge): () => void {\n  const previous = foreignYieldBridge;\n  foreignYieldBridge = bridge;\n  return () => {\n    foreignYieldBridge = previous;\n  };\n}\n\n/** @deprecated Prototype spelling, kept for the wave-0 fixtures. */\nexport const ɵsetForeignYieldBridge = setForeignYieldBridge;\n\n/** A program's driver step: settled (`done`/`shortCircuit`) or suspended on an await. */\nexport type CraftProgramStep =\n  | { kind: 'done'; value: unknown }\n  | { kind: 'await'; request: RuntimeAwaitRequest }\n  | { kind: 'shortCircuit'; exception: AnyCraftException };\n\n/** A settled program step (the `await` suspension already driven through). */\nexport type CraftProgramSettledStep = Exclude<\n  CraftProgramStep,\n  { kind: 'await' }\n>;\n\nexport type CraftProgramPumpOptions = {\n  /** Error raised when the program yields something the driver cannot resolve. */\n  invalidYieldErrorMessage: string;\n  /**\n   * When set, an `onAppStart(...)` yield raises this dedicated error instead of\n   * the generic invalid-yield one (primitive loaders keep their historical\n   * message); when omitted, an app-start yield falls through to\n   * `invalidYieldErrorMessage` (route guards).\n   */\n  appStartNotSupportedErrorMessage?: string;\n  /** Abort signal for temporal awaits owned by the current async program. */\n  abortSignal?: AbortSignal;\n};\n\n// Pumps `iterator` synchronously, resolving craft service yields, until it\n// completes, throws a `CraftGenShortCircuit` (caught and surfaced as the carried\n// exception), or yields an await-request — at which point the iterator is\n// left positioned right after the await so the caller can resume it once the\n// awaited value is available. `resumeValue` feeds the first `next(...)` (used to\n// resume after an await; ignored on the initial pump).\nexport function pumpCraftProgramSync(\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n  options: CraftProgramPumpOptions,\n  resumeValue?: unknown,\n): CraftProgramStep {\n  try {\n    // A resumed foreign yield either carries its value back into the generator\n    // or short-circuits here, so the exception lands on the regular\n    // `shortCircuit` step rather than surfacing as a thrown error.\n    let resumeWith = resumeValue;\n    if (isTaggedForeignYieldOutcome(resumeWith)) {\n      if (resumeWith.kind === 'exception') {\n        throw new CraftGenShortCircuit(resumeWith.exception);\n      }\n      resumeWith = resumeWith.value;\n    }\n\n    let current = iterator.next(resumeWith as never);\n\n    while (!current.done) {\n      const yielded = current.value;\n\n      if (isGuardAwaitRequest(yielded) || isTemporalAwaitRequest(yielded)) {\n        return { kind: 'await', request: yielded };\n      }\n\n      const resolution = resolveCraftGeneratorYield(\n        yielded,\n        injector,\n        'function',\n      );\n\n      if (!resolution.handled) {\n        if (\n          options.appStartNotSupportedErrorMessage &&\n          isServiceAppStartRequest(yielded)\n        ) {\n          throw new Error(options.appStartNotSupportedErrorMessage);\n        }\n\n        // Last chance before the invalid-yield error: a bridged foreign yield\n        // suspends through the existing `'promise'` await path.\n        const bridged = foreignYieldBridge?.(yielded, {\n          injector,\n          abortSignal: options.abortSignal,\n        });\n        if (bridged) {\n          return {\n            kind: 'await',\n            request: {\n              [GUARD_AWAIT_REQUEST_MARKER]: true,\n              kind: 'promise',\n              value: bridged.then((outcome) => ({\n                ...outcome,\n                [FOREIGN_YIELD_OUTCOME]: true as const,\n              })),\n            },\n          };\n        }\n\n        throw new Error(options.invalidYieldErrorMessage);\n      }\n\n      current = iterator.next(resolution.value as never);\n    }\n\n    return { kind: 'done', value: current.value };\n  } catch (error) {\n    if (isCraftGenShortCircuit(error)) {\n      return { kind: 'shortCircuit', exception: error.exception };\n    }\n\n    throw error;\n  }\n}\n\nfunction isResourceSettled(resource: GuardAwaitResourceLike): boolean {\n  const status = resource.status();\n\n  // Angular's raw `resource()` reports technical loader failures as `error`,\n  // while Craft resources map business failures to `exception`.\n  return status === 'resolved' || status === 'exception' || status === 'error';\n}\n\n// Bridges a single await-request to a Promise: `'promise'` requests await\n// the thenable directly; `'settle'` requests subscribe to the resource's settled\n// status (computed off its signals, observed on `injector`) and resolve on the\n// first settle.\nexport function awaitCraftProgramRequest(\n  request: RuntimeAwaitRequest,\n  injector: Injector,\n  abortSignal?: AbortSignal,\n): Promise<unknown> {\n  if (isTemporalAwaitRequest(request)) {\n    const temporalRuntime =\n      injector.get(CRAFT_TEMPORAL_RUNTIME, null) ??\n      new RealCraftTemporalRuntime();\n    return temporalRuntime.sleep(request.delayMs, {\n      kind: 'sleep',\n      owner: request.owner,\n      destroyRef: injector.get(DestroyRef, null) ?? undefined,\n      signal: request.signal ?? abortSignal,\n    });\n  }\n\n  if (request.kind === 'promise') {\n    return Promise.resolve(request.value);\n  }\n\n  return new Promise<unknown>((resolve, reject) => {\n    try {\n      const settled$ = runInInjectionContext(injector, () =>\n        toObservable(\n          computed(() => isResourceSettled(request.resource)),\n          {\n            injector,\n          },\n        ),\n      ).pipe(\n        filter((settled) => settled),\n        take(1),\n      );\n\n      settled$.subscribe({\n        next: () => resolve(undefined),\n        error: reject,\n      });\n    } catch (error) {\n      reject(error);\n    }\n  });\n}\n\n// Resumes `iterator` across every await it hits until it settles (completes or\n// short-circuits). Each post-await segment runs inside the injection context —\n// ambient context is gone after an `await`, so service resolution and the next\n// `toObservable({ injector })` need it restored.\nexport async function driveCraftProgramAsync(\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n  step: CraftProgramStep,\n  options: CraftProgramPumpOptions,\n): Promise<CraftProgramSettledStep> {\n  let current = step;\n\n  while (current.kind === 'await') {\n    const value = await awaitCraftProgramRequest(\n      current.request,\n      injector,\n      options.abortSignal,\n    );\n    if (options.abortSignal?.aborted) {\n      throw new TemporalCancelledError();\n    }\n    current = runInInjectionContext(injector, () =>\n      pumpCraftProgramSync(iterator, injector, options, value),\n    );\n  }\n\n  return current;\n}\n\n/**\n * Async counterpart of `executeGeneratorCompatibleFactory`: same contract (a\n * factory that returns either a plain value or a craft generator), but the\n * generator path is driven by the async program pump — `craftUntilSettled` /\n * `craftUntilDefined` awaits suspend instead of erroring, and a\n * `CraftGenShortCircuit` settles as a `shortCircuit` step instead of throwing.\n * The `done` value is awaited (generator loaders may return a bare promise).\n */\nexport async function executeGeneratorCompatibleFactoryAsync<\n  This,\n  Args extends unknown[],\n  Result,\n>({\n  factory,\n  thisArg,\n  getInjector,\n  args,\n  invalidYieldErrorMessage,\n  appStartNotSupportedErrorMessage,\n  abortSignal,\n}: {\n  factory: (this: This, ...args: Args) => Result;\n  thisArg: This;\n  getInjector: () => Injector | object;\n  args: Args;\n  invalidYieldErrorMessage: string;\n  appStartNotSupportedErrorMessage?: string;\n  abortSignal?: AbortSignal;\n}): Promise<CraftProgramSettledStep> {\n  const injector = ɵcraftInjectorFromHost(getInjector());\n  const options: CraftProgramPumpOptions = {\n    invalidYieldErrorMessage,\n    appStartNotSupportedErrorMessage,\n    abortSignal,\n  };\n  const wrappedFactory = runInInjectionContext(injector, () =>\n    injectFnWrapper()(factory),\n  );\n  const result = wrappedFactory.apply(thisArg, args);\n\n  if (!isGenerator(result)) {\n    return { kind: 'done', value: await result };\n  }\n\n  const first = runInInjectionContext(injector, () =>\n    pumpCraftProgramSync(result, injector, options),\n  );\n  const settled = await driveCraftProgramAsync(\n    result,\n    injector,\n    first,\n    options,\n  );\n\n  return settled.kind === 'done'\n    ? { kind: 'done', value: await settled.value }\n    : settled;\n}\n"]}

package/src/lib/craft-register-for-runtime.d.ts

@@ -0,0 +1,39 @@
+import { InjectionToken, type Injector, type Signal } from './host/craft-compat';
+import type { ConcreteServiceScope } from './craft-service.shared';
+export declare const CRAFT_REGISTRATION_TARGET: unique symbol;
+export type CraftRegistrationTargetMetadata = Readonly<{
+    kind: 'component' | 'directive';
+    name: string;
+}>;
+export type CraftRegistrationTarget<Name extends string = string, Kind extends 'component' | 'directive' = 'component' | 'directive', Instance = unknown> = {
+    readonly [CRAFT_REGISTRATION_TARGET]: CraftRegistrationTargetMetadata & {
+        kind: Kind;
+        name: Name;
+        instance: Instance;
+    };
+};
+export type RegisterForEntry<Value = unknown> = Readonly<{
+    hostName: string;
+    ref: Value;
+}>;
+export type RegisterForSignal<Value = unknown> = Signal<readonly RegisterForEntry<Value>[] | undefined>;
+export type RegisterForTargetDescriptor = Readonly<{
+    key: string;
+    matches(candidate: unknown): boolean;
+}>;
+export type RegisterForRegistry = Readonly<{
+    signalFor(key: string): RegisterForSignal;
+    registerService(name: string, ref: unknown, hostName: string, scope?: ConcreteServiceScope): () => void;
+    registerTarget(target: unknown, ref: unknown, hostName: string): () => void;
+}>;
+export declare const REGISTER_FOR_REGISTRY: InjectionToken<readonly Readonly<{
+    signalFor(key: string): RegisterForSignal;
+    registerService(name: string, ref: unknown, hostName: string, scope?: ConcreteServiceScope): () => void;
+    registerTarget(target: unknown, ref: unknown, hostName: string): () => void;
+}>[]>;
+export declare function createRegisterForRegistry(descriptors: readonly RegisterForTargetDescriptor[], options: {
+    readonly includeGlobal: boolean;
+}): RegisterForRegistry;
+export declare function registerResolvedService(injector: Injector, name: string, ref: unknown, hostName: string, scope: ConcreteServiceScope): void;
+export declare function ɵregisterCraftTarget(injector: Injector, target: unknown, ref: unknown, hostName: string, autoCleanup?: boolean): () => void;
+//# sourceMappingURL=craft-register-for-runtime.d.ts.map

package/src/lib/craft-register-for-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-register-for-runtime.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-register-for-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAEd,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,eAAO,MAAM,yBAAyB,eAErC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,CACjC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,IAAI,SAAS,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,EAClE,QAAQ,GAAG,OAAO,IAChB;IACF,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,+BAA+B,GAAG;QACtE,IAAI,EAAE,IAAI,CAAC;QACX,IAAI,EAAE,IAAI,CAAC;QACX,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI,QAAQ,CAAC;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,KAAK,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,IAAI,MAAM,CACrD,SAAS,gBAAgB,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAC/C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC1C,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,oBAAoB,GAC3B,MAAM,IAAI,CAAC;IACd,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CAC7E,CAAC,CAAC;AAIH,eAAO,MAAM,qBAAqB;mBAZjB,MAAM,GAAG,iBAAiB;0BAEjC,MAAM,OACP,OAAO,YACF,MAAM,UACR,oBAAoB,GAC3B,MAAM,IAAI;2BACU,OAAO,OAAO,OAAO,YAAY,MAAM,GAAG,MAAM,IAAI;KAW3E,CAAC;AAEH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,2BAA2B,EAAE,EACnD,OAAO,EAAE;IAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAAE,GAC3C,mBAAmB,CAkFrB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,GAC1B,IAAI,CAQN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,UAAO,GACjB,MAAM,IAAI,CAsBZ"}

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

@@ -0,0 +1,96 @@
+import { DestroyRef, InjectionToken, signal, } from './host/craft-compat';
+import { ɵrunCraftTargetWrappers } from './craft-target-runtime';
+export const CRAFT_REGISTRATION_TARGET = Symbol.for('@craft-ts/core/craft-registration-target');
+const EMPTY_CLEANUP = () => undefined;
+export const REGISTER_FOR_REGISTRY = new InjectionToken('REGISTER_FOR_REGISTRY', {
+    providedIn: 'root',
+    factory: () => [],
+    multi: true,
+});
+export function createRegisterForRegistry(descriptors, options) {
+    const entriesByKey = new Map();
+    const signalsByKey = new Map();
+    for (const descriptor of descriptors) {
+        entriesByKey.set(descriptor.key, []);
+        signalsByKey.set(descriptor.key, signal(undefined));
+    }
+    const register = (descriptor, ref, hostName) => {
+        if (descriptor === undefined) {
+            return EMPTY_CLEANUP;
+        }
+        const entries = entriesByKey.get(descriptor.key);
+        const entriesSignal = signalsByKey.get(descriptor.key);
+        if (entries === undefined || entriesSignal === undefined) {
+            return EMPTY_CLEANUP;
+        }
+        const existing = entries.find((entry) => Object.is(entry.ref, ref) && entry.hostName === hostName);
+        if (existing !== undefined) {
+            return EMPTY_CLEANUP;
+        }
+        const entry = {
+            hostName,
+            ref,
+        };
+        entries.push(entry);
+        entriesSignal.set(entries.map(toPublicEntry));
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            const index = entries.indexOf(entry);
+            if (index === -1)
+                return;
+            entries.splice(index, 1);
+            entriesSignal.set(entries.length === 0 ? undefined : entries.map(toPublicEntry));
+        };
+    };
+    return {
+        signalFor(key) {
+            return signalsByKey.get(key) ?? signal(undefined);
+        },
+        registerService(name, ref, hostName, scope) {
+            if (scope === 'global' && !options.includeGlobal) {
+                return EMPTY_CLEANUP;
+            }
+            return register(descriptors.find((descriptor) => descriptor.matches({ kind: 'service', name })), ref, hostName);
+        },
+        registerTarget(target, ref, hostName) {
+            return register(descriptors.find((descriptor) => descriptor.matches(target)), ref, hostName);
+        },
+    };
+}
+export function registerResolvedService(injector, name, ref, hostName, scope) {
+    const registries = injector.get(REGISTER_FOR_REGISTRY, []);
+    for (const registry of registries) {
+        attachCleanup(injector, registry.registerService(name, ref, hostName, scope));
+    }
+}
+export function ɵregisterCraftTarget(injector, target, ref, hostName, autoCleanup = true) {
+    const metadata = target[CRAFT_REGISTRATION_TARGET];
+    if (metadata === undefined) {
+        return EMPTY_CLEANUP;
+    }
+    return ɵrunCraftTargetWrappers(injector, {
+        target,
+        kind: metadata.kind,
+        name: metadata.name,
+        ref,
+        hostName,
+        injector,
+    }, autoCleanup);
+}
+function attachCleanup(injector, cleanup) {
+    if (cleanup === EMPTY_CLEANUP)
+        return cleanup;
+    const destroyRef = injector.get(DestroyRef, null);
+    destroyRef?.onDestroy(cleanup);
+    return cleanup;
+}
+function toPublicEntry(entry) {
+    return {
+        hostName: entry.hostName,
+        ref: entry.ref,
+    };
+}
+//# sourceMappingURL=craft-register-for-runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-register-for-runtime.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-register-for-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DestroyRef,\n  InjectionToken,\n  signal,\n  type Injector,\n  type Signal,\n} from './host/craft-compat';\nimport type { ConcreteServiceScope } from './craft-service.shared';\nimport { ɵrunCraftTargetWrappers } from './craft-target-runtime';\n\nexport const CRAFT_REGISTRATION_TARGET = Symbol.for(\n  '@craft-ts/core/craft-registration-target',\n);\n\nexport type CraftRegistrationTargetMetadata = Readonly<{\n  kind: 'component' | 'directive';\n  name: string;\n}>;\n\nexport type CraftRegistrationTarget<\n  Name extends string = string,\n  Kind extends 'component' | 'directive' = 'component' | 'directive',\n  Instance = unknown,\n> = {\n  readonly [CRAFT_REGISTRATION_TARGET]: CraftRegistrationTargetMetadata & {\n    kind: Kind;\n    name: Name;\n    instance: Instance;\n  };\n};\n\nexport type RegisterForEntry<Value = unknown> = Readonly<{\n  hostName: string;\n  ref: Value;\n}>;\n\nexport type RegisterForSignal<Value = unknown> = Signal<\n  readonly RegisterForEntry<Value>[] | undefined\n>;\n\nexport type RegisterForTargetDescriptor = Readonly<{\n  key: string;\n  matches(candidate: unknown): boolean;\n}>;\n\nexport type RegisterForRegistry = Readonly<{\n  signalFor(key: string): RegisterForSignal;\n  registerService(\n    name: string,\n    ref: unknown,\n    hostName: string,\n    scope?: ConcreteServiceScope,\n  ): () => void;\n  registerTarget(target: unknown, ref: unknown, hostName: string): () => void;\n}>;\n\nconst EMPTY_CLEANUP = () => undefined;\n\nexport const REGISTER_FOR_REGISTRY = new InjectionToken<\n  readonly RegisterForRegistry[]\n>('REGISTER_FOR_REGISTRY', {\n  providedIn: 'root',\n  factory: () => [],\n  multi: true,\n});\n\nexport function createRegisterForRegistry(\n  descriptors: readonly RegisterForTargetDescriptor[],\n  options: { readonly includeGlobal: boolean },\n): RegisterForRegistry {\n  const entriesByKey = new Map<string, InternalEntry[]>();\n  const signalsByKey = new Map<\n    string,\n    ReturnType<typeof signal<readonly RegisterForEntry[] | undefined>>\n  >();\n\n  for (const descriptor of descriptors) {\n    entriesByKey.set(descriptor.key, []);\n    signalsByKey.set(\n      descriptor.key,\n      signal<readonly RegisterForEntry[] | undefined>(undefined),\n    );\n  }\n\n  const register = (\n    descriptor: RegisterForTargetDescriptor | undefined,\n    ref: unknown,\n    hostName: string,\n  ): (() => void) => {\n    if (descriptor === undefined) {\n      return EMPTY_CLEANUP;\n    }\n\n    const entries = entriesByKey.get(descriptor.key);\n    const entriesSignal = signalsByKey.get(descriptor.key);\n    if (entries === undefined || entriesSignal === undefined) {\n      return EMPTY_CLEANUP;\n    }\n\n    const existing = entries.find(\n      (entry) => Object.is(entry.ref, ref) && entry.hostName === hostName,\n    );\n    if (existing !== undefined) {\n      return EMPTY_CLEANUP;\n    }\n\n    const entry: InternalEntry = {\n      hostName,\n      ref,\n    };\n    entries.push(entry);\n    entriesSignal.set(entries.map(toPublicEntry));\n\n    let active = true;\n    return () => {\n      if (!active) return;\n      active = false;\n\n      const index = entries.indexOf(entry);\n      if (index === -1) return;\n      entries.splice(index, 1);\n      entriesSignal.set(\n        entries.length === 0 ? undefined : entries.map(toPublicEntry),\n      );\n    };\n  };\n\n  return {\n    signalFor(key) {\n      return signalsByKey.get(key) ?? signal(undefined);\n    },\n    registerService(name, ref, hostName, scope) {\n      if (scope === 'global' && !options.includeGlobal) {\n        return EMPTY_CLEANUP;\n      }\n      return register(\n        descriptors.find((descriptor) =>\n          descriptor.matches({ kind: 'service', name }),\n        ),\n        ref,\n        hostName,\n      );\n    },\n    registerTarget(target, ref, hostName) {\n      return register(\n        descriptors.find((descriptor) => descriptor.matches(target)),\n        ref,\n        hostName,\n      );\n    },\n  };\n}\n\nexport function registerResolvedService(\n  injector: Injector,\n  name: string,\n  ref: unknown,\n  hostName: string,\n  scope: ConcreteServiceScope,\n): void {\n  const registries = injector.get(REGISTER_FOR_REGISTRY, []);\n  for (const registry of registries) {\n    attachCleanup(\n      injector,\n      registry.registerService(name, ref, hostName, scope),\n    );\n  }\n}\n\nexport function ɵregisterCraftTarget(\n  injector: Injector,\n  target: unknown,\n  ref: unknown,\n  hostName: string,\n  autoCleanup = true,\n): () => void {\n  const metadata = (\n    target as {\n      readonly [CRAFT_REGISTRATION_TARGET]?: CraftRegistrationTargetMetadata;\n    }\n  )[CRAFT_REGISTRATION_TARGET];\n  if (metadata === undefined) {\n    return EMPTY_CLEANUP;\n  }\n\n  return ɵrunCraftTargetWrappers(\n    injector,\n    {\n      target,\n      kind: metadata.kind,\n      name: metadata.name,\n      ref,\n      hostName,\n      injector,\n    },\n    autoCleanup,\n  );\n}\n\nfunction attachCleanup(injector: Injector, cleanup: () => void): () => void {\n  if (cleanup === EMPTY_CLEANUP) return cleanup;\n\n  const destroyRef = injector.get(DestroyRef, null);\n  destroyRef?.onDestroy(cleanup);\n  return cleanup;\n}\n\ntype InternalEntry = {\n  readonly hostName: string;\n  readonly ref: unknown;\n};\n\nfunction toPublicEntry(entry: InternalEntry): RegisterForEntry {\n  return {\n    hostName: entry.hostName,\n    ref: entry.ref,\n  };\n}\n"]}

package/src/lib/craft-register-for.d.ts

@@ -0,0 +1,57 @@
+import { type GetServiceReferenceMeta, type GetServiceReferenceOutput, type ServiceReference } from './craft-service';
+import { CRAFT_REGISTRATION_TARGET, REGISTER_FOR_REGISTRY, type CraftRegistrationTarget, type RegisterForEntry, type RegisterForRegistry, type RegisterForSignal } from './craft-register-for-runtime';
+import { type Provider } from './host/craft-compat';
+export { CRAFT_REGISTRATION_TARGET, REGISTER_FOR_REGISTRY, type CraftRegistrationTarget, type RegisterForEntry, type RegisterForRegistry, type RegisterForSignal, };
+export type RegisterForOptions = Readonly<{
+    /** Track global services resolved below this register. Defaults to true. */
+    includeGlobal?: boolean;
+}>;
+export type RegisterForExposureTokens<Value> = Readonly<{
+    /** The complete live signal for the selected register group. */
+    $self: RegisterForSignal<Value>;
+}>;
+export type RegisterForExposureSelector<Value, Exposed> = (tokens: RegisterForExposureTokens<Value>) => Exposed | Generator<unknown, Exposed, unknown>;
+type AnyRegisterTarget = ServiceReference | CraftRegistrationTarget;
+type TargetName<Target> = Target extends ServiceReference ? GetServiceReferenceMeta<Target>['name'] : Target extends CraftRegistrationTarget<infer Name, any, any> ? Name : never;
+type TargetReference<Target> = Target extends ServiceReference ? GetServiceReferenceOutput<Target> : Target extends CraftRegistrationTarget<any, any, infer Instance> ? Instance : never;
+type TargetNames<Targets extends readonly AnyRegisterTarget[]> = Extract<TargetName<Targets[number]>, string>;
+type GroupKey<Name extends string> = Capitalize<Name>;
+type SignalForTarget<Target> = RegisterForSignal<TargetReference<Target>>;
+type RegisterForProjectionResult<Result> = Result extends Generator<infer Yielded, infer Output, unknown> ? {
+    yielded: Yielded;
+    output: Output;
+} : {
+    yielded: never;
+    output: Result;
+};
+type RegisterForDirectValue<Value, Derived> = RegisterForSignal<Value> & ([Derived] extends [never] ? {} : Derived);
+type RegisterForTargetHelper<Value, Derived = never> = {
+    (): Generator<never, RegisterForDirectValue<Value, Derived>, unknown>;
+    <Projection extends (tokens: RegisterForExposureTokens<Value>) => unknown>(bindings: undefined, expose: Projection): Generator<RegisterForProjectionResult<ReturnType<Projection>>['yielded'], RegisterForProjectionResult<ReturnType<Projection>>['output'], unknown>;
+};
+type RegisterForAdditionalGroups<Targets extends readonly AnyRegisterTarget[]> = Targets extends readonly [AnyRegisterTarget, ...infer Rest] ? {
+    [Name in TargetNames<readonly [Extract<Rest[number], AnyRegisterTarget>]> as GroupKey<Name>]: RegisterForTargetHelper<TargetReference<TargetForKey<Extract<Rest[number], AnyRegisterTarget>[], GroupKey<Name>>>>;
+} : Record<never, never>;
+type TargetForKey<Targets extends readonly AnyRegisterTarget[], Key extends string> = Targets[number] extends infer Target ? Target extends AnyRegisterTarget ? GroupKey<Extract<TargetName<Target>, string>> extends Key ? Target : never : never : never;
+export type RegisterForGroups<Targets extends readonly AnyRegisterTarget[]> = {
+    [Name in TargetNames<Targets> as GroupKey<Name>]: SignalForTarget<TargetForKey<Targets, GroupKey<Name>>>;
+};
+type RegisterForDerivedHelper<Derived> = [Derived] extends [never] ? Record<never, never> : {
+    [Name in Extract<keyof Derived, string>]: () => Generator<never, Derived[Name], unknown>;
+};
+type RegisterForHelper<Targets extends readonly AnyRegisterTarget[], Derived = never> = Targets extends readonly [infer Primary, ...unknown[]] ? Primary extends AnyRegisterTarget ? RegisterForTargetHelper<TargetReference<Primary>, Derived> & RegisterForAdditionalGroups<Targets> & RegisterForDerivedHelper<Derived> : never : never;
+export type CraftRegisterForApi<RegistryName extends string, Targets extends readonly AnyRegisterTarget[], Derived = never> = Readonly<{
+    [Name in `RegisterFor${Capitalize<RegistryName>}`]: RegisterForHelper<Targets, Derived>;
+} & {
+    [Name in `provideRegisterFor${Capitalize<RegistryName>}`]: () => Provider[];
+}>;
+export type RegisterForDerivedSelector<Targets extends readonly AnyRegisterTarget[], Derived extends object> = (groups: RegisterForGroups<Targets>) => Derived;
+/**
+ * Creates a typed, DI-scoped view of live Craft service/component/directive
+ * instances. The returned helper is yieldable from Craft factories.
+ */
+export declare function craftRegisterFor<const RegistryName extends string, const Targets extends readonly AnyRegisterTarget[], const Derived extends object>(registryName: RegistryName, targets: Targets, derive: RegisterForDerivedSelector<Targets, Derived>): CraftRegisterForApi<RegistryName, Targets, Derived>;
+export declare function craftRegisterFor<const RegistryName extends string, const Target extends AnyRegisterTarget, const Derived extends object>(registryName: RegistryName, target: Target, derive: RegisterForDerivedSelector<readonly [Target], Derived>): CraftRegisterForApi<RegistryName, readonly [Target], Derived>;
+export declare function craftRegisterFor<const RegistryName extends string, const Targets extends readonly AnyRegisterTarget[]>(registryName: RegistryName, targets: Targets, options?: RegisterForOptions): CraftRegisterForApi<RegistryName, Targets>;
+export declare function craftRegisterFor<const RegistryName extends string, const Target extends AnyRegisterTarget>(registryName: RegistryName, target: Target, options?: RegisterForOptions): CraftRegisterForApi<RegistryName, readonly [Target]>;
+//# sourceMappingURL=craft-register-for.d.ts.map

package/src/lib/craft-register-for.d.ts.map

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

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

@@ -0,0 +1,200 @@
+import { HOST_TAG_LIST } from './host-tag';
+import { getServiceMetaData, } from './craft-service';
+import { CRAFT_REGISTRATION_TARGET, createRegisterForRegistry, REGISTER_FOR_REGISTRY, registerResolvedService, } from './craft-register-for-runtime';
+import { isGenerator, provideServiceYieldWrapper, } from './craft-generator-runtime';
+import { provideCraftTargetWrapper } from './craft-target-runtime';
+import { assertInInjectionContext, inject, InjectionToken, Injector, } from './host/craft-compat';
+export { CRAFT_REGISTRATION_TARGET, REGISTER_FOR_REGISTRY, };
+export function craftRegisterFor(registryName, targetsOrTarget, optionsOrDerive = {}) {
+    const targets = Array.isArray(targetsOrTarget)
+        ? targetsOrTarget
+        : [targetsOrTarget];
+    return createCraftRegisterFor(registryName, targets, optionsOrDerive);
+}
+function createCraftRegisterFor(registryName, targets, optionsOrDerive) {
+    if (!registryName) {
+        throw new Error('craftRegisterFor requires a non-empty registry name.');
+    }
+    if (targets.length === 0) {
+        throw new Error('craftRegisterFor requires at least one target.');
+    }
+    const descriptors = targets.map(toDescriptor);
+    assertUniqueDescriptorKeys(descriptors);
+    const derive = typeof optionsOrDerive === 'function' ? optionsOrDerive : undefined;
+    const options = typeof optionsOrDerive === 'function' ? {} : optionsOrDerive;
+    const includeGlobal = options.includeGlobal ?? true;
+    const registryToken = new InjectionToken(`REGISTER_FOR_REGISTRY_${registryName}`);
+    const registerForName = `RegisterFor${capitalize(registryName)}`;
+    const provideRegisterForName = `provideRegisterFor${capitalize(registryName)}`;
+    const derivedByInjector = new WeakMap();
+    const createTargetHelper = (descriptor, exposeDerived) => function* (_bindings, expose) {
+        const value = requireRegistry().signalFor(descriptor.key);
+        if (expose === undefined) {
+            return exposeDerived ? extendWithDerived(value) : value;
+        }
+        const exposed = expose({ $self: value });
+        if (isGenerator(exposed)) {
+            return yield* exposed;
+        }
+        return exposed;
+    };
+    const helper = createTargetHelper(descriptors[0], true);
+    for (const descriptor of descriptors.slice(1)) {
+        Object.defineProperty(helper, descriptor.key, {
+            value: createTargetHelper(descriptor, false),
+            enumerable: false,
+        });
+    }
+    const registerFor = new Proxy(helper, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            if (value !== undefined ||
+                typeof property !== 'string' ||
+                derive === undefined ||
+                property === 'then') {
+                return value;
+            }
+            return function* () {
+                const derived = getDerivedForCurrentInjector();
+                if (!Object.prototype.hasOwnProperty.call(derived, property)) {
+                    throw new Error(`Unknown RegisterFor property "${property}".`);
+                }
+                return derived[property];
+            };
+        },
+    });
+    function extendWithDerived(value) {
+        if (derive === undefined) {
+            return value;
+        }
+        const derived = getDerivedForCurrentInjector();
+        return new Proxy(value, {
+            get(target, property, receiver) {
+                if (typeof property === 'string' &&
+                    Object.prototype.hasOwnProperty.call(derived, property)) {
+                    return derived[property];
+                }
+                return Reflect.get(target, property, receiver);
+            },
+        });
+    }
+    const provideRegisterFor = () => {
+        const registryProvider = {
+            provide: registryToken,
+            useFactory: () => createRegisterForRegistry(descriptors, { includeGlobal }),
+        };
+        const registryCollectionProvider = {
+            provide: REGISTER_FOR_REGISTRY,
+            useExisting: registryToken,
+            multi: true,
+        };
+        const targetWrapper = provideCraftTargetWrapper('Warning: dependency injection here is not type-safe and may fail at runtime', function* (context, next) {
+            const registry = context.injector.get(registryToken, null);
+            if (registry === null) {
+                return yield* next();
+            }
+            const release = registry.registerTarget(context.target, context.ref, context.hostName);
+            const downstreamRelease = yield* next();
+            return () => {
+                downstreamRelease();
+                release();
+            };
+        });
+        const yieldWrapper = provideServiceYieldWrapper('Register Craft service yields for craftRegisterFor.', function* (context, next) {
+            const ref = yield* next();
+            if (context.providedIn !== 'global' || includeGlobal) {
+                const hostTags = context.injector.get(HOST_TAG_LIST, []);
+                registerResolvedService(context.injector, context.name, ref, hostTags[hostTags.length - 1] ?? `service:${context.name}`, context.providedIn);
+            }
+            return ref;
+        });
+        return [
+            registryProvider,
+            registryCollectionProvider,
+            targetWrapper,
+            yieldWrapper,
+        ];
+    };
+    return {
+        [registerForName]: registerFor,
+        [provideRegisterForName]: provideRegisterFor,
+    };
+    function getDerivedForCurrentInjector() {
+        if (derive === undefined) {
+            return {};
+        }
+        const injector = currentInjector();
+        const cached = derivedByInjector.get(injector);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const groups = {};
+        const registry = requireRegistry();
+        for (const descriptor of descriptors) {
+            groups[descriptor.key] = registry.signalFor(descriptor.key);
+        }
+        const derived = derive(groups);
+        if (isGenerator(derived)) {
+            throw new Error('craftRegisterFor derived properties must be returned synchronously.');
+        }
+        const result = derived;
+        derivedByInjector.set(injector, result);
+        return result;
+    }
+    function requireRegistry() {
+        throwIfNoInjectionContext();
+        const registry = currentInjector().get(registryToken, null);
+        if (registry === null) {
+            throw new Error(`${registerForName} requires ${provideRegisterForName}() in the current Craft injector.`);
+        }
+        return registry;
+    }
+}
+function toDescriptor(target) {
+    try {
+        const service = getServiceMetaData(target);
+        return {
+            key: capitalize(service.name),
+            matches(candidate) {
+                return isServiceCandidate(candidate) && candidate.name === service.name;
+            },
+        };
+    }
+    catch {
+        const metadata = target[CRAFT_REGISTRATION_TARGET];
+        if (!metadata) {
+            throw new Error('craftRegisterFor only accepts Craft services, components, and directives.');
+        }
+        return {
+            key: capitalize(metadata.name),
+            matches(candidate) {
+                return candidate === target;
+            },
+        };
+    }
+}
+function assertUniqueDescriptorKeys(descriptors) {
+    const seen = new Set();
+    for (const descriptor of descriptors) {
+        if (seen.has(descriptor.key)) {
+            throw new Error(`craftRegisterFor cannot contain duplicate group name "${descriptor.key}".`);
+        }
+        seen.add(descriptor.key);
+    }
+}
+function isServiceCandidate(candidate) {
+    return (typeof candidate === 'object' &&
+        candidate !== null &&
+        Reflect.get(candidate, 'kind') === 'service' &&
+        typeof Reflect.get(candidate, 'name') === 'string');
+}
+function capitalize(value) {
+    return value ? value.charAt(0).toUpperCase() + value.slice(1) : value;
+}
+function throwIfNoInjectionContext() {
+    assertInInjectionContext(throwIfNoInjectionContext);
+}
+function currentInjector() {
+    return inject(Injector);
+}
+//# sourceMappingURL=craft-register-for.js.map