@craft-ts/core 0.7.0-beta.13

package/src/lib/host/craft-router-types.d.ts.map

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

package/src/lib/host/craft-router-types.js

@@ -0,0 +1,35 @@
+/**
+ * Craft-owned structural stand-ins for the Angular router types that the
+ * `craftRoutes` type graph still names. The DSL is unchanged; only the host
+ * types are local.
+ */
+import { InjectionToken } from './craft-compat';
+/**
+ * Emitted once a navigation has committed. Craft's own navigation stream
+ * reports the same two moments Angular's did, so trace consumers keep working.
+ */
+export class NavigationEnd {
+    id;
+    url;
+    urlAfterRedirects;
+    constructor(id, url, urlAfterRedirects) {
+        this.id = id;
+        this.url = url;
+        this.urlAfterRedirects = urlAfterRedirects;
+    }
+}
+export const ActivatedRoute = new InjectionToken('ActivatedRoute');
+export class TitleStrategy {
+    buildTitle(snapshot) {
+        let current = snapshot.root;
+        let title;
+        while (current) {
+            if (typeof current.title === 'string') {
+                title = current.title;
+            }
+            current = current.firstChild;
+        }
+        return title;
+    }
+}
+//# sourceMappingURL=craft-router-types.js.map

package/src/lib/host/craft-router-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-router-types.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/host/craft-router-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAmChD;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,EAAE,CAAS;IACX,GAAG,CAAS;IACZ,iBAAiB,CAAS;IAEnC,YAAY,EAAU,EAAE,GAAW,EAAE,iBAAyB;QAC5D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAoDD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,CAC9C,gBAAgB,CACjB,CAAC;AAEF,MAAM,OAAgB,aAAa;IAEjC,UAAU,CAAC,QAA6B;QACtC,IAAI,OAAO,GAAkC,QAAQ,CAAC,IAAI,CAAC;QAC3D,IAAI,KAAyB,CAAC;QAC9B,OAAO,OAAO,EAAE,CAAC;YACf,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACtC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;QAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF","sourcesContent":["/**\n * Craft-owned structural stand-ins for the Angular router types that the\n * `craftRoutes` type graph still names. The DSL is unchanged; only the host\n * types are local.\n */\n\nimport { InjectionToken } from './craft-compat';\n\nexport type Data = Record<string, unknown>;\n\nexport type UrlSegment = {\n  path: string;\n  parameters: Record<string, string>;\n};\n\nexport type ParamMap = {\n  has(name: string): boolean;\n  get(name: string): string | null;\n  getAll(name: string): string[];\n  keys: string[];\n};\n\nexport type UrlTree = {\n  toString(): string;\n};\n\nexport type GuardResult = boolean | UrlTree;\n\n/** Route params, keyed by the `:name` segments that produced them. */\nexport type Params = Record<string, string>;\n\nexport type CanActivateFn = (\n  route: ActivatedRouteSnapshot,\n  state: RouterStateSnapshot,\n) => GuardResult | Promise<GuardResult>;\n\nexport type CanMatchFn = (\n  route: Route,\n  segments: UrlSegment[],\n) => GuardResult | Promise<GuardResult>;\n\n/**\n * Emitted once a navigation has committed. Craft's own navigation stream\n * reports the same two moments Angular's did, so trace consumers keep working.\n */\nexport class NavigationEnd {\n  readonly id: number;\n  readonly url: string;\n  readonly urlAfterRedirects: string;\n\n  constructor(id: number, url: string, urlAfterRedirects: string) {\n    this.id = id;\n    this.url = url;\n    this.urlAfterRedirects = urlAfterRedirects;\n  }\n}\n\nexport type Route = {\n  path?: string;\n  pathMatch?: 'full' | 'prefix';\n  component?: unknown;\n  loadComponent?: () => Promise<unknown> | unknown;\n  loadChildren?: () => Promise<unknown> | unknown;\n  children?: Route[];\n  canActivate?: unknown[];\n  canMatch?: unknown[];\n  canActivateChild?: unknown[];\n  resolve?: Record<string, unknown>;\n  data?: Data;\n  // Readonly: a route's providers are an input the router only ever reads, and\n  // helpers like loadCraftComponent hand back `readonly` arrays.\n  providers?: readonly unknown[];\n  title?: string | (() => string | Promise<string>);\n  outlet?: string;\n  redirectTo?: string | ((redirectData: PartialMatchRouteSnapshot) => unknown);\n};\n\nexport type ActivatedRouteSnapshot = {\n  routeConfig: Route | null;\n  url: UrlSegment[];\n  params: Record<string, string>;\n  queryParams: Record<string, string>;\n  fragment: string | null;\n  data: Data;\n  outlet: string;\n  title?: string;\n  paramMap: ParamMap;\n  queryParamMap: ParamMap;\n  parent: ActivatedRouteSnapshot | null;\n  root: ActivatedRouteSnapshot;\n  firstChild: ActivatedRouteSnapshot | null;\n  children: ActivatedRouteSnapshot[];\n  pathFromRoot: ActivatedRouteSnapshot[];\n};\n\nexport type RouterStateSnapshot = {\n  url: string;\n  root: ActivatedRouteSnapshot;\n};\n\nexport type PartialMatchRouteSnapshot = ActivatedRouteSnapshot;\n\nexport type ActivatedRoute = {\n  snapshot: ActivatedRouteSnapshot;\n  pathFromRoot: ActivatedRoute[];\n};\n\nexport const ActivatedRoute = new InjectionToken<ActivatedRoute>(\n  'ActivatedRoute',\n);\n\nexport abstract class TitleStrategy {\n  abstract updateTitle(snapshot: RouterStateSnapshot): void;\n  buildTitle(snapshot: RouterStateSnapshot): string | undefined {\n    let current: ActivatedRouteSnapshot | null = snapshot.root;\n    let title: string | undefined;\n    while (current) {\n      if (typeof current.title === 'string') {\n        title = current.title;\n      }\n      current = current.firstChild;\n    }\n    return title;\n  }\n}\n"]}

package/src/lib/host/craft-signal.d.ts

@@ -0,0 +1,45 @@
+export declare const CRAFT_SIGNAL: unique symbol;
+export type CraftSignal<T> = (() => T) & {
+    readonly [CRAFT_SIGNAL]: true;
+};
+export type CraftWritableSignal<T> = CraftSignal<T> & {
+    set(value: T): void;
+    update(fn: (value: T) => T): void;
+    asReadonly(): CraftSignal<T>;
+};
+type CraftSignalOptions<T> = {
+    readonly equal?: (a: T, b: T) => boolean;
+    readonly debugName?: string;
+};
+type CraftWatchOptions = {
+    readonly debugName?: string;
+    readonly injector?: unknown;
+    readonly manualCleanup?: boolean;
+};
+export declare function ɵbrandAsCraftSignal<T>(value: () => T): CraftSignal<T>;
+export declare function craftSignal<T>(initial: T, options?: CraftSignalOptions<T>): CraftWritableSignal<T>;
+export declare function craftComputed<T>(compute: () => T): CraftSignal<T>;
+export declare function craftComputed<T>(compute: () => T, options: CraftSignalOptions<T>): CraftSignal<T>;
+export declare function craftLinkedSignal<T>(options: {
+    source: () => unknown;
+    computation: () => T;
+    equal?: (a: T, b: T) => boolean;
+    debugName?: string;
+}): CraftWritableSignal<T>;
+export declare function craftWatch(fn: () => void | (() => void), _options?: CraftWatchOptions): {
+    destroy(): void;
+};
+/**
+ * Publishes every write made inside `fn` as ONE update: readers and effects run
+ * after the last write, never between two of them.
+ *
+ * Craft effects run synchronously, so two writes that only make sense together
+ * — a nonce and the params it tags, a value and the status that describes it —
+ * have to say so, or a reader woken by the first one observes the half-written
+ * state and acts on it.
+ */
+export declare function craftBatch<T>(fn: () => T): T;
+export declare function untracked<T>(fn: () => T): T;
+export declare function isCraftSignal(value: unknown): value is CraftSignal<unknown>;
+export {};
+//# sourceMappingURL=craft-signal.d.ts.map

package/src/lib/host/craft-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-signal.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/host/craft-signal.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG;IACvC,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACpD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAClC,UAAU,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,kBAAkB,CAAC,CAAC,IAAI;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAErE;AA0BD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,mBAAmB,CAAC,CAAC,CAAC,CAwBxB;AAeD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AACnE,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,CAAC,EAChB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAAC;AAqClB,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE;IAC5C,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAwCzB;AAED,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAC7B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAOrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAO5C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAO3C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAK3E"}

package/src/lib/host/craft-signal.js

@@ -0,0 +1,161 @@
+import { computed, effect, endBatch, setActiveSub, signal, startBatch, } from 'alien-signals';
+import { RAW_REACTIVE_VALUE } from '../reactive-read';
+// alien-signals v3 flushes effects synchronously. Outlet view-transition
+// swaps also run CRAFT_SYNC_TEMPLATE_FLUSH inside startViewTransition.
+export const CRAFT_SIGNAL = Symbol('craft-signal');
+export function ɵbrandAsCraftSignal(value) {
+    return brand(value);
+}
+function brand(value) {
+    Object.defineProperties(value, {
+        [CRAFT_SIGNAL]: {
+            value: true,
+            enumerable: false,
+        },
+        [RAW_REACTIVE_VALUE]: {
+            value,
+            enumerable: false,
+        },
+    });
+    return value;
+}
+function withAsReadonly(value) {
+    const writable = value;
+    if (typeof writable.asReadonly !== 'function') {
+        writable.asReadonly = () => value;
+    }
+    return value;
+}
+export function craftSignal(initial, options) {
+    // The value travels in a fresh box on every accepted write. alien-signals
+    // compares the stored value by identity and drops a write that does not
+    // change it — which would silently override `equal`, the very option callers
+    // use to publish an in-place mutation (`map.set(k, v); return map`). Boxing
+    // makes `equal` the only thing that decides whether a write propagates.
+    const raw = signal({ value: initial });
+    const equal = options?.equal ?? Object.is;
+    const read = () => raw().value;
+    const value = (() => read());
+    value.set = (next) => {
+        if (!equal(untracked(read), next)) {
+            raw({ value: next });
+        }
+    };
+    value.update = (update) => value.set(update(untracked(read)));
+    const branded = brand(value);
+    branded.asReadonly = () => craftComputed(() => branded());
+    return branded;
+}
+export function craftComputed(compute, options) {
+    const equal = options?.equal ?? Object.is;
+    let hasPrevious = false;
+    const derived = computed((previous) => {
+        let next;
+        try {
+            next = { ok: true, value: compute() };
+        }
+        catch (error) {
+            next = { ok: false, error };
+        }
+        // Identity is preserved only between two equal VALUES: a throw is never
+        // equal to anything, so a recovering computation always notifies.
+        const result = hasPrevious && previous?.ok && next.ok && equal(previous.value, next.value)
+            ? previous
+            : next;
+        hasPrevious = true;
+        return result;
+    });
+    const value = (() => {
+        const settlement = derived();
+        // A computed read from inside its own first evaluation has nothing settled
+        // yet, and alien-signals hands back the node's still-unassigned value. That
+        // is a cycle in the graph, and it stays the caller's to resolve — but it
+        // reads as `undefined`, exactly as it did before outcomes were boxed, and
+        // not as a TypeError raised in here about a wrapper the caller never saw.
+        if (settlement === undefined)
+            return undefined;
+        if (!settlement.ok)
+            throw settlement.error;
+        return settlement.value;
+    });
+    return withAsReadonly(brand(value));
+}
+export function craftLinkedSignal(options) {
+    const revision = signal(0);
+    const equal = options.equal ?? Object.is;
+    let hasSource = false;
+    let previousSource;
+    let hasComputedValue = false;
+    let localOverride = false;
+    let localValue;
+    const derived = computed((previous) => {
+        revision();
+        const source = options.source();
+        if (!hasSource || !Object.is(previousSource, source)) {
+            hasSource = true;
+            previousSource = source;
+            localOverride = false;
+        }
+        if (localOverride) {
+            return localValue;
+        }
+        const next = options.computation();
+        const result = hasComputedValue && equal(previous, next) ? previous : next;
+        hasComputedValue = true;
+        return result;
+    });
+    const value = (() => derived());
+    value.set = (next) => {
+        if (!hasSource) {
+            previousSource = untracked(options.source);
+            hasSource = true;
+        }
+        localValue = next;
+        localOverride = true;
+        revision(untracked(() => revision()) + 1);
+    };
+    value.update = (update) => value.set(update(untracked(() => derived())));
+    const branded = brand(value);
+    branded.asReadonly = () => craftComputed(() => branded());
+    return branded;
+}
+export function craftWatch(fn, _options) {
+    // alien-signals has no injector ownership. The overload preserves the Task 2
+    // call shape; boundary helpers remain responsible for injector teardown.
+    // Detach watches from the currently active Alien subscriber so an
+    // independently-owned watch is not disposed with a transient parent effect.
+    const destroy = untracked(() => effect(fn));
+    return { destroy };
+}
+/**
+ * Publishes every write made inside `fn` as ONE update: readers and effects run
+ * after the last write, never between two of them.
+ *
+ * Craft effects run synchronously, so two writes that only make sense together
+ * — a nonce and the params it tags, a value and the status that describes it —
+ * have to say so, or a reader woken by the first one observes the half-written
+ * state and acts on it.
+ */
+export function craftBatch(fn) {
+    startBatch();
+    try {
+        return fn();
+    }
+    finally {
+        endBatch();
+    }
+}
+export function untracked(fn) {
+    const previous = setActiveSub();
+    try {
+        return fn();
+    }
+    finally {
+        setActiveSub(previous);
+    }
+}
+export function isCraftSignal(value) {
+    return (typeof value === 'function' &&
+        value[CRAFT_SIGNAL] === true);
+}
+//# sourceMappingURL=craft-signal.js.map

package/src/lib/host/craft-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-signal.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/host/craft-signal.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  computed,\n  effect,\n  endBatch,\n  setActiveSub,\n  signal,\n  startBatch,\n} from 'alien-signals';\nimport { RAW_REACTIVE_VALUE } from '../reactive-read';\n\n// alien-signals v3 flushes effects synchronously. Outlet view-transition\n// swaps also run CRAFT_SYNC_TEMPLATE_FLUSH inside startViewTransition.\nexport const CRAFT_SIGNAL = Symbol('craft-signal');\n\nexport type CraftSignal<T> = (() => T) & {\n  readonly [CRAFT_SIGNAL]: true;\n};\n\nexport type CraftWritableSignal<T> = CraftSignal<T> & {\n  set(value: T): void;\n  update(fn: (value: T) => T): void;\n  asReadonly(): CraftSignal<T>;\n};\n\ntype CraftSignalOptions<T> = {\n  readonly equal?: (a: T, b: T) => boolean;\n  readonly debugName?: string;\n};\n\ntype CraftWatchOptions = {\n  readonly debugName?: string;\n  readonly injector?: unknown;\n  readonly manualCleanup?: boolean;\n};\n\nexport function ɵbrandAsCraftSignal<T>(value: () => T): CraftSignal<T> {\n  return brand(value) as CraftSignal<T>;\n}\n\nfunction brand<T, SignalType extends () => T>(value: SignalType): SignalType {\n  Object.defineProperties(value, {\n    [CRAFT_SIGNAL]: {\n      value: true,\n      enumerable: false,\n    },\n    [RAW_REACTIVE_VALUE]: {\n      value,\n      enumerable: false,\n    },\n  });\n  return value;\n}\n\nfunction withAsReadonly<T>(\n  value: CraftWritableSignal<T> | CraftSignal<T>,\n): typeof value {\n  const writable = value as CraftWritableSignal<T>;\n  if (typeof writable.asReadonly !== 'function') {\n    writable.asReadonly = () => value;\n  }\n  return value;\n}\n\nexport function craftSignal<T>(\n  initial: T,\n  options?: CraftSignalOptions<T>,\n): CraftWritableSignal<T> {\n  // The value travels in a fresh box on every accepted write. alien-signals\n  // compares the stored value by identity and drops a write that does not\n  // change it — which would silently override `equal`, the very option callers\n  // use to publish an in-place mutation (`map.set(k, v); return map`). Boxing\n  // makes `equal` the only thing that decides whether a write propagates.\n  const raw = signal<{ value: T }>({ value: initial });\n  const equal = options?.equal ?? Object.is;\n  const read = () => raw().value;\n  const value = (() => read()) as CraftWritableSignal<T>;\n  value.set = (next) => {\n    if (\n      !equal(\n        untracked(read),\n        next,\n      )\n    ) {\n      raw({ value: next });\n    }\n  };\n  value.update = (update) => value.set(update(untracked(read)));\n  const branded = brand(value);\n  branded.asReadonly = () => craftComputed(() => branded());\n  return branded;\n}\n\n/**\n * A computation's outcome, value or throw. Craft signals suspension\n * (`CraftNotSettled`) and business exceptions (`CraftGenShortCircuit`) by\n * throwing out of a computation, and alien-signals leaves a getter that threw\n * marked CLEAN with its value never assigned — every later read would then hand\n * back a stale value (or `undefined`) instead of raising again. Settling the\n * throw into a value keeps the node honest: it is cached, re-raised on read,\n * and invalidated by the same dependencies as a normal result.\n */\ntype CraftSettlement<T> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: unknown };\n\nexport function craftComputed<T>(compute: () => T): CraftSignal<T>;\nexport function craftComputed<T>(\n  compute: () => T,\n  options: CraftSignalOptions<T>,\n): CraftSignal<T>;\nexport function craftComputed<T>(\n  compute: () => T,\n  options?: CraftSignalOptions<T>,\n): CraftSignal<T> {\n  const equal = options?.equal ?? Object.is;\n  let hasPrevious = false;\n  const derived = computed<CraftSettlement<T>>((previous) => {\n    let next: CraftSettlement<T>;\n    try {\n      next = { ok: true, value: compute() };\n    } catch (error) {\n      next = { ok: false, error };\n    }\n    // Identity is preserved only between two equal VALUES: a throw is never\n    // equal to anything, so a recovering computation always notifies.\n    const result =\n      hasPrevious && previous?.ok && next.ok && equal(previous.value, next.value)\n        ? previous\n        : next;\n    hasPrevious = true;\n    return result;\n  });\n  const value = (() => {\n    const settlement = derived();\n    // A computed read from inside its own first evaluation has nothing settled\n    // yet, and alien-signals hands back the node's still-unassigned value. That\n    // is a cycle in the graph, and it stays the caller's to resolve — but it\n    // reads as `undefined`, exactly as it did before outcomes were boxed, and\n    // not as a TypeError raised in here about a wrapper the caller never saw.\n    if (settlement === undefined) return undefined as T;\n    if (!settlement.ok) throw settlement.error;\n    return settlement.value;\n  }) as CraftSignal<T>;\n  return withAsReadonly(brand(value)) as CraftSignal<T>;\n}\n\nexport function craftLinkedSignal<T>(options: {\n  source: () => unknown;\n  computation: () => T;\n  equal?: (a: T, b: T) => boolean;\n  debugName?: string;\n}): CraftWritableSignal<T> {\n  const revision = signal(0);\n  const equal = options.equal ?? Object.is;\n  let hasSource = false;\n  let previousSource: unknown;\n  let hasComputedValue = false;\n  let localOverride = false;\n  let localValue!: T;\n\n  const derived = computed<T>((previous) => {\n    revision();\n    const source = options.source();\n    if (!hasSource || !Object.is(previousSource, source)) {\n      hasSource = true;\n      previousSource = source;\n      localOverride = false;\n    }\n    if (localOverride) {\n      return localValue;\n    }\n    const next = options.computation();\n    const result =\n      hasComputedValue && equal(previous as T, next) ? (previous as T) : next;\n    hasComputedValue = true;\n    return result;\n  });\n  const value = (() => derived()) as CraftWritableSignal<T>;\n  value.set = (next) => {\n    if (!hasSource) {\n      previousSource = untracked(options.source);\n      hasSource = true;\n    }\n    localValue = next;\n    localOverride = true;\n    revision(untracked(() => revision()) + 1);\n  };\n  value.update = (update) => value.set(update(untracked(() => derived())));\n  const branded = brand(value);\n  branded.asReadonly = () => craftComputed(() => branded());\n  return branded;\n}\n\nexport function craftWatch(\n  fn: () => void | (() => void),\n  _options?: CraftWatchOptions,\n): { destroy(): void } {\n  // alien-signals has no injector ownership. The overload preserves the Task 2\n  // call shape; boundary helpers remain responsible for injector teardown.\n  // Detach watches from the currently active Alien subscriber so an\n  // independently-owned watch is not disposed with a transient parent effect.\n  const destroy = untracked(() => effect(fn));\n  return { destroy };\n}\n\n/**\n * Publishes every write made inside `fn` as ONE update: readers and effects run\n * after the last write, never between two of them.\n *\n * Craft effects run synchronously, so two writes that only make sense together\n * — a nonce and the params it tags, a value and the status that describes it —\n * have to say so, or a reader woken by the first one observes the half-written\n * state and acts on it.\n */\nexport function craftBatch<T>(fn: () => T): T {\n  startBatch();\n  try {\n    return fn();\n  } finally {\n    endBatch();\n  }\n}\n\nexport function untracked<T>(fn: () => T): T {\n  const previous = setActiveSub();\n  try {\n    return fn();\n  } finally {\n    setActiveSub(previous);\n  }\n}\n\nexport function isCraftSignal(value: unknown): value is CraftSignal<unknown> {\n  return (\n    typeof value === 'function' &&\n    (value as Partial<CraftSignal<unknown>>)[CRAFT_SIGNAL] === true\n  );\n}\n"]}

