@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-state-machine.js

@@ -0,0 +1,254 @@
+import { assertInInjectionContext, inject, Injector, isSignal, runInInjectionContext, } from './host/craft-compat';
+import { craftComputed as createCraftComputed, craftSignal, } from './host/craft-signal';
+import { injectFnWrapper } from './fn-wrapper';
+import { ɵcreateHostTaggedInjector, ɵHOST_TAG_LIST } from './craft-service';
+import { createNamedPrimitiveGen, } from './craft-primitive-gen';
+import { isSource } from './util/util';
+import { createYieldableInsertionMethod, isNonYieldableInsertionMethod, isYieldableMethod, } from './yieldable';
+import { createYieldableReactiveValue, isYieldableReactiveValue, nameInsertedReactiveValue, } from './reactive-read';
+import { ɵdriveMachineGenerator, ɵregisterMachineInit, ɵrestoreMachineStep, ɵrunTransition, ɵwithMachineScope, ɵwithSuspendedMachine, ɵrequireMachineScope, } from './craft-state-machine-runtime';
+// ---------------------------------------------------------------------------
+// Markers
+// ---------------------------------------------------------------------------
+const TRANSITION_STEP_MARKER = Symbol('craft-transition-step');
+const TRANSITIONS_SETUP_MARKER = Symbol('craft-transitions-setup');
+const TRANSITION_GUARD_MARKER = Symbol('craft-transition-guard');
+// ---------------------------------------------------------------------------
+// Authoring surface
+// ---------------------------------------------------------------------------
+/**
+ * Wraps a predicate into a transition guard. Accepts a plain lambda or a
+ * generator; a generator guard resolves craft dependencies with `yield*`, and
+ * those dependencies join the machine's dependency graph.
+ *
+ * ```ts
+ * transitionGuard(({ context }) => context.form.isValid());
+ *
+ * transitionGuard(function* ({ context, from, to, event }) {
+ *   const policy = yield* PolicyService();
+ *   return policy.canTransition({ from, to, event });
+ * });
+ * ```
+ */
+export function transitionGuard(guard) {
+    return Object.assign(guard, {
+        [TRANSITION_GUARD_MARKER]: true,
+    });
+}
+/**
+ * Declares how a machine enters one step. The generator runs once, at machine
+ * creation, and registers the reactions that may move the machine here
+ * (`on$`, `afterRecomputation`, `initStateMachine`).
+ *
+ * `transitionStep(...).pipe(transitionGuard(...))` guards every transition
+ * declared in that step.
+ */
+export function transitionStep(setup) {
+    return createTransitionStep(setup, []);
+}
+/**
+ * Builds every transition of a machine. The setup generator receives the
+ * machine `context` and `transit`, and returns one {@link transitionStep} per
+ * step; the record's keys ARE the machine's steps.
+ *
+ * `transitionsSetup(...).pipe(transitionGuard(...))` guards every transition of
+ * every step.
+ *
+ * Declared standalone, the setup's `context` parameter has to be annotated —
+ * typically with `CraftMachineContext<typeof contextFactory>`; `craftStateMachine`
+ * then checks the machine's real context against that annotation.
+ */
+export function transitionsSetup(setup) {
+    return createTransitionsSetup(setup, []);
+}
+/**
+ * Registers the callback that gives the machine its initial step. Registrations
+ * run after every step has been installed, in declaration order, and the first
+ * accepted `transit()` wins — later init registrations are skipped.
+ *
+ * ```ts
+ * yield* initStateMachine(() => transit());
+ * ```
+ */
+export function initStateMachine(callback) {
+    return ɵregisterMachineInit(callback);
+}
+export function craftStateMachine(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+nameOrContextFactory, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+contextFactoryOrTransitions, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+transitionsOrCurrentStepWithContextFactory, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+currentStepWithContextFactoryOrInsertion, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+maybeInsertion) {
+    const isNamed = typeof nameOrContextFactory === 'string';
+    const name = isNamed ? nameOrContextFactory : 'stateMachine';
+    const contextFactory = isNamed
+        ? contextFactoryOrTransitions
+        : nameOrContextFactory;
+    const transitions = isNamed
+        ? transitionsOrCurrentStepWithContextFactory
+        : contextFactoryOrTransitions;
+    const currentStepWithContextFactory = isNamed
+        ? currentStepWithContextFactoryOrInsertion
+        : transitionsOrCurrentStepWithContextFactory;
+    const insertion = isNamed
+        ? maybeInsertion
+        : currentStepWithContextFactoryOrInsertion;
+    const ref = createStateMachineRef(name, contextFactory, transitions, currentStepWithContextFactory, insertion);
+    return createNamedPrimitiveGen(name, ref);
+}
+function createTransitionStep(setup, guards) {
+    const step = {
+        [TRANSITION_STEP_MARKER]: true,
+        setup,
+        guards,
+        pipe: (...extraGuards) => createTransitionStep(setup, [...guards, ...extraGuards]),
+    };
+    return step;
+}
+function createTransitionsSetup(setup, guards) {
+    return {
+        [TRANSITIONS_SETUP_MARKER]: true,
+        setup,
+        guards,
+        pipe: (...extraGuards) => createTransitionsSetup(setup, [...guards, ...extraGuards]),
+    };
+}
+function createTransitionAttempt(event, localGuards) {
+    // The scope is captured at CREATION time: `transit(...)` is called from inside
+    // a registration callback, which the machine runs with its declaring step
+    // restored. Reading it lazily would resolve the wrong target.
+    const scope = ɵrequireMachineScope('transit(...)');
+    const attempt = ɵrunTransition(scope, event, localGuards);
+    return Object.assign(attempt, {
+        pipe: (...guards) => ɵwithMachineScope(scope, () => createTransitionAttempt(event, [...localGuards, ...guards])),
+    });
+}
+function createTransit() {
+    return (event) => createTransitionAttempt(event, []);
+}
+function isStepsRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function driveFactory(factory, injector, ...args) {
+    const wrapped = runInInjectionContext(injector, () => injectFnWrapper()(factory));
+    return runInInjectionContext(injector, () => ɵdriveMachineGenerator(wrapped(...args), injector));
+}
+function exposeInsertionOutput(output, injector) {
+    return Object.entries(output).reduce((exposed, [key, value]) => {
+        if (isYieldableReactiveValue(value)) {
+            exposed[key] = nameInsertedReactiveValue(value, key, 'craftStateMachine', `craftStateMachine.${key}`);
+            return exposed;
+        }
+        if (isSource(value) || isSignal(value) || isYieldableMethod(value)) {
+            exposed[key] = value;
+            return exposed;
+        }
+        if (typeof value === 'function' && !isNonYieldableInsertionMethod(value)) {
+            const methodInjector = ɵcreateHostTaggedInjector(injector, `method:${key}`);
+            const wrappedFn = runInInjectionContext(methodInjector, () => injectFnWrapper()(value));
+            exposed[key] = createYieldableInsertionMethod(wrappedFn, {
+                injector: methodInjector,
+                invalidYieldErrorMessage: 'craftStateMachine insertion method generators can only yield craftService dependencies or exposed dependency helpers.',
+                multipleAppStartErrorMessage: 'craftStateMachine insertion methods do not support multiple onAppStart(...) declarations.',
+                onAppStartNotSupportedErrorMessage: 'craftStateMachine insertion methods do not support onAppStart(...).',
+            });
+            return exposed;
+        }
+        exposed[key] = value;
+        return exposed;
+    }, {});
+}
+/**
+ * Normalises the two accepted forms: a bare setup generator carries no
+ * machine-wide guard, so it becomes a setup with an empty guard list.
+ */
+function toRuntimeTransitionsSetup(transitions) {
+    return typeof transitions === 'function'
+        ? createTransitionsSetup(transitions, [])
+        : transitions;
+}
+function createStateMachineRef(name, contextFactory, transitionsInput, currentStepWithContextFactory, insertion) {
+    assertInInjectionContext(craftStateMachine);
+    const transitions = toRuntimeTransitionsSetup(transitionsInput);
+    const injector = ɵcreateHostTaggedInjector(inject(Injector), `stateMachine:${name}`);
+    return runInInjectionContext(injector, () => {
+        const context = driveFactory(contextFactory, injector);
+        const stepContexts = (currentStepWithContextFactory
+            ? driveFactory(currentStepWithContextFactory, injector, context)
+            : {});
+        const currentStep = craftSignal(undefined);
+        const runtime = {
+            context,
+            currentStep,
+            globalGuards: transitions.guards,
+            stepGuards: new Map(),
+            injector,
+            initRegistrations: [],
+            observers: new Set(),
+            suspended: false,
+        };
+        const stepsRecord = driveFactory(transitions.setup, injector, context, createTransit());
+        if (!isStepsRecord(stepsRecord)) {
+            throw new Error('transitionsSetup(...) must return a record of transitionStep(...) entries.');
+        }
+        for (const [step, definition] of Object.entries(stepsRecord)) {
+            runtime.stepGuards.set(step, definition.guards ?? []);
+        }
+        for (const [step, definition] of Object.entries(stepsRecord)) {
+            ɵwithMachineScope({ runtime, target: step }, () => runInInjectionContext(injector, () => ɵdriveMachineGenerator(definition.setup(), injector)));
+        }
+        // Installation is over: the machine can now take its initial step. The
+        // first accepted transit wins, so a later registration is not even run.
+        for (const registration of runtime.initRegistrations) {
+            if (currentStep() !== undefined) {
+                break;
+            }
+            registration();
+        }
+        if (currentStep() === undefined) {
+            throw new Error(`craftStateMachine "${name}" did not initialise: its initial transition was rejected by a guard.`);
+        }
+        const currentStepReader = createYieldableReactiveValue(currentStep.asReadonly(), 'currentStep');
+        const currentStepWithContextReader = createYieldableReactiveValue(createCraftComputed(() => {
+            const step = currentStep();
+            if (step === undefined)
+                return undefined;
+            return Object.assign({}, stepContexts[step], { step });
+        }), 'currentStepWithContext');
+        const ref = {
+            currentStep: currentStepReader,
+            currentStepWithContext: currentStepWithContextReader,
+            context,
+        };
+        if (insertion) {
+            const controls = {
+                hostTags: injector.get(ɵHOST_TAG_LIST, []),
+                onTransition: (observer) => {
+                    runtime.observers.add(observer);
+                    return () => runtime.observers.delete(observer);
+                },
+                restoreStep: (step) => {
+                    if (step === undefined) {
+                        throw new Error(`craftStateMachine "${name}" cannot restore an undefined step.`);
+                    }
+                    ɵrestoreMachineStep(runtime, step);
+                },
+                suspended: (restore) => ɵwithSuspendedMachine(runtime, restore),
+            };
+            const output = driveFactory(insertion, injector, {
+                context,
+                currentStep: currentStepReader,
+                currentStepWithContext: currentStepWithContextReader,
+                machine: controls,
+            });
+            Object.assign(ref, exposeInsertionOutput((output ?? {}), injector));
+        }
+        return ref;
+    });
+}
+//# sourceMappingURL=craft-state-machine.js.map