package/src/lib/host/craft-test-bed.d.ts

@@ -0,0 +1,63 @@
+import { type CraftInjector } from './craft-injector';
+import { type ProviderToken } from './craft-compat';
+export type CraftComponentFixture<T = unknown> = {
+    readonly nativeElement: HTMLElement;
+    readonly componentInstance: T;
+    detectChanges(): void;
+    destroy(): void;
+};
+type CraftTestMounter = (component: unknown, host: Element, injector: CraftInjector) => {
+    instance: unknown;
+    destroy(): void;
+};
+/**
+ * `@craft-ts/component` installs the renderer here on import — core has no way
+ * to mount anything on its own.
+ */
+export declare function ɵsetCraftTestMounter(next: CraftTestMounter): void;
+/**
+ * The Craft stand-in for Angular's `TestBed`.
+ *
+ * Specs only ever used six of its methods, and every one of them is really a
+ * question about a root injector: configure providers, resolve a token, run a
+ * callback in context. This keeps that call shape so the suites read the same,
+ * while the thing underneath is a plain `CraftInjector` — no platform, no
+ * testing module, no compiler.
+ */
+declare class CraftTestBed {
+    private providers;
+    private injector;
+    /**
+     * Angular needed a platform booted once per process. Craft does not, so this
+     * exists purely so the `beforeAll` blocks in the ported specs keep compiling.
+     */
+    initTestEnvironment(..._args: unknown[]): void;
+    configureTestingModule(config: {
+        providers?: readonly unknown[];
+    }): this;
+    /** Craft has no template compiler, so there is nothing to compile. */
+    compileComponents(): Promise<void>;
+    /** The lazily built root injector, including Craft's `providedIn: 'root'` defaults. */
+    get rootInjector(): CraftInjector;
+    inject<T>(token: ProviderToken<T>): T;
+    inject<T>(token: ProviderToken<T>, notFoundValue: T | null): T | null;
+    runInInjectionContext<T>(fn: () => T): T;
+    /**
+     * alien-signals notifies effects synchronously, so by the time a write
+     * returns its effects have already run and there is nothing left to drain.
+     */
+    flushEffects(): void;
+    /** Angular's change-detection pump. Same story as {@link flushEffects}. */
+    tick(): void;
+    /**
+     * Mounts a Craft component and returns an Angular-shaped fixture, so the
+     * specs written against `TestBed.createComponent(...)` keep their shape.
+     * `detectChanges` has nothing to do — the mount already rendered.
+     */
+    createComponent<T = unknown>(component: unknown): CraftComponentFixture<T>;
+    resetTestingModule(): this;
+    private disposeInjector;
+}
+export declare const TestBed: CraftTestBed;
+export {};
+//# sourceMappingURL=craft-test-bed.d.ts.map