package/src/lib/craft-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-state-machine.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-state-machine.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertInInjectionContext,\n  inject,\n  Injector,\n  isSignal,\n  runInInjectionContext,\n} from './host/craft-compat';\nimport {\n  craftComputed as createCraftComputed,\n  craftSignal,\n} from './host/craft-signal';\nimport { injectFnWrapper } from './fn-wrapper';\nimport { ɵcreateHostTaggedInjector, ɵHOST_TAG_LIST } from './craft-service';\nimport type {\n  CompleteServiceDependencyMapFromYielded,\n  SERVICE_HELPER_DEPENDENCIES,\n} from './craft-service';\nimport {\n  createNamedPrimitiveGen,\n  type NamedCraftPrimitiveGen,\n} from './craft-primitive-gen';\nimport { isSource } from './util/util';\nimport {\n  createYieldableInsertionMethod,\n  isNonYieldableInsertionMethod,\n  isYieldableMethod,\n  type BrandReactiveProperties,\n  type YieldableInsertionMethods,\n} from './yieldable';\nimport {\n  createYieldableReactiveValue,\n  isYieldableReactiveValue,\n  nameInsertedReactiveValue,\n  type YieldableReactiveValue,\n} from './reactive-read';\nimport type { MergeObject } from './util/types/util.type';\nimport {\n  ɵdriveMachineGenerator,\n  ɵregisterMachineInit,\n  ɵrestoreMachineStep,\n  ɵrunTransition,\n  ɵwithMachineScope,\n  ɵwithSuspendedMachine,\n  ɵrequireMachineScope,\n  type MachineRuntime,\n  type MachineTransitionObserver,\n  type RuntimeTransitionGuard,\n} from './craft-state-machine-runtime';\n\n// ---------------------------------------------------------------------------\n// Markers\n// ---------------------------------------------------------------------------\n\nconst TRANSITION_STEP_MARKER = Symbol('craft-transition-step');\nconst TRANSITIONS_SETUP_MARKER = Symbol('craft-transitions-setup');\nconst TRANSITION_GUARD_MARKER = Symbol('craft-transition-guard');\n\n/** Type-only carriers. None of these exist at runtime. */\ndeclare const TRANSITION_STEP_YIELDED: unique symbol;\ndeclare const TRANSITIONS_SETUP_CONTEXT: unique symbol;\ndeclare const TRANSITIONS_SETUP_STEPS: unique symbol;\ndeclare const TRANSITIONS_SETUP_YIELDED: unique symbol;\ndeclare const MISSING_INIT_STATE_MACHINE: unique symbol;\n\n/**\n * Phantom request advertised by `initStateMachine(...)`. It is never yielded at\n * runtime; `craftStateMachine` reads it off the transitions' `Yielded` to reject\n * a machine that declares no way to reach its first step.\n */\nexport declare const CRAFT_MACHINE_INIT_REQUEST: unique symbol;\n\nexport interface CraftMachineInitRequest {\n  readonly [CRAFT_MACHINE_INIT_REQUEST]: true;\n}\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * What a guard sees. `from` is `undefined` for the very first transition — the\n * one that gives the machine its initial step.\n */\nexport type CraftTransition<\n  Context = unknown,\n  Steps extends string = string,\n  Event = unknown,\n> = {\n  readonly from: Steps | undefined;\n  readonly to: Steps;\n  readonly context: Context;\n  readonly event: Event;\n};\n\n/**\n * A guard, built by {@link transitionGuard}. It answers a single transition\n * attempt; a generator guard may `yield*` craft dependencies, which the machine\n * folds into its own dependency graph.\n */\nexport type CraftTransitionGuard<\n  Transition = CraftTransition<any, string, any>,\n  Yielded = never,\n> = ((\n  transition: Transition,\n) => boolean | Generator<Yielded, boolean, unknown>) & {\n  readonly [TRANSITION_GUARD_MARKER]: true;\n};\n\n/** A transition attempt: `yield*` it to run it, `.pipe(...)` to guard it. */\nexport type CraftTransitionAttempt<\n  Context,\n  Event,\n  Yielded = never,\n> = Generator<Yielded, boolean, unknown> & {\n  readonly pipe: CraftTransitionAttemptPipe<Context, Event, Yielded>;\n};\n\ntype AttemptGuard<Context, Event, Yielded> = CraftTransitionGuard<\n  CraftTransition<Context, string, Event>,\n  Yielded\n>;\n\nexport interface CraftTransitionAttemptPipe<Context, Event, Yielded> {\n  <Y1>(\n    guard1: AttemptGuard<Context, Event, Y1>,\n  ): CraftTransitionAttempt<Context, Event, Yielded | Y1>;\n  <Y1, Y2>(\n    guard1: AttemptGuard<Context, Event, Y1>,\n    guard2: AttemptGuard<Context, Event, Y2>,\n  ): CraftTransitionAttempt<Context, Event, Yielded | Y1 | Y2>;\n  <Y1, Y2, Y3>(\n    guard1: AttemptGuard<Context, Event, Y1>,\n    guard2: AttemptGuard<Context, Event, Y2>,\n    guard3: AttemptGuard<Context, Event, Y3>,\n  ): CraftTransitionAttempt<Context, Event, Yielded | Y1 | Y2 | Y3>;\n  <Y1, Y2, Y3, Y4>(\n    guard1: AttemptGuard<Context, Event, Y1>,\n    guard2: AttemptGuard<Context, Event, Y2>,\n    guard3: AttemptGuard<Context, Event, Y3>,\n    guard4: AttemptGuard<Context, Event, Y4>,\n  ): CraftTransitionAttempt<Context, Event, Yielded | Y1 | Y2 | Y3 | Y4>;\n}\n\n/**\n * The `transit` handed to the transitions setup. Called inside a\n * `transitionStep('x', ...)` registration, it targets that very step: the step\n * a machine can move to is the step whose block declared the attempt.\n */\nexport interface CraftTransit<Context> {\n  (): CraftTransitionAttempt<Context, void>;\n  <Event>(event: Event): CraftTransitionAttempt<Context, Event>;\n}\n\ntype StepGuard<Yielded> = CraftTransitionGuard<\n  CraftTransition<any, string, any>,\n  Yielded\n>;\n\nexport interface CraftTransitionStepPipe<Yielded> {\n  <Y1>(guard1: StepGuard<Y1>): CraftTransitionStep<Yielded | Y1>;\n  <Y1, Y2>(\n    guard1: StepGuard<Y1>,\n    guard2: StepGuard<Y2>,\n  ): CraftTransitionStep<Yielded | Y1 | Y2>;\n  <Y1, Y2, Y3>(\n    guard1: StepGuard<Y1>,\n    guard2: StepGuard<Y2>,\n    guard3: StepGuard<Y3>,\n  ): CraftTransitionStep<Yielded | Y1 | Y2 | Y3>;\n  <Y1, Y2, Y3, Y4>(\n    guard1: StepGuard<Y1>,\n    guard2: StepGuard<Y2>,\n    guard3: StepGuard<Y3>,\n    guard4: StepGuard<Y4>,\n  ): CraftTransitionStep<Yielded | Y1 | Y2 | Y3 | Y4>;\n}\n\n/** One entry of the transitions record: how the machine enters that step. */\nexport interface CraftTransitionStep<Yielded = never> {\n  readonly [TRANSITION_STEP_MARKER]: true;\n  readonly [TRANSITION_STEP_YIELDED]?: Yielded;\n  readonly pipe: CraftTransitionStepPipe<Yielded>;\n}\n\ntype AnyStepsRecord = Record<string, CraftTransitionStep<any>>;\n\ntype StepYielded<Step> = typeof TRANSITION_STEP_YIELDED extends keyof Step\n  ? Step extends { readonly [TRANSITION_STEP_YIELDED]?: infer Yielded }\n    ? Yielded\n    : never\n  : never;\n\ntype StepsRecordYielded<Steps extends AnyStepsRecord> = {\n  [Key in keyof Steps]: StepYielded<Steps[Key]>;\n}[keyof Steps];\n\ntype SetupGuard<Context, Steps extends string, Yielded> = CraftTransitionGuard<\n  CraftTransition<Context, Steps, unknown>,\n  Yielded\n>;\n\n/** The step names a transitions record declares. */\ntype MachineSteps<StepsRecord> = Extract<keyof StepsRecord, string>;\n\nexport interface CraftTransitionsSetupPipe<\n  Context,\n  StepsRecord extends AnyStepsRecord,\n  Yielded,\n> {\n  <Y1>(\n    guard1: SetupGuard<Context, MachineSteps<StepsRecord>, Y1>,\n  ): CraftTransitionsSetup<Context, StepsRecord, Yielded | Y1>;\n  <Y1, Y2>(\n    guard1: SetupGuard<Context, MachineSteps<StepsRecord>, Y1>,\n    guard2: SetupGuard<Context, MachineSteps<StepsRecord>, Y2>,\n  ): CraftTransitionsSetup<Context, StepsRecord, Yielded | Y1 | Y2>;\n  <Y1, Y2, Y3>(\n    guard1: SetupGuard<Context, MachineSteps<StepsRecord>, Y1>,\n    guard2: SetupGuard<Context, MachineSteps<StepsRecord>, Y2>,\n    guard3: SetupGuard<Context, MachineSteps<StepsRecord>, Y3>,\n  ): CraftTransitionsSetup<Context, StepsRecord, Yielded | Y1 | Y2 | Y3>;\n  <Y1, Y2, Y3, Y4>(\n    guard1: SetupGuard<Context, MachineSteps<StepsRecord>, Y1>,\n    guard2: SetupGuard<Context, MachineSteps<StepsRecord>, Y2>,\n    guard3: SetupGuard<Context, MachineSteps<StepsRecord>, Y3>,\n    guard4: SetupGuard<Context, MachineSteps<StepsRecord>, Y4>,\n  ): CraftTransitionsSetup<Context, StepsRecord, Yielded | Y1 | Y2 | Y3 | Y4>;\n}\n\n/**\n * The setup generator itself: the form `craftStateMachine` takes when the\n * transitions carry no machine-wide guard. `Context` is contextually typed by\n * the machine, so the parameter needs no annotation here.\n */\nexport type CraftTransitionsSetupFn<\n  Context,\n  StepsRecord extends AnyStepsRecord,\n  Yielded,\n> = (\n  context: Context,\n  transit: CraftTransit<Context>,\n) => Generator<Yielded, StepsRecord, unknown>;\n\n/**\n * The transitions once {@link transitionsSetup} has wrapped them, which is what\n * carries `.pipe(...)`. `Context` travels contravariantly so `craftStateMachine`\n * accepts a setup whose annotated context is satisfied by the machine's actual\n * context, and refuses one that asks for more.\n */\nexport interface CraftTransitionsSetup<\n  Context,\n  StepsRecord extends AnyStepsRecord,\n  Yielded = never,\n> {\n  readonly [TRANSITIONS_SETUP_MARKER]: true;\n  readonly [TRANSITIONS_SETUP_CONTEXT]?: (context: Context) => void;\n  readonly [TRANSITIONS_SETUP_STEPS]?: StepsRecord;\n  readonly [TRANSITIONS_SETUP_YIELDED]?: Yielded;\n  readonly pipe: CraftTransitionsSetupPipe<Context, StepsRecord, Yielded>;\n}\n\n/**\n * What `craftStateMachine` accepts as its transitions: the bare setup\n * generator, or the same generator wrapped in {@link transitionsSetup} when a\n * machine-wide guard has to be piped onto it.\n */\nexport type CraftTransitionsInput<\n  Context,\n  StepsRecord extends AnyStepsRecord,\n  Yielded,\n> =\n  | CraftTransitionsSetupFn<Context, StepsRecord, Yielded>\n  | CraftTransitionsSetup<Context, StepsRecord, Yielded>;\n\n/**\n * `yield* initStateMachine(...)` is not optional: without it nothing would ever\n * give the machine its first step. The obligation is enforced here, by making\n * the transitions argument unassignable until the marker shows up.\n */\nexport type CraftMachineInitRequirement<Yielded> = [\n  Extract<Yielded, CraftMachineInitRequest>,\n] extends [never]\n  ? {\n      readonly [MISSING_INIT_STATE_MACHINE]: 'This state machine never initialises: add `yield* initStateMachine(() => transit())` to one of its transitionStep(...) blocks.';\n    }\n  : unknown;\n\n/** The registration value the machine-scoped helpers resolve to. */\nexport type CraftMachineRegistration<Yielded = never> = Generator<\n  Yielded,\n  void,\n  unknown\n>;\n\n/** Reads the context type a `craftStateMachine` context factory produces. */\nexport type CraftMachineContext<ContextFactory> = ContextFactory extends (\n  ...args: any[]\n) => Generator<any, infer Context, any>\n  ? Context\n  : ContextFactory extends (...args: any[]) => infer Context\n    ? Context\n    : never;\n\ntype CurrentStepWithContextForStep<StepContexts, Step extends string> =\n  Step extends keyof StepContexts\n    ? StepContexts[Step] extends object\n      ? { readonly step: Step } & StepContexts[Step]\n      : { readonly step: Step; readonly context: StepContexts[Step] }\n    : { readonly step: Step; readonly context: unknown };\n\ntype CurrentStepWithContextValue<\n  StepContexts,\n  Steps extends string,\n> = Steps extends string\n  ? CurrentStepWithContextForStep<StepContexts, Steps>\n  : never;\n\n/** One decided transition attempt, as an insertion observes it. */\nexport type CraftMachineTransition<Steps extends string = string> = Readonly<{\n  from: Steps | undefined;\n  to: Steps;\n  event: unknown;\n  accepted: boolean;\n}>;\n\n/**\n * The machine's own controls, handed to its insertion. This is what a feature\n * built on top of the machine — a history, a replay — needs and the machine\n * core deliberately does not provide itself.\n */\nexport type CraftMachineControls<Steps extends string = string> = Readonly<{\n  /** Host chain of the machine, to scope a registry capture to what it owns. */\n  hostTags: readonly string[];\n  /** Observes every decided attempt, accepted or refused. Returns a release. */\n  onTransition(\n    observer: (transition: CraftMachineTransition<Steps>) => void,\n  ): () => void;\n  /** Moves to a step without consulting any guard. */\n  restoreStep(step: Steps): void;\n  /** Runs `restore` with the machine's registrations muted. */\n  suspended<Result>(restore: () => Result): Result;\n}>;\n\nexport type CraftMachineInsertionContext<\n  Context,\n  Steps extends string,\n  StepContexts,\n> = {\n  readonly context: Context;\n  readonly currentStep: YieldableReactiveValue<Steps, 'currentStep'>;\n  readonly currentStepWithContext: YieldableReactiveValue<\n    CurrentStepWithContextValue<StepContexts, Steps>,\n    'currentStepWithContext'\n  >;\n  readonly machine: CraftMachineControls<Steps>;\n};\n\nexport type CraftStateMachineOutput<\n  Context,\n  Steps extends string,\n  StepContexts,\n  Insertions,\n  Dependencies = {},\n> = MergeObject<\n  {\n    readonly currentStep: YieldableReactiveValue<Steps, 'currentStep'>;\n    readonly currentStepWithContext: YieldableReactiveValue<\n      CurrentStepWithContextValue<StepContexts, Steps>,\n      'currentStepWithContext'\n    >;\n    readonly context: Context;\n  },\n  MergeObject<\n    BrandReactiveProperties<YieldableInsertionMethods<Insertions>>,\n    { readonly [SERVICE_HELPER_DEPENDENCIES]?: Dependencies }\n  >\n>;\n\n// ---------------------------------------------------------------------------\n// Authoring surface\n// ---------------------------------------------------------------------------\n\n/**\n * Wraps a predicate into a transition guard. Accepts a plain lambda or a\n * generator; a generator guard resolves craft dependencies with `yield*`, and\n * those dependencies join the machine's dependency graph.\n *\n * ```ts\n * transitionGuard(({ context }) => context.form.isValid());\n *\n * transitionGuard(function* ({ context, from, to, event }) {\n *   const policy = yield* PolicyService();\n *   return policy.canTransition({ from, to, event });\n * });\n * ```\n */\nexport function transitionGuard<\n  Transition extends CraftTransition<any, any, any>,\n  Yielded = never,\n>(\n  guard: (\n    transition: Transition,\n  ) => boolean | Generator<Yielded, boolean, unknown>,\n): CraftTransitionGuard<Transition, Yielded> {\n  return Object.assign(guard, {\n    [TRANSITION_GUARD_MARKER]: true as const,\n  }) as CraftTransitionGuard<Transition, Yielded>;\n}\n\n/**\n * Declares how a machine enters one step. The generator runs once, at machine\n * creation, and registers the reactions that may move the machine here\n * (`on$`, `afterRecomputation`, `initStateMachine`).\n *\n * `transitionStep(...).pipe(transitionGuard(...))` guards every transition\n * declared in that step.\n */\nexport function transitionStep<Yielded = never>(\n  setup: () => Generator<Yielded, unknown, unknown> | void,\n): CraftTransitionStep<Yielded> {\n  return createTransitionStep(setup as () => unknown, []);\n}\n\n/**\n * Builds every transition of a machine. The setup generator receives the\n * machine `context` and `transit`, and returns one {@link transitionStep} per\n * step; the record's keys ARE the machine's steps.\n *\n * `transitionsSetup(...).pipe(transitionGuard(...))` guards every transition of\n * every step.\n *\n * Declared standalone, the setup's `context` parameter has to be annotated —\n * typically with `CraftMachineContext<typeof contextFactory>`; `craftStateMachine`\n * then checks the machine's real context against that annotation.\n */\nexport function transitionsSetup<\n  Context,\n  StepsRecord extends AnyStepsRecord,\n  SetupYielded = never,\n>(\n  setup: CraftTransitionsSetupFn<Context, StepsRecord, SetupYielded>,\n): CraftTransitionsSetup<Context, StepsRecord, SetupYielded> {\n  return createTransitionsSetup(\n    setup as unknown as (context: unknown, transit: unknown) => unknown,\n    [],\n  ) as unknown as CraftTransitionsSetup<Context, StepsRecord, SetupYielded>;\n}\n\n/**\n * Registers the callback that gives the machine its initial step. Registrations\n * run after every step has been installed, in declaration order, and the first\n * accepted `transit()` wins — later init registrations are skipped.\n *\n * ```ts\n * yield* initStateMachine(() => transit());\n * ```\n */\nexport function initStateMachine<Yielded = never>(\n  callback: () => Generator<Yielded, unknown, unknown> | void,\n): CraftMachineRegistration<Yielded | CraftMachineInitRequest> {\n  return ɵregisterMachineInit(callback as () => unknown) as CraftMachineRegistration<\n    Yielded | CraftMachineInitRequest\n  >;\n}\n\n// ---------------------------------------------------------------------------\n// craftStateMachine\n// ---------------------------------------------------------------------------\n\ntype ContextFactory<Yielded, Context> = () => Generator<\n  Yielded,\n  Context,\n  unknown\n>;\n\ntype CurrentStepWithContextFactory<Context, Yielded, StepContexts> = (\n  context: Context,\n) => Generator<Yielded, StepContexts, unknown>;\n\ntype MachineInsertion<Context, Steps extends string, StepContexts, Yielded, Insertions> =\n  (\n    context: CraftMachineInsertionContext<Context, Steps, StepContexts>,\n  ) => Generator<Yielded, Insertions, unknown> | Insertions;\n\n/** Everything the transitions advertise: the setup's yields plus each step's. */\ntype MachineYielded<SetupYielded, StepsRecord extends AnyStepsRecord> =\n  | SetupYielded\n  | StepsRecordYielded<StepsRecord>;\n\ntype MachineDependencies<\n  ContextYielded,\n  TransitionsYielded,\n  StepContextYielded,\n  InsertionYielded,\n> = CompleteServiceDependencyMapFromYielded<\n  ContextYielded | TransitionsYielded | StepContextYielded | InsertionYielded\n>;\n\nexport function craftStateMachine<\n  Name extends string,\n  ContextYielded,\n  Context extends object,\n  StepsRecord extends AnyStepsRecord,\n  SetupYielded,\n  StepContextYielded,\n  StepContexts extends Record<MachineSteps<StepsRecord>, unknown>,\n  InsertionYielded,\n  Insertions,\n>(\n  name: Name,\n  contextFactory: ContextFactory<ContextYielded, Context>,\n  transitions: CraftTransitionsInput<\n    NoInfer<Context>,\n    StepsRecord,\n    SetupYielded\n  > &\n    CraftMachineInitRequirement<MachineYielded<SetupYielded, StepsRecord>>,\n  currentStepWithContextFactory: CurrentStepWithContextFactory<\n    NoInfer<Context>,\n    StepContextYielded,\n    StepContexts\n  >,\n  insertion: MachineInsertion<\n    NoInfer<Context>,\n    NoInfer<MachineSteps<StepsRecord>>,\n    NoInfer<StepContexts>,\n    InsertionYielded,\n    Insertions\n  >,\n): NamedCraftPrimitiveGen<\n  Name,\n  CraftStateMachineOutput<\n    Context,\n    MachineSteps<StepsRecord>,\n    StepContexts,\n    Insertions,\n    MachineDependencies<\n      ContextYielded,\n      MachineYielded<SetupYielded, StepsRecord>,\n      StepContextYielded,\n      InsertionYielded\n    >\n  >\n>;\nexport function craftStateMachine<\n  Name extends string,\n  ContextYielded,\n  Context extends object,\n  StepsRecord extends AnyStepsRecord,\n  SetupYielded,\n  StepContextYielded,\n  StepContexts extends Record<MachineSteps<StepsRecord>, unknown>,\n>(\n  name: Name,\n  contextFactory: ContextFactory<ContextYielded, Context>,\n  transitions: CraftTransitionsInput<\n    NoInfer<Context>,\n    StepsRecord,\n    SetupYielded\n  > &\n    CraftMachineInitRequirement<MachineYielded<SetupYielded, StepsRecord>>,\n  currentStepWithContextFactory: CurrentStepWithContextFactory<\n    NoInfer<Context>,\n    StepContextYielded,\n    StepContexts\n  >,\n): NamedCraftPrimitiveGen<\n  Name,\n  CraftStateMachineOutput<\n    Context,\n    MachineSteps<StepsRecord>,\n    StepContexts,\n    {},\n    MachineDependencies<\n      ContextYielded,\n      MachineYielded<SetupYielded, StepsRecord>,\n      StepContextYielded,\n      never\n    >\n  >\n>;\nexport function craftStateMachine<\n  ContextYielded,\n  Context extends object,\n  StepsRecord extends AnyStepsRecord,\n  SetupYielded,\n  StepContextYielded,\n  StepContexts extends Record<MachineSteps<StepsRecord>, unknown>,\n  InsertionYielded,\n  Insertions,\n>(\n  contextFactory: ContextFactory<ContextYielded, Context>,\n  transitions: CraftTransitionsInput<\n    NoInfer<Context>,\n    StepsRecord,\n    SetupYielded\n  > &\n    CraftMachineInitRequirement<MachineYielded<SetupYielded, StepsRecord>>,\n  currentStepWithContextFactory: CurrentStepWithContextFactory<\n    NoInfer<Context>,\n    StepContextYielded,\n    StepContexts\n  >,\n  insertion: MachineInsertion<\n    NoInfer<Context>,\n    NoInfer<MachineSteps<StepsRecord>>,\n    NoInfer<StepContexts>,\n    InsertionYielded,\n    Insertions\n  >,\n): NamedCraftPrimitiveGen<\n  'stateMachine',\n  CraftStateMachineOutput<\n    Context,\n    MachineSteps<StepsRecord>,\n    StepContexts,\n    Insertions,\n    MachineDependencies<\n      ContextYielded,\n      MachineYielded<SetupYielded, StepsRecord>,\n      StepContextYielded,\n      InsertionYielded\n    >\n  >\n>;\nexport function craftStateMachine<\n  ContextYielded,\n  Context extends object,\n  StepsRecord extends AnyStepsRecord,\n  SetupYielded,\n  StepContextYielded,\n  StepContexts extends Record<MachineSteps<StepsRecord>, unknown>,\n>(\n  contextFactory: ContextFactory<ContextYielded, Context>,\n  transitions: CraftTransitionsInput<\n    NoInfer<Context>,\n    StepsRecord,\n    SetupYielded\n  > &\n    CraftMachineInitRequirement<MachineYielded<SetupYielded, StepsRecord>>,\n  currentStepWithContextFactory: CurrentStepWithContextFactory<\n    NoInfer<Context>,\n    StepContextYielded,\n    StepContexts\n  >,\n): NamedCraftPrimitiveGen<\n  'stateMachine',\n  CraftStateMachineOutput<\n    Context,\n    MachineSteps<StepsRecord>,\n    StepContexts,\n    {},\n    MachineDependencies<\n      ContextYielded,\n      MachineYielded<SetupYielded, StepsRecord>,\n      StepContextYielded,\n      never\n    >\n  >\n>;\nexport function craftStateMachine(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  nameOrContextFactory: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextFactoryOrTransitions?: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  transitionsOrCurrentStepWithContextFactory?: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  currentStepWithContextFactoryOrInsertion?: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  maybeInsertion?: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any {\n  const isNamed = typeof nameOrContextFactory === 'string';\n  const name = isNamed ? nameOrContextFactory : 'stateMachine';\n  const contextFactory = isNamed\n    ? contextFactoryOrTransitions\n    : nameOrContextFactory;\n  const transitions = isNamed\n    ? transitionsOrCurrentStepWithContextFactory\n    : contextFactoryOrTransitions;\n  const currentStepWithContextFactory = isNamed\n    ? currentStepWithContextFactoryOrInsertion\n    : transitionsOrCurrentStepWithContextFactory;\n  const insertion = isNamed\n    ? maybeInsertion\n    : currentStepWithContextFactoryOrInsertion;\n\n  const ref = createStateMachineRef(\n    name,\n    contextFactory,\n    transitions,\n    currentStepWithContextFactory,\n    insertion,\n  );\n\n  return createNamedPrimitiveGen(name, ref);\n}\n\n// ---------------------------------------------------------------------------\n// Runtime\n// ---------------------------------------------------------------------------\n\ntype RuntimeTransitionStep = {\n  readonly [TRANSITION_STEP_MARKER]: true;\n  readonly setup: () => unknown;\n  readonly guards: readonly RuntimeTransitionGuard[];\n  readonly pipe: (...guards: RuntimeTransitionGuard[]) => RuntimeTransitionStep;\n};\n\ntype RuntimeTransitionsSetup = {\n  readonly [TRANSITIONS_SETUP_MARKER]: true;\n  readonly setup: (context: unknown, transit: unknown) => unknown;\n  readonly guards: readonly RuntimeTransitionGuard[];\n  readonly pipe: (\n    ...guards: RuntimeTransitionGuard[]\n  ) => RuntimeTransitionsSetup;\n};\n\nfunction createTransitionStep(\n  setup: () => unknown,\n  guards: readonly RuntimeTransitionGuard[],\n): RuntimeTransitionStep & CraftTransitionStep<any> {\n  const step = {\n    [TRANSITION_STEP_MARKER]: true as const,\n    setup,\n    guards,\n    pipe: (...extraGuards: RuntimeTransitionGuard[]) =>\n      createTransitionStep(setup, [...guards, ...extraGuards]),\n  };\n\n  return step as RuntimeTransitionStep & CraftTransitionStep<any>;\n}\n\nfunction createTransitionsSetup(\n  setup: (context: unknown, transit: unknown) => unknown,\n  guards: readonly RuntimeTransitionGuard[],\n): RuntimeTransitionsSetup {\n  return {\n    [TRANSITIONS_SETUP_MARKER]: true as const,\n    setup,\n    guards,\n    pipe: (...extraGuards: RuntimeTransitionGuard[]) =>\n      createTransitionsSetup(setup, [...guards, ...extraGuards]),\n  };\n}\n\nfunction createTransitionAttempt(\n  event: unknown,\n  localGuards: readonly RuntimeTransitionGuard[],\n): Generator<unknown, boolean, unknown> {\n  // The scope is captured at CREATION time: `transit(...)` is called from inside\n  // a registration callback, which the machine runs with its declaring step\n  // restored. Reading it lazily would resolve the wrong target.\n  const scope = ɵrequireMachineScope('transit(...)');\n  const attempt = ɵrunTransition(scope, event, localGuards);\n\n  return Object.assign(attempt, {\n    pipe: (...guards: RuntimeTransitionGuard[]) =>\n      ɵwithMachineScope(scope, () =>\n        createTransitionAttempt(event, [...localGuards, ...guards]),\n      ),\n  });\n}\n\nfunction createTransit(): (event?: unknown) => unknown {\n  return (event?: unknown) => createTransitionAttempt(event, []);\n}\n\nfunction isStepsRecord(value: unknown): value is Record<string, RuntimeTransitionStep> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction driveFactory(\n  factory: (...args: never[]) => unknown,\n  injector: Injector,\n  ...args: unknown[]\n): unknown {\n  const wrapped = runInInjectionContext(injector, () =>\n    injectFnWrapper()(factory as (...values: unknown[]) => unknown),\n  );\n\n  return runInInjectionContext(injector, () =>\n    ɵdriveMachineGenerator(wrapped(...args), injector),\n  );\n}\n\nfunction exposeInsertionOutput(\n  output: Record<string, unknown>,\n  injector: Injector,\n): Record<string, unknown> {\n  return Object.entries(output).reduce(\n    (exposed, [key, value]) => {\n      if (isYieldableReactiveValue(value)) {\n        exposed[key] = nameInsertedReactiveValue(\n          value,\n          key,\n          'craftStateMachine',\n          `craftStateMachine.${key}`,\n        );\n        return exposed;\n      }\n\n      if (isSource(value) || isSignal(value) || isYieldableMethod(value)) {\n        exposed[key] = value;\n        return exposed;\n      }\n\n      if (typeof value === 'function' && !isNonYieldableInsertionMethod(value)) {\n        const methodInjector = ɵcreateHostTaggedInjector(\n          injector,\n          `method:${key}`,\n        );\n        const wrappedFn = runInInjectionContext(methodInjector, () =>\n          injectFnWrapper()(value as (...args: unknown[]) => unknown),\n        );\n        exposed[key] = createYieldableInsertionMethod(wrappedFn, {\n          injector: methodInjector,\n          invalidYieldErrorMessage:\n            'craftStateMachine insertion method generators can only yield craftService dependencies or exposed dependency helpers.',\n          multipleAppStartErrorMessage:\n            'craftStateMachine insertion methods do not support multiple onAppStart(...) declarations.',\n          onAppStartNotSupportedErrorMessage:\n            'craftStateMachine insertion methods do not support onAppStart(...).',\n        });\n        return exposed;\n      }\n\n      exposed[key] = value;\n      return exposed;\n    },\n    {} as Record<string, unknown>,\n  );\n}\n\n/**\n * Normalises the two accepted forms: a bare setup generator carries no\n * machine-wide guard, so it becomes a setup with an empty guard list.\n */\nfunction toRuntimeTransitionsSetup(\n  transitions: RuntimeTransitionsSetup | ((...args: never[]) => unknown),\n): RuntimeTransitionsSetup {\n  return typeof transitions === 'function'\n    ? createTransitionsSetup(\n        transitions as unknown as (context: unknown, transit: unknown) => unknown,\n        [],\n      )\n    : transitions;\n}\n\nfunction createStateMachineRef(\n  name: string,\n  contextFactory: () => unknown,\n  transitionsInput: RuntimeTransitionsSetup | ((...args: never[]) => unknown),\n  currentStepWithContextFactory?: (context: unknown) => unknown,\n  insertion?: (context: unknown) => unknown,\n): Record<string, unknown> {\n  assertInInjectionContext(craftStateMachine);\n  const transitions = toRuntimeTransitionsSetup(transitionsInput);\n  const injector = ɵcreateHostTaggedInjector(\n    inject(Injector),\n    `stateMachine:${name}`,\n  );\n\n  return runInInjectionContext(injector, () => {\n    const context = driveFactory(contextFactory, injector) as Record<\n      string,\n      unknown\n    >;\n\n    const stepContexts = (\n      currentStepWithContextFactory\n        ? driveFactory(\n            currentStepWithContextFactory as (...args: never[]) => unknown,\n            injector,\n            context,\n          )\n        : {}\n    ) as Record<string, unknown>;\n\n    const currentStep = craftSignal<string | undefined>(undefined);\n    const runtime: MachineRuntime = {\n      context,\n      currentStep,\n      globalGuards: transitions.guards,\n      stepGuards: new Map(),\n      injector,\n      initRegistrations: [],\n      observers: new Set(),\n      suspended: false,\n    };\n\n    const stepsRecord = driveFactory(\n      transitions.setup as (...args: never[]) => unknown,\n      injector,\n      context,\n      createTransit(),\n    );\n\n    if (!isStepsRecord(stepsRecord)) {\n      throw new Error(\n        'transitionsSetup(...) must return a record of transitionStep(...) entries.',\n      );\n    }\n\n    for (const [step, definition] of Object.entries(stepsRecord)) {\n      runtime.stepGuards.set(step, definition.guards ?? []);\n    }\n\n    for (const [step, definition] of Object.entries(stepsRecord)) {\n      ɵwithMachineScope({ runtime, target: step }, () =>\n        runInInjectionContext(injector, () =>\n          ɵdriveMachineGenerator(definition.setup(), injector),\n        ),\n      );\n    }\n\n    // Installation is over: the machine can now take its initial step. The\n    // first accepted transit wins, so a later registration is not even run.\n    for (const registration of runtime.initRegistrations) {\n      if (currentStep() !== undefined) {\n        break;\n      }\n      registration();\n    }\n\n    if (currentStep() === undefined) {\n      throw new Error(\n        `craftStateMachine \"${name}\" did not initialise: its initial transition was rejected by a guard.`,\n      );\n    }\n\n    const currentStepReader = createYieldableReactiveValue(\n      currentStep.asReadonly(),\n      'currentStep',\n    );\n    const currentStepWithContextReader = createYieldableReactiveValue(\n      createCraftComputed(() => {\n        const step = currentStep();\n        if (step === undefined) return undefined;\n        return Object.assign({}, stepContexts[step] as object, { step });\n      }),\n      'currentStepWithContext',\n    );\n\n    const ref: Record<string, unknown> = {\n      currentStep: currentStepReader,\n      currentStepWithContext: currentStepWithContextReader,\n      context,\n    };\n\n    if (insertion) {\n      const controls = {\n        hostTags: injector.get(ɵHOST_TAG_LIST, []) as readonly string[],\n        onTransition: (observer: MachineTransitionObserver) => {\n          runtime.observers.add(observer);\n          return () => runtime.observers.delete(observer);\n        },\n        restoreStep: (step: string) => {\n          if (step === undefined) {\n            throw new Error(\n              `craftStateMachine \"${name}\" cannot restore an undefined step.`,\n            );\n          }\n          ɵrestoreMachineStep(runtime, step);\n        },\n        suspended: <Result,>(restore: () => Result) =>\n          ɵwithSuspendedMachine(runtime, restore),\n      };\n\n      const output = driveFactory(\n        insertion as (...args: never[]) => unknown,\n        injector,\n        {\n          context,\n          currentStep: currentStepReader,\n          currentStepWithContext: currentStepWithContextReader,\n          machine: controls,\n        },\n      );\n\n      Object.assign(\n        ref,\n        exposeInsertionOutput(\n          (output ?? {}) as Record<string, unknown>,\n          injector,\n        ),\n      );\n    }\n\n    return ref;\n  });\n}\n"]}