package/src/lib/host/craft-test-bed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-test-bed.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/host/craft-test-bed.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC/C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9B,aAAa,IAAI,IAAI,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG,CACtB,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,aAAa,KACpB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAEjE;AAeD;;;;;;;;GAQG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAqD;IAErE;;;OAGG;IACH,mBAAmB,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9C,sBAAsB,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI;IAUxE,sEAAsE;IAChE,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,uFAAuF;IACvF,IAAI,YAAY,IAAI,aAAa,CAShC;IAED,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC;IACrC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI;IASrE,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIxC;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB,2EAA2E;IAC3E,IAAI,IAAI,IAAI;IAIZ;;;;OAIG;IACH,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAqB1E,kBAAkB,IAAI,IAAI;IAM1B,OAAO,CAAC,eAAe;CAUxB;AAED,eAAO,MAAM,OAAO,cAAqB,CAAC"}

package/src/lib/host/craft-test-bed.js

@@ -0,0 +1,114 @@
+import { createCraftInjector, } from './craft-injector';
+import { createEnvironmentInjector, getCraftRootDefaultProviders, ɵdestroyCraftDestroyRef, } from './craft-compat';
+let mounter;
+/**
+ * `@craft-ts/component` installs the renderer here on import — core has no way
+ * to mount anything on its own.
+ */
+export function ɵsetCraftTestMounter(next) {
+    mounter = next;
+}
+function ɵmountCraftTestComponent(component, host, injector) {
+    if (!mounter) {
+        throw new Error('TestBed.createComponent needs @craft-ts/component; import it in the spec.');
+    }
+    return mounter(component, host, injector);
+}
+/**
+ * The Craft stand-in for Angular's `TestBed`.
+ *
+ * Specs only ever used six of its methods, and every one of them is really a
+ * question about a root injector: configure providers, resolve a token, run a
+ * callback in context. This keeps that call shape so the suites read the same,
+ * while the thing underneath is a plain `CraftInjector` — no platform, no
+ * testing module, no compiler.
+ */
+class CraftTestBed {
+    providers = [];
+    injector;
+    /**
+     * Angular needed a platform booted once per process. Craft does not, so this
+     * exists purely so the `beforeAll` blocks in the ported specs keep compiling.
+     */
+    initTestEnvironment(..._args) {
+        // no platform to boot
+    }
+    configureTestingModule(config) {
+        if (config.providers) {
+            this.providers.push(...config.providers);
+        }
+        // Providers added after the injector was materialised must reach it, so
+        // drop it and rebuild lazily on the next access.
+        this.disposeInjector();
+        return this;
+    }
+    /** Craft has no template compiler, so there is nothing to compile. */
+    async compileComponents() {
+        // nothing to compile
+    }
+    /** The lazily built root injector, including Craft's `providedIn: 'root'` defaults. */
+    get rootInjector() {
+        if (!this.injector) {
+            this.injector = createEnvironmentInjector([...getCraftRootDefaultProviders(), ...this.providers], createCraftInjector([]), 'CraftTestBed');
+        }
+        return this.injector;
+    }
+    inject(token, notFoundValue) {
+        return arguments.length > 1
+            ? (this.rootInjector.get(token, notFoundValue) ?? null)
+            : this.rootInjector.get(token);
+    }
+    runInInjectionContext(fn) {
+        return this.rootInjector.run(fn);
+    }
+    /**
+     * alien-signals notifies effects synchronously, so by the time a write
+     * returns its effects have already run and there is nothing left to drain.
+     */
+    flushEffects() {
+        // effects are synchronous
+    }
+    /** Angular's change-detection pump. Same story as {@link flushEffects}. */
+    tick() {
+        // effects are synchronous
+    }
+    /**
+     * Mounts a Craft component and returns an Angular-shaped fixture, so the
+     * specs written against `TestBed.createComponent(...)` keep their shape.
+     * `detectChanges` has nothing to do — the mount already rendered.
+     */
+    createComponent(component) {
+        const host = document.createElement('div');
+        document.body.append(host);
+        const mounted = ɵmountCraftTestComponent(component, host, this.rootInjector);
+        return {
+            nativeElement: host,
+            componentInstance: mounted.instance,
+            detectChanges() {
+                // rendering is synchronous
+            },
+            destroy() {
+                mounted.destroy();
+                host.remove();
+            },
+        };
+    }
+    resetTestingModule() {
+        this.disposeInjector();
+        this.providers = [];
+        return this;
+    }
+    disposeInjector() {
+        const current = this.injector;
+        this.injector = undefined;
+        if (!current)
+            return;
+        const destroyRef = current.ɵdestroyRef;
+        if (destroyRef) {
+            ɵdestroyCraftDestroyRef(destroyRef);
+        }
+        current.destroy?.();
+    }
+}
+export const TestBed = new CraftTestBed();
+//# sourceMappingURL=craft-test-bed.js.map