package/src/lib/craft-target-runtime.d.ts

@@ -0,0 +1,20 @@
+import { InjectionToken, type Injector, type Provider } from './host/craft-compat';
+export type CraftTargetKind = 'component' | 'directive';
+export type CraftTargetContext = Readonly<{
+    target: unknown;
+    kind: CraftTargetKind;
+    name: string;
+    ref: unknown;
+    hostName: string;
+    injector: Injector;
+}>;
+export type CraftTargetContextOverrides = Readonly<{
+    hostName?: string;
+}>;
+export type CraftTargetRelease = () => void;
+export type CraftTargetWrapper = (context: CraftTargetContext, next: (overrides?: CraftTargetContextOverrides) => Generator<unknown, CraftTargetRelease, unknown>) => Generator<unknown, CraftTargetRelease, unknown>;
+export declare const CRAFT_TARGET_WRAPPER: InjectionToken<readonly CraftTargetWrapper[]>;
+/** Adds a wrapper around the lifecycle registration of Craft targets. */
+export declare function provideCraftTargetWrapper(_warning: string, wrapper: CraftTargetWrapper): Provider;
+export declare function ɵrunCraftTargetWrappers(injector: Injector, context: CraftTargetContext, autoCleanup: boolean): CraftTargetRelease;
+//# sourceMappingURL=craft-target-runtime.d.ts.map

package/src/lib/craft-target-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-target-runtime.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-target-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAE5C,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,CACJ,SAAS,CAAC,EAAE,2BAA2B,KACpC,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,KACjD,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAErD,eAAO,MAAM,oBAAoB,+CAM/B,CAAC;AAEH,yEAAyE;AACzE,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kBAAkB,GAC1B,QAAQ,CAMV;AAOD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,OAAO,GACnB,kBAAkB,CAgCpB"}

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

@@ -0,0 +1,42 @@
+import { DestroyRef, InjectionToken, } from './host/craft-compat';
+import { runCraftGenerator } from './craft-generator-runtime';
+export const CRAFT_TARGET_WRAPPER = new InjectionToken('CRAFT_TARGET_WRAPPER', {
+    providedIn: 'root',
+    factory: () => [],
+    multi: true,
+});
+/** Adds a wrapper around the lifecycle registration of Craft targets. */
+export function provideCraftTargetWrapper(_warning, wrapper) {
+    return {
+        provide: CRAFT_TARGET_WRAPPER,
+        useValue: wrapper,
+        multi: true,
+    };
+}
+const EMPTY_RELEASE = () => undefined;
+export function ɵrunCraftTargetWrappers(injector, context, autoCleanup) {
+    const wrappers = injector.get(CRAFT_TARGET_WRAPPER, []);
+    let next = function* () {
+        return EMPTY_RELEASE;
+    };
+    for (let index = wrappers.length - 1; index >= 0; index -= 1) {
+        const wrapper = wrappers[index];
+        const inner = next;
+        next = (current) => (function* () {
+            return yield* wrapper(current, (overrides) => inner({ ...current, ...overrides }));
+        })();
+    }
+    const release = runCraftGenerator({
+        iterator: next(context),
+        injector,
+        hostScope: 'function',
+        invalidYieldErrorMessage: 'Craft target wrappers can only yield Craft dependencies.',
+        multipleAppStartErrorMessage: 'Craft target wrappers cannot declare app-start hooks more than once.',
+        onAppStartNotSupportedErrorMessage: 'Craft target wrappers cannot declare app-start hooks.',
+    }).value;
+    if (autoCleanup) {
+        injector.get(DestroyRef, null)?.onDestroy(release);
+    }
+    return release;
+}
+//# sourceMappingURL=craft-target-runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-target-runtime.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-target-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,GAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AA0B9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,cAAc,CAEpD,sBAAsB,EAAE;IACxB,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;IACjB,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,OAA2B;IAE3B,OAAO;QACL,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAuB,GAAG,EAAE,CAAC,SAAS,CAAC;AAK1D,MAAM,UAAU,uBAAuB,CACrC,QAAkB,EAClB,OAA2B,EAC3B,WAAoB;IAEpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,IAAI,GAA6B,QAAQ,CAAC;QAC5C,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CACjB,CAAC,QAAQ,CAAC;YACR,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAC3C,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC,CACpC,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;QACvB,QAAQ;QACR,SAAS,EAAE,UAAU;QACrB,wBAAwB,EACtB,0DAA0D;QAC5D,4BAA4B,EAC1B,sEAAsE;QACxE,kCAAkC,EAChC,uDAAuD;KAC1D,CAAC,CAAC,KAA2B,CAAC;IAC/B,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  DestroyRef,\n  InjectionToken,\n  type Injector,\n  type Provider,\n} from './host/craft-compat';\nimport { runCraftGenerator } from './craft-generator-runtime';\n\nexport type CraftTargetKind = 'component' | 'directive';\n\nexport type CraftTargetContext = Readonly<{\n  target: unknown;\n  kind: CraftTargetKind;\n  name: string;\n  ref: unknown;\n  hostName: string;\n  injector: Injector;\n}>;\n\nexport type CraftTargetContextOverrides = Readonly<{\n  hostName?: string;\n}>;\n\nexport type CraftTargetRelease = () => void;\n\nexport type CraftTargetWrapper = (\n  context: CraftTargetContext,\n  next: (\n    overrides?: CraftTargetContextOverrides,\n  ) => Generator<unknown, CraftTargetRelease, unknown>,\n) => Generator<unknown, CraftTargetRelease, unknown>;\n\nexport const CRAFT_TARGET_WRAPPER = new InjectionToken<\n  readonly CraftTargetWrapper[]\n>('CRAFT_TARGET_WRAPPER', {\n  providedIn: 'root',\n  factory: () => [],\n  multi: true,\n});\n\n/** Adds a wrapper around the lifecycle registration of Craft targets. */\nexport function provideCraftTargetWrapper(\n  _warning: string,\n  wrapper: CraftTargetWrapper,\n): Provider {\n  return {\n    provide: CRAFT_TARGET_WRAPPER,\n    useValue: wrapper,\n    multi: true,\n  };\n}\n\nconst EMPTY_RELEASE: CraftTargetRelease = () => undefined;\ntype CraftTargetWrapperRunner = (\n  context: CraftTargetContext,\n) => Generator<unknown, CraftTargetRelease, unknown>;\n\nexport function ɵrunCraftTargetWrappers(\n  injector: Injector,\n  context: CraftTargetContext,\n  autoCleanup: boolean,\n): CraftTargetRelease {\n  const wrappers = injector.get(CRAFT_TARGET_WRAPPER, []);\n  let next: CraftTargetWrapperRunner = function* () {\n    return EMPTY_RELEASE;\n  };\n\n  for (let index = wrappers.length - 1; index >= 0; index -= 1) {\n    const wrapper = wrappers[index]!;\n    const inner = next;\n    next = (current) =>\n      (function* () {\n        return yield* wrapper(current, (overrides) =>\n          inner({ ...current, ...overrides }),\n        );\n      })();\n  }\n\n  const release = runCraftGenerator({\n    iterator: next(context),\n    injector,\n    hostScope: 'function',\n    invalidYieldErrorMessage:\n      'Craft target wrappers can only yield Craft dependencies.',\n    multipleAppStartErrorMessage:\n      'Craft target wrappers cannot declare app-start hooks more than once.',\n    onAppStartNotSupportedErrorMessage:\n      'Craft target wrappers cannot declare app-start hooks.',\n  }).value as CraftTargetRelease;\n  if (autoCleanup) {\n    injector.get(DestroyRef, null)?.onDestroy(release);\n  }\n  return release;\n}\n"]}