package/src/lib/host/craft-test-bed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-test-bed.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/host/craft-test-bed.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAexB,IAAI,OAAqC,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,SAAS,wBAAwB,CAC/B,SAAkB,EAClB,IAAa,EACb,QAAuB;IAEvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,YAAY;IACR,SAAS,GAAc,EAAE,CAAC;IAC1B,QAAQ,CAAqD;IAErE;;;OAGG;IACH,mBAAmB,CAAC,GAAG,KAAgB;QACrC,sBAAsB;IACxB,CAAC;IAED,sBAAsB,CAAC,MAA0C;QAC/D,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QACD,wEAAwE;QACxE,iDAAiD;QACjD,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,iBAAiB;QACrB,qBAAqB;IACvB,CAAC;IAED,uFAAuF;IACvF,IAAI,YAAY;QACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,yBAAyB,CACvC,CAAC,GAAG,4BAA4B,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EACtD,mBAAmB,CAAC,EAAE,CAAC,EACvB,cAAc,CACf,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAID,MAAM,CAAI,KAAuB,EAAE,aAAwB;QACzD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAe,EAAE,aAAa,CAAC,IAAI,IAAI,CAEtD;YACX,CAAC,CAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAe,CAAO,CAAC;IACpD,CAAC;IAED,qBAAqB,CAAI,EAAW;QAClC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,0BAA0B;IAC5B,CAAC;IAED,2EAA2E;IAC3E,IAAI;QACF,0BAA0B;IAC5B,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAc,SAAkB;QAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,wBAAwB,CACtC,SAAS,EACT,IAAI,EACJ,IAAI,CAAC,YAAY,CAClB,CAAC;QACF,OAAO;YACL,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,OAAO,CAAC,QAAa;YACxC,aAAa;gBACX,2BAA2B;YAC7B,CAAC;YACD,OAAO;gBACL,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,UAAU,GAAI,OAAwC,CAAC,WAAW,CAAC;QACzE,IAAI,UAAU,EAAE,CAAC;YACf,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IACtB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC","sourcesContent":["import {\n  createCraftInjector,\n  type CraftInjector,\n} from './craft-injector';\nimport {\n  createEnvironmentInjector,\n  getCraftRootDefaultProviders,\n  ɵdestroyCraftDestroyRef,\n  DestroyRef,\n  type Provider,\n  type ProviderToken,\n} from './craft-compat';\n\nexport type CraftComponentFixture<T = unknown> = {\n  readonly nativeElement: HTMLElement;\n  readonly componentInstance: T;\n  detectChanges(): void;\n  destroy(): void;\n};\n\ntype CraftTestMounter = (\n  component: unknown,\n  host: Element,\n  injector: CraftInjector,\n) => { instance: unknown; destroy(): void };\n\nlet mounter: CraftTestMounter | undefined;\n\n/**\n * `@craft-ts/component` installs the renderer here on import — core has no way\n * to mount anything on its own.\n */\nexport function ɵsetCraftTestMounter(next: CraftTestMounter): void {\n  mounter = next;\n}\n\nfunction ɵmountCraftTestComponent(\n  component: unknown,\n  host: Element,\n  injector: CraftInjector,\n): { instance: unknown; destroy(): void } {\n  if (!mounter) {\n    throw new Error(\n      'TestBed.createComponent needs @craft-ts/component; import it in the spec.',\n    );\n  }\n  return mounter(component, host, injector);\n}\n\n/**\n * The Craft stand-in for Angular's `TestBed`.\n *\n * Specs only ever used six of its methods, and every one of them is really a\n * question about a root injector: configure providers, resolve a token, run a\n * callback in context. This keeps that call shape so the suites read the same,\n * while the thing underneath is a plain `CraftInjector` — no platform, no\n * testing module, no compiler.\n */\nclass CraftTestBed {\n  private providers: unknown[] = [];\n  private injector: (CraftInjector & { destroy?(): void }) | undefined;\n\n  /**\n   * Angular needed a platform booted once per process. Craft does not, so this\n   * exists purely so the `beforeAll` blocks in the ported specs keep compiling.\n   */\n  initTestEnvironment(..._args: unknown[]): void {\n    // no platform to boot\n  }\n\n  configureTestingModule(config: { providers?: readonly unknown[] }): this {\n    if (config.providers) {\n      this.providers.push(...config.providers);\n    }\n    // Providers added after the injector was materialised must reach it, so\n    // drop it and rebuild lazily on the next access.\n    this.disposeInjector();\n    return this;\n  }\n\n  /** Craft has no template compiler, so there is nothing to compile. */\n  async compileComponents(): Promise<void> {\n    // nothing to compile\n  }\n\n  /** The lazily built root injector, including Craft's `providedIn: 'root'` defaults. */\n  get rootInjector(): CraftInjector {\n    if (!this.injector) {\n      this.injector = createEnvironmentInjector(\n        [...getCraftRootDefaultProviders(), ...this.providers],\n        createCraftInjector([]),\n        'CraftTestBed',\n      );\n    }\n    return this.injector;\n  }\n\n  inject<T>(token: ProviderToken<T>): T;\n  inject<T>(token: ProviderToken<T>, notFoundValue: T | null): T | null;\n  inject<T>(token: ProviderToken<T>, notFoundValue?: T | null): T | null {\n    return arguments.length > 1\n      ? ((this.rootInjector.get(token as object, notFoundValue) ?? null) as\n          | T\n          | null)\n      : (this.rootInjector.get(token as object) as T);\n  }\n\n  runInInjectionContext<T>(fn: () => T): T {\n    return this.rootInjector.run(fn);\n  }\n\n  /**\n   * alien-signals notifies effects synchronously, so by the time a write\n   * returns its effects have already run and there is nothing left to drain.\n   */\n  flushEffects(): void {\n    // effects are synchronous\n  }\n\n  /** Angular's change-detection pump. Same story as {@link flushEffects}. */\n  tick(): void {\n    // effects are synchronous\n  }\n\n  /**\n   * Mounts a Craft component and returns an Angular-shaped fixture, so the\n   * specs written against `TestBed.createComponent(...)` keep their shape.\n   * `detectChanges` has nothing to do — the mount already rendered.\n   */\n  createComponent<T = unknown>(component: unknown): CraftComponentFixture<T> {\n    const host = document.createElement('div');\n    document.body.append(host);\n    const mounted = ɵmountCraftTestComponent(\n      component,\n      host,\n      this.rootInjector,\n    );\n    return {\n      nativeElement: host,\n      componentInstance: mounted.instance as T,\n      detectChanges() {\n        // rendering is synchronous\n      },\n      destroy() {\n        mounted.destroy();\n        host.remove();\n      },\n    };\n  }\n\n  resetTestingModule(): this {\n    this.disposeInjector();\n    this.providers = [];\n    return this;\n  }\n\n  private disposeInjector(): void {\n    const current = this.injector;\n    this.injector = undefined;\n    if (!current) return;\n    const destroyRef = (current as { ɵdestroyRef?: DestroyRef }).ɵdestroyRef;\n    if (destroyRef) {\n      ɵdestroyCraftDestroyRef(destroyRef);\n    }\n    current.destroy?.();\n  }\n}\n\nexport const TestBed = new CraftTestBed();\n"]}

package/src/lib/host-tag.d.ts

@@ -0,0 +1,2 @@
+export { type CraftTrackTags, ɵHOST_NAME_META_DATA as HOST_NAME_META_DATA, ɵHOST_TAG_LIST as HOST_TAG_LIST, ɵTRACK_TAGS_LIST as TRACK_TAGS_LIST, ɵHostNameToProvide as HostNameToProvide, ɵHostName as HostName, ɵHostTag as HostTag, ɵTrackTags as TrackTags, type TrackTag, ɵinjectHostName as injectHostName, ɵinjectTrackTags as injectTrackTags, ɵprovideHostName as provideHostName, ɵprovideTrackTags as provideTrackTags, } from './craft-service';
+//# sourceMappingURL=host-tag.d.ts.map

package/src/lib/host-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-tag.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/host-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,IAAI,mBAAmB,EAC3C,cAAc,IAAI,aAAa,EAC/B,gBAAgB,IAAI,eAAe,EACnC,kBAAkB,IAAI,iBAAiB,EACvC,SAAS,IAAI,QAAQ,EACrB,QAAQ,IAAI,OAAO,EACnB,UAAU,IAAI,SAAS,EACvB,KAAK,QAAQ,EACb,eAAe,IAAI,cAAc,EACjC,gBAAgB,IAAI,eAAe,EACnC,gBAAgB,IAAI,eAAe,EACnC,iBAAiB,IAAI,gBAAgB,GACtC,MAAM,iBAAiB,CAAC"}

package/src/lib/host-tag.js

@@ -0,0 +1,2 @@
+export { ɵHOST_NAME_META_DATA as HOST_NAME_META_DATA, ɵHOST_TAG_LIST as HOST_TAG_LIST, ɵTRACK_TAGS_LIST as TRACK_TAGS_LIST, ɵHostNameToProvide as HostNameToProvide, ɵHostName as HostName, ɵHostTag as HostTag, ɵTrackTags as TrackTags, ɵinjectHostName as injectHostName, ɵinjectTrackTags as injectTrackTags, ɵprovideHostName as provideHostName, ɵprovideTrackTags as provideTrackTags, } from './craft-service';
+//# sourceMappingURL=host-tag.js.map

package/src/lib/host-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-tag.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/host-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,IAAI,mBAAmB,EAC3C,cAAc,IAAI,aAAa,EAC/B,gBAAgB,IAAI,eAAe,EACnC,kBAAkB,IAAI,iBAAiB,EACvC,SAAS,IAAI,QAAQ,EACrB,QAAQ,IAAI,OAAO,EACnB,UAAU,IAAI,SAAS,EAEvB,eAAe,IAAI,cAAc,EACjC,gBAAgB,IAAI,eAAe,EACnC,gBAAgB,IAAI,eAAe,EACnC,iBAAiB,IAAI,gBAAgB,GACtC,MAAM,iBAAiB,CAAC","sourcesContent":["export {\n  type CraftTrackTags,\n  ɵHOST_NAME_META_DATA as HOST_NAME_META_DATA,\n  ɵHOST_TAG_LIST as HOST_TAG_LIST,\n  ɵTRACK_TAGS_LIST as TRACK_TAGS_LIST,\n  ɵHostNameToProvide as HostNameToProvide,\n  ɵHostName as HostName,\n  ɵHostTag as HostTag,\n  ɵTrackTags as TrackTags,\n  type TrackTag,\n  ɵinjectHostName as injectHostName,\n  ɵinjectTrackTags as injectTrackTags,\n  ɵprovideHostName as provideHostName,\n  ɵprovideTrackTags as provideTrackTags,\n} from './craft-service';\n"]}

package/src/lib/insert-entities.d.ts

@@ -0,0 +1,131 @@
+import { InsertionStateFactoryContext } from './query.core';
+import { EntitiesUtilBrand, IdSelector } from './util/entities-util';
+import { AccessTypeObjectPropertyByDottedPath, DottedPathPathToTuple } from './util/types/access-type-object-property-by-dotted-path.type';
+import { ObjectDeepPath } from './util/types/object-deep-path-mapper.type';
+import { MergeObject, Prettify } from './util/util.type';
+type ArrayObjectDeepPath<State extends object> = ObjectDeepPath<State> extends infer Path ? Path extends string ? AccessTypeObjectPropertyByDottedPath<State, DottedPathPathToTuple<Path>> extends Array<any> ? Path : never : never : never;
+type DottedPathToCamel<Path extends string> = Path extends `${infer Head}.${infer Tail}` ? `${Head}${Capitalize<DottedPathToCamel<Tail>>}` : Path;
+type EntitiesUtilsToMap<EntityHelperFns, Entity, K, HasStateIdentifier, StateIdentifier, HasPath, Path, Acc = {}> = EntityHelperFns extends [infer First, ...infer Rest] ? First extends (data: infer Payload) => infer R ? R extends EntitiesUtilBrand<infer Name> ? EntitiesUtilsToMap<Rest, Entity, K, HasStateIdentifier, StateIdentifier, HasPath, Path, Acc & {
+    [key in Name as `${HasPath extends true ? `${DottedPathToCamel<Path & string>}${Capitalize<string & key>}` : key & string}`]: (payload: MergeObject<{
+        [key in Exclude<keyof Payload, 'identifier'> as `${key extends 'entities' ? never : key & string}`]: key extends 'entity' ? Entity : key extends 'ids' ? K[] : key extends 'newEntities' ? Entity[] : `Not implemented mapping for ${key & string}`;
+    }, HasStateIdentifier extends true ? {
+        select: StateIdentifier extends (...args: any) => infer R ? R : never;
+    } : {}>) => void;
+}> : 'No EntitiesBranded Name Detected' : false : Acc;
+/**
+ * Creates an insertion that adds entity collection management methods to state, query, or queryParams primitives.
+ *
+ * Provides type-safe manipulation of arrays of entities with operations like add, remove, update, and upsert.
+ * Supports nested properties via dot notation paths and custom entity identifiers.
+ *
+ * @template State - The state type (array or object containing arrays)
+ * @template K - The type of entity identifiers (string or number)
+ * @template PreviousInsertionsOutputs - Combined outputs from previous insertions
+ * @template EntityHelperFns - Tuple type of entity utility functions to expose
+ * @template StateIdentifier - Type of identifier function for parallel queries
+ * @template Path - Dot-notation path to nested array (inferred from state structure)
+ *
+ * @param config - Configuration object
+ * @param config.methods - Array of entity utility functions (addOne, removeOne, updateOne, etc.) to expose as methods
+ * @param config.identifier - Optional custom function to extract unique ID from entities.
+ *                            Defaults to `entity.id` for objects or `entity` for primitives
+ * @param config.path - Optional dot-notation path to nested array property (e.g., 'catalog.products').
+ *                      Method names are prefixed with camelCase path when provided
+ *
+ * @returns Insertion function that adds entity management methods to the primitive
+ *
+ * @example
+ * // Basic usage with primitives
+ * const tags = yield* state(
+ *   [] as string[],
+ *   insertEntities({
+ *     methods: [addOne, addMany, removeOne],
+ *   })
+ * ));
+ * yield* tags.addOne({ entity: 'typescript' });
+ * yield* tags.addMany({ newEntities: ['angular', 'signals'] });
+ *
+ * @example
+ * // With objects having default id property
+ * interface Product {
+ *   id: string;
+ *   name: string;
+ *   price: number;
+ * }
+ * const products = yield* state(
+ *   [] as Product[],
+ *   insertEntities({
+ *     methods: [addOne, setOne, removeOne],
+ *   })
+ * ));
+ * yield* products.addOne({ entity: { id: '1', name: 'Laptop', price: 999 } });
+ *
+ * @example
+ * // With custom identifier
+ * interface User {
+ *   uuid: string;
+ *   name: string;
+ * }
+ * const users = yield* state(
+ *   [] as User[],
+ *   insertEntities({
+ *     methods: [setOne, removeOne],
+ *     identifier: (user) => user.uuid,
+ *   })
+ * ));
+ *
+ * @example
+ * // With nested path
+ * interface Catalog {
+ *   total: number;
+ *   products: Array<{ id: string; name: string }>;
+ * }
+ * const catalog = yield* state(
+ *   { total: 0, products: [] } as Catalog,
+ *   insertEntities({
+ *     methods: [addMany, removeOne],
+ *     path: 'products',
+ *   })
+ * ));
+ * yield* catalog.productsAddMany({ newEntities: [{ id: '1', name: 'Item' }] });
+ *
+ * @example
+ * // With parallel queries
+ * const userQuery = yield* query(
+ *   {
+ *     params: () => 'userId',
+ *     identifier: (params) => params,
+ *     loader: async ({ params }) => fetchUserPosts(params),
+ *   },
+ *   insertEntities({
+ *     methods: [addOne],
+ *   })
+ * ));
+ * yield* userQuery.addOne({
+ *   select: 'user-123', // Target specific query instance
+ *   entity: { id: 'post-1', title: 'New Post' },
+ * });
+ *
+ * @see {@link https://github.com/craft-ts/craft-ts/blob/main/apps/docs/insertions/insert-entities.md | insertEntities Documentation}
+ */
+export declare function insertEntities<State, K extends string | number, PreviousInsertionsOutputs, const EntityHelperFns extends unknown[], StateIdentifier, const Path = State extends Array<infer Entity> ? never : State extends object ? ArrayObjectDeepPath<State> : never, StateType = State extends Array<infer R> ? R : State extends object ? Path extends string ? AccessTypeObjectPropertyByDottedPath<State, DottedPathPathToTuple<Path>> extends Array<infer Entity> ? Entity : never : never : never, HasStateIdentifier = [unknown] extends [StateIdentifier] ? false : StateIdentifier extends (...args: any) => infer R ? [unknown] extends [R] ? false : true : false, IsEntityIdentifierOptional = StateType extends {
+    id: NoInfer<K>;
+} ? true : StateType extends string | number ? true : false>(config: {
+    methods: EntityHelperFns;
+} & MergeObject<IsEntityIdentifierOptional extends true ? {
+    identifier?: IdSelector<NoInfer<StateType>, NoInfer<K>>;
+} : {
+    identifier: IdSelector<NoInfer<StateType>, NoInfer<K>>;
+}, [
+    Path
+] extends [never] ? {} : {
+    path: Path;
+}>): (context: InsertionStateFactoryContext<State, PreviousInsertionsOutputs> & {
+    identifier?: StateIdentifier;
+}) => Prettify<EntitiesUtilsToMap<EntityHelperFns, StateType, K, HasStateIdentifier, StateIdentifier, "path" extends keyof typeof config ? true : false, Path>> & {
+    testState: State;
+    testPath: Path;
+    testHasPath: "path" extends keyof typeof config ? true : false;
+};
+export {};
+//# sourceMappingURL=insert-entities.d.ts.map