package/src/lib/craft-transfer-snapshot.d.ts

@@ -0,0 +1,19 @@
+import type { CraftPrimitiveRegistry } from './craft-primitive-registry';
+export declare const CRAFT_TRANSFER_SNAPSHOT_VERSION = 1;
+export type CraftTransferQuerySnapshot = Readonly<{
+    status: string;
+    value?: unknown;
+    error?: unknown;
+}>;
+export type CraftTransferSnapshot = Readonly<{
+    version: number;
+    values: Readonly<Record<string, unknown>>;
+    queries: Readonly<Record<string, CraftTransferQuerySnapshot>>;
+}>;
+/** Captures only JSON-compatible state; non-serializable entries fail loudly. */
+export declare function captureCraftTransferSnapshot(registry: CraftPrimitiveRegistry): CraftTransferSnapshot;
+/** Primes registrations that will be created during the first client render. */
+export declare function primeCraftTransferSnapshot(registry: CraftPrimitiveRegistry, snapshot: CraftTransferSnapshot): void;
+/** JSON safe for embedding in an HTML script element. */
+export declare function serializeCraftTransferSnapshot(snapshot: CraftTransferSnapshot): string;
+//# sourceMappingURL=craft-transfer-snapshot.d.ts.map

package/src/lib/craft-transfer-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-transfer-snapshot.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-transfer-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC;CAC/D,CAAC,CAAC;AAEH,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,sBAAsB,GAC/B,qBAAqB,CAwBvB;AAQD,gFAAgF;AAChF,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAcN;AAED,yDAAyD;AACzD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CAOR"}

package/src/lib/craft-transfer-snapshot.js

@@ -0,0 +1,90 @@
+export const CRAFT_TRANSFER_SNAPSHOT_VERSION = 1;
+/** Captures only JSON-compatible state; non-serializable entries fail loudly. */
+export function captureCraftTransferSnapshot(registry) {
+    const values = {};
+    const queries = {};
+    for (const entry of registry.list()) {
+        const value = readSerializableEntry(entry);
+        if (value === SKIP_ENTRY)
+            continue;
+        if (entry.kind === 'query') {
+            const error = entry.error?.();
+            queries[entry.address] = {
+                status: entry.status?.() ?? (value === undefined ? 'idle' : 'resolved'),
+                ...(value === undefined ? {} : { value }),
+                ...(error === undefined ? {} : { error: serializeError(error) }),
+            };
+        }
+        else {
+            values[entry.address] = value;
+        }
+    }
+    return {
+        version: CRAFT_TRANSFER_SNAPSHOT_VERSION,
+        values,
+        queries,
+    };
+}
+function serializeError(error) {
+    return error instanceof Error
+        ? { name: error.name, message: error.message }
+        : error;
+}
+/** Primes registrations that will be created during the first client render. */
+export function primeCraftTransferSnapshot(registry, snapshot) {
+    if (snapshot.version !== CRAFT_TRANSFER_SNAPSHOT_VERSION) {
+        throw new Error(`Unsupported Craft transfer snapshot version ${snapshot.version}.`);
+    }
+    registry.prime({
+        ...snapshot.values,
+        ...Object.fromEntries(Object.entries(snapshot.queries).flatMap(([address, query]) => 'value' in query ? [[address, query.value]] : [])),
+    });
+}
+/** JSON safe for embedding in an HTML script element. */
+export function serializeCraftTransferSnapshot(snapshot) {
+    return JSON.stringify(snapshot)
+        .replaceAll('<', '\\u003c')
+        .replaceAll('>', '\\u003e')
+        .replaceAll('&', '\\u0026')
+        .replaceAll('\u2028', '\\u2028')
+        .replaceAll('\u2029', '\\u2029');
+}
+const SKIP_ENTRY = Symbol('skip-transfer-entry');
+function readSerializableEntry(entry) {
+    let value;
+    try {
+        value = entry.read();
+    }
+    catch {
+        return SKIP_ENTRY;
+    }
+    assertSerializable(value, entry.address, new Set());
+    return value;
+}
+function assertSerializable(value, address, seen) {
+    if (value === null ||
+        value === undefined ||
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return;
+    }
+    if (typeof value === 'bigint' || typeof value === 'function') {
+        throw new Error(`Craft transfer value "${address}" is not JSON-serializable.`);
+    }
+    if (typeof value !== 'object')
+        return;
+    if (seen.has(value)) {
+        throw new Error(`Craft transfer value "${address}" contains a cycle.`);
+    }
+    if (Object.getPrototypeOf(value) !== Object.prototype &&
+        Object.getPrototypeOf(value) !== Array.prototype) {
+        throw new Error(`Craft transfer value "${address}" must contain only plain objects and arrays.`);
+    }
+    seen.add(value);
+    for (const child of Object.values(value)) {
+        assertSerializable(child, address, seen);
+    }
+    seen.delete(value);
+}
+//# sourceMappingURL=craft-transfer-snapshot.js.map

package/src/lib/craft-transfer-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-transfer-snapshot.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-transfer-snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CraftPrimitiveEntry,\n  CraftPrimitiveRegistry,\n} from './craft-primitive-registry';\n\nexport const CRAFT_TRANSFER_SNAPSHOT_VERSION = 1;\n\nexport type CraftTransferQuerySnapshot = Readonly<{\n  status: string;\n  value?: unknown;\n  error?: unknown;\n}>;\n\nexport type CraftTransferSnapshot = Readonly<{\n  version: number;\n  values: Readonly<Record<string, unknown>>;\n  queries: Readonly<Record<string, CraftTransferQuerySnapshot>>;\n}>;\n\n/** Captures only JSON-compatible state; non-serializable entries fail loudly. */\nexport function captureCraftTransferSnapshot(\n  registry: CraftPrimitiveRegistry,\n): CraftTransferSnapshot {\n  const values: Record<string, unknown> = {};\n  const queries: Record<string, CraftTransferQuerySnapshot> = {};\n\n  for (const entry of registry.list()) {\n    const value = readSerializableEntry(entry);\n    if (value === SKIP_ENTRY) continue;\n    if (entry.kind === 'query') {\n      const error = entry.error?.();\n      queries[entry.address] = {\n        status: entry.status?.() ?? (value === undefined ? 'idle' : 'resolved'),\n        ...(value === undefined ? {} : { value }),\n        ...(error === undefined ? {} : { error: serializeError(error) }),\n      };\n    } else {\n      values[entry.address] = value;\n    }\n  }\n\n  return {\n    version: CRAFT_TRANSFER_SNAPSHOT_VERSION,\n    values,\n    queries,\n  };\n}\n\nfunction serializeError(error: unknown): unknown {\n  return error instanceof Error\n    ? { name: error.name, message: error.message }\n    : error;\n}\n\n/** Primes registrations that will be created during the first client render. */\nexport function primeCraftTransferSnapshot(\n  registry: CraftPrimitiveRegistry,\n  snapshot: CraftTransferSnapshot,\n): void {\n  if (snapshot.version !== CRAFT_TRANSFER_SNAPSHOT_VERSION) {\n    throw new Error(\n      `Unsupported Craft transfer snapshot version ${snapshot.version}.`,\n    );\n  }\n  registry.prime({\n    ...snapshot.values,\n    ...Object.fromEntries(\n      Object.entries(snapshot.queries).flatMap(([address, query]) =>\n        'value' in query ? [[address, query.value]] : [],\n      ),\n    ),\n  });\n}\n\n/** JSON safe for embedding in an HTML script element. */\nexport function serializeCraftTransferSnapshot(\n  snapshot: CraftTransferSnapshot,\n): string {\n  return JSON.stringify(snapshot)\n    .replaceAll('<', '\\\\u003c')\n    .replaceAll('>', '\\\\u003e')\n    .replaceAll('&', '\\\\u0026')\n    .replaceAll('\\u2028', '\\\\u2028')\n    .replaceAll('\\u2029', '\\\\u2029');\n}\n\nconst SKIP_ENTRY = Symbol('skip-transfer-entry');\n\nfunction readSerializableEntry(\n  entry: CraftPrimitiveEntry,\n): unknown | typeof SKIP_ENTRY {\n  let value: unknown;\n  try {\n    value = entry.read();\n  } catch {\n    return SKIP_ENTRY;\n  }\n  assertSerializable(value, entry.address, new Set());\n  return value;\n}\n\nfunction assertSerializable(\n  value: unknown,\n  address: string,\n  seen: Set<object>,\n): void {\n  if (\n    value === null ||\n    value === undefined ||\n    typeof value === 'string' ||\n    typeof value === 'number' ||\n    typeof value === 'boolean'\n  ) {\n    return;\n  }\n  if (typeof value === 'bigint' || typeof value === 'function') {\n    throw new Error(\n      `Craft transfer value \"${address}\" is not JSON-serializable.`,\n    );\n  }\n  if (typeof value !== 'object') return;\n  if (seen.has(value)) {\n    throw new Error(`Craft transfer value \"${address}\" contains a cycle.`);\n  }\n  if (\n    Object.getPrototypeOf(value) !== Object.prototype &&\n    Object.getPrototypeOf(value) !== Array.prototype\n  ) {\n    throw new Error(\n      `Craft transfer value \"${address}\" must contain only plain objects and arrays.`,\n    );\n  }\n  seen.add(value);\n  for (const child of Object.values(value)) {\n    assertSerializable(child, address, seen);\n  }\n  seen.delete(value);\n}\n"]}

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

@@ -0,0 +1,7 @@
+export declare const CRAFT_UNIQUE: unique symbol;
+export type CraftUnique<T> = T & {
+    readonly [CRAFT_UNIQUE]: true;
+};
+export declare function craftUnique<const T>(value: T): CraftUnique<T>;
+export declare function isCraftUnique(value: unknown): value is CraftUnique<unknown>;
+//# sourceMappingURL=craft-unique.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-unique.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-unique.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,eAAwB,CAAC;AAElD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG;IAC/B,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAS7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAK3E"}

package/src/lib/craft-unique.js

@@ -0,0 +1,16 @@
+export const CRAFT_UNIQUE = Symbol('craftUnique');
+export function craftUnique(value) {
+    if (value !== null && (typeof value === 'object' || typeof value === 'function')) {
+        Object.defineProperty(value, CRAFT_UNIQUE, {
+            value: true,
+            enumerable: false,
+            configurable: false,
+        });
+    }
+    return value;
+}
+export function isCraftUnique(value) {
+    return ((typeof value === 'object' && value !== null && CRAFT_UNIQUE in value) ||
+        (typeof value === 'function' && CRAFT_UNIQUE in value));
+}
+//# sourceMappingURL=craft-unique.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"craft-unique.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-unique.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAMlD,MAAM,UAAU,WAAW,CAAU,KAAQ;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;QACjF,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE;YACzC,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAuB,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,YAAY,IAAI,KAAK,CAAC;QACtE,CAAC,OAAO,KAAK,KAAK,UAAU,IAAI,YAAY,IAAI,KAAK,CAAC,CACvD,CAAC;AACJ,CAAC","sourcesContent":["export const CRAFT_UNIQUE = Symbol('craftUnique');\n\nexport type CraftUnique<T> = T & {\n  readonly [CRAFT_UNIQUE]: true;\n};\n\nexport function craftUnique<const T>(value: T): CraftUnique<T> {\n  if (value !== null && (typeof value === 'object' || typeof value === 'function')) {\n    Object.defineProperty(value, CRAFT_UNIQUE, {\n      value: true,\n      enumerable: false,\n      configurable: false,\n    });\n  }\n  return value as CraftUnique<T>;\n}\n\nexport function isCraftUnique(value: unknown): value is CraftUnique<unknown> {\n  return (\n    (typeof value === 'object' && value !== null && CRAFT_UNIQUE in value) ||\n    (typeof value === 'function' && CRAFT_UNIQUE in value)\n  );\n}\n"]}