@craft-ts/core 0.7.0-beta.13

package/src/lib/reactive-read.js

@@ -0,0 +1,389 @@
+import { isCraftSignal } from './host/craft-signal';
+import { craftToken } from './host/craft-injector';
+function isCallableSignal(value) {
+    if (typeof value !== 'function') {
+        return false;
+    }
+    const symbols = Object.getOwnPropertySymbols(value);
+    return (symbols.some((symbol) => symbol.description === 'SIGNAL') ||
+        'set' in value ||
+        'update' in value);
+}
+/** Runtime/type brand carried by named reactive values exposed to templates. */
+export const YIELDABLE_VALUE = Symbol('craft-yieldable-value');
+/** Internal marker used by the synchronous Craft generator driver. */
+export const REACTIVE_READ_REQUEST = Symbol('craft-reactive-read-request');
+/** Internal escape hatch used by Craft itself to retain the raw host signal. */
+export const RAW_REACTIVE_VALUE = Symbol('craft-raw-reactive-value');
+const RAW_REACTIVE_ACTION = Symbol('craft-raw-reactive-action');
+/** Type/runtime marker retaining the reader's resolved value type. */
+export const REACTIVE_VALUE_TYPE = Symbol('craft-reactive-value-type');
+/** Type-only carrier identifying the root reader and projected path. */
+export const YIELDABLE_DEPENDENCY = Symbol('craft-yieldable-dependency');
+/** Runtime/type marker for an explicitly adapted deep-yieldable reader. */
+export const DEEP_YIELDABLE = Symbol('craft-deep-yieldable');
+/** Type-only carrier propagated by computed readers. */
+export const REACTIVE_DEPENDENCIES = Symbol('craft-reactive-dependencies');
+/** Marker carried by the opt-in primitive insertion. */
+export const DEEP_YIELDABLE_INSERTION = Symbol('craft-deep-yieldable-insertion');
+export function insertDeepYieldable() {
+    const insertion = (() => ({}));
+    Object.defineProperty(insertion, DEEP_YIELDABLE_INSERTION, {
+        value: true,
+        enumerable: false,
+    });
+    return insertion;
+}
+export function hasDeepYieldableInsertion(insertions) {
+    return insertions.some((insertion) => typeof insertion === 'function' && DEEP_YIELDABLE_INSERTION in insertion);
+}
+let activeReactiveReader;
+export function ɵactiveReactiveReader() {
+    return activeReactiveReader;
+}
+export function ɵwithActiveReactiveReader(identity, read) {
+    const previous = activeReactiveReader;
+    activeReactiveReader = identity;
+    try {
+        return read();
+    }
+    finally {
+        activeReactiveReader = previous;
+    }
+}
+/** Observability hook notified whenever a Craft generator resolves a reactive read. */
+export const REACTIVE_READ_OBSERVERS = Object.assign(craftToken('REACTIVE_READ_OBSERVERS'), {
+    ɵfactory: () => [],
+});
+export function provideReactiveReadObserver(observer) {
+    return { provide: REACTIVE_READ_OBSERVERS, useValue: observer, multi: true };
+}
+export function isReactiveReadRequest(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        REACTIVE_READ_REQUEST in value);
+}
+export function isYieldableReactiveValue(value) {
+    return (typeof value === 'function' &&
+        RAW_REACTIVE_VALUE in value &&
+        YIELDABLE_VALUE in value);
+}
+export function rawReactiveValue(value) {
+    return value[RAW_REACTIVE_VALUE];
+}
+/** Reconstructs the internal signal-shaped view expected by legacy internals. */
+const rawFacadeCache = new WeakMap();
+export function rawReactiveFacade(value) {
+    if (isYieldableReactiveValue(value)) {
+        return rawReactiveValue(value);
+    }
+    if (typeof value === 'function' && RAW_REACTIVE_ACTION in value) {
+        return value[RAW_REACTIVE_ACTION];
+    }
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    const cached = rawFacadeCache.get(value);
+    if (cached)
+        return cached;
+    const facade = new Proxy(value, {
+        get(target, property, receiver) {
+            return rawReactiveFacade(Reflect.get(target, property, receiver));
+        },
+    });
+    rawFacadeCache.set(value, facade);
+    return facade;
+}
+/** Applies an insertion key to an anonymous craftComputed reader. */
+export function nameInsertedReactiveValue(value, name, primitive, path) {
+    if (!isYieldableReactiveValue(value))
+        return value;
+    if (value[YIELDABLE_VALUE] !== 'computed')
+        return value;
+    return createYieldableReactiveValue(value[RAW_REACTIVE_VALUE], name, {
+        primitive,
+        insertion: name,
+        computed: name,
+        path,
+    });
+}
+export function createYieldableReactiveValue(source, name, identity = {}) {
+    const reader = function* reactiveReader() {
+        const value = yield {
+            [REACTIVE_READ_REQUEST]: true,
+            identity: { name, ...identity },
+            read: source,
+        };
+        return value;
+    };
+    Object.defineProperties(reader, {
+        [YIELDABLE_VALUE]: {
+            value: name,
+            enumerable: false,
+            configurable: true,
+        },
+        [RAW_REACTIVE_VALUE]: {
+            value: source,
+            enumerable: false,
+            configurable: true,
+        },
+        [REACTIVE_VALUE_TYPE]: {
+            get: source,
+            enumerable: false,
+            configurable: true,
+        },
+    });
+    return reader;
+}
+const deepYieldableCache = new WeakMap();
+const deepYieldableRoots = new WeakSet();
+function rawSourceOf(value) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, RAW_REACTIVE_VALUE);
+    return descriptor?.value;
+}
+function readProjectedPath(source, path) {
+    let value = source();
+    for (const property of path) {
+        value = value == null ? undefined : Reflect.get(Object(value), property);
+    }
+    return value;
+}
+function createDeepProjection(root, path) {
+    const pathText = [
+        String(Reflect.get(root, YIELDABLE_VALUE) ?? 'reader'),
+        ...path.map(String),
+    ].join('.');
+    const rootSignal = rawSourceOf(root);
+    const reader = function* deepProjectedReader() {
+        if (rootSignal) {
+            const value = yield {
+                [REACTIVE_READ_REQUEST]: true,
+                identity: {
+                    name: String(path[path.length - 1] ?? pathText),
+                    path: pathText,
+                },
+                read: () => readProjectedPath(rootSignal, path),
+            };
+            return value;
+        }
+        const rootValue = typeof root === 'function'
+            ? yield* root()
+            : root;
+        return readProjectedPath(() => rootValue, path);
+    };
+    Object.defineProperty(reader, YIELDABLE_VALUE, {
+        value: pathText,
+        enumerable: false,
+    });
+    return new Proxy(reader, {
+        get(target, property, receiver) {
+            if (isFunctionNativeProperty(property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === '__craftDeepYieldable')
+                return true;
+            if (property !== 'name' && Reflect.has(target, property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            if (typeof property !== 'string' && typeof property !== 'number') {
+                return undefined;
+            }
+            return getDeepProjection(root, [...path, property]);
+        },
+        has(target, property) {
+            if (isFunctionNativeProperty(property))
+                return true;
+            return Reflect.has(target, property);
+        },
+    });
+}
+function getDeepProjection(root, path) {
+    const cacheKey = path.map(String).join('.');
+    const cached = deepYieldableCache.get(root);
+    if (cached && cached instanceof Map && cached.has(cacheKey)) {
+        return cached.get(cacheKey);
+    }
+    const projection = createDeepProjection(root, path);
+    const nextCache = cached instanceof Map ? cached : new Map();
+    nextCache.set(cacheKey, projection);
+    deepYieldableCache.set(root, nextCache);
+    return projection;
+}
+function isFunctionNativeProperty(property) {
+    return (property === 'prototype' ||
+        property === 'arguments' ||
+        property === 'caller');
+}
+/**
+ * Explicitly adapts a reader so data properties become stable lazy readers.
+ * Ordinary readers are deliberately left untouched until this function is
+ * called.
+ */
+export function deepYieldable(reader) {
+    if ((typeof reader !== 'function' &&
+        (typeof reader !== 'object' || reader === null)) ||
+        deepYieldableRoots.has(reader)) {
+        return reader;
+    }
+    const root = reader;
+    const facade = new Proxy(root, {
+        get(target, property, receiver) {
+            if (isFunctionNativeProperty(property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === '__craftDeepYieldable')
+                return true;
+            if (property !== 'name' &&
+                rawSourceOf(root) &&
+                Reflect.has(target, property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === YIELDABLE_VALUE)
+                return 'deep-yieldable';
+            if (property === DEEP_YIELDABLE)
+                return true;
+            if (typeof property !== 'string' && typeof property !== 'number') {
+                return undefined;
+            }
+            return getDeepProjection(root, [property]);
+        },
+        has(target, property) {
+            if (isFunctionNativeProperty(property))
+                return true;
+            return (property === '__craftDeepYieldable' ||
+                property === YIELDABLE_VALUE ||
+                property === DEEP_YIELDABLE ||
+                Reflect.has(target, property));
+        },
+    });
+    Object.defineProperty(facade, '__craftDeepYieldable', {
+        value: true,
+        enumerable: false,
+    });
+    deepYieldableRoots.add(facade);
+    return facade;
+}
+const facadeCache = new WeakMap();
+/**
+ * Creates a non-mutating public view of a primitive/ref. Signal calls become
+ * reactive read generators; non-reactive methods and values keep their runtime
+ * contract. Nested signal properties are adapted lazily and cached.
+ */
+export function createYieldableReactiveFacade(value, identity) {
+    return createFacade(value, identity, identity.path ?? identity.name);
+}
+/**
+ * Creates the deep reader used by resource collections such as
+ * `query.exceptions`. Unlike `deepYieldable`, this starts from the raw signal
+ * so the primitive can opt one reactive property into deep projection without
+ * making the whole primitive deeply yieldable.
+ */
+export function createDeepYieldableReactiveValue(source, name, identity = {}) {
+    return deepYieldable(createYieldableReactiveValue(source, name, identity));
+}
+function createFacade(value, identity, path, deep = false) {
+    if (typeof value !== 'object' && typeof value !== 'function')
+        return value;
+    if (value === null)
+        return value;
+    // Generator/iterator instances carry native methods whose receiver must be
+    // the original instance. Proxying one (for example, the invocation returned
+    // by an insertion method named `select`) makes `yield*` call `.next` with the
+    // proxy as receiver and throws "incompatible receiver".
+    if ('next' in value &&
+        typeof value.next === 'function') {
+        return value;
+    }
+    if (isDeepYieldable(value) || isYieldableReactiveValue(value))
+        return value;
+    const cacheKey = `${identity.primitive ?? ''}|${identity.computed ?? ''}|${path}`;
+    const cachedByPath = facadeCache.get(value);
+    if (cachedByPath?.has(cacheKey))
+        return cachedByPath.get(cacheKey);
+    let facade;
+    if (isCraftSignal(value) || isCallableSignal(value)) {
+        const pathParts = path.split('.');
+        const propertyName = pathParts[pathParts.length - 1] ?? identity.name;
+        const reader = createYieldableReactiveValue(value, propertyName, {
+            ...identity,
+            path,
+        });
+        facade = deep
+            ? deepYieldable(reader)
+            : new Proxy(reader, {
+                get(_target, property) {
+                    if (property === YIELDABLE_VALUE ||
+                        property === RAW_REACTIVE_VALUE) {
+                        return Reflect.get(reader, property);
+                    }
+                    if (!Reflect.has(value, property) && Reflect.has(reader, property)) {
+                        return createFacade(Reflect.get(reader, property), identity, `${path}.${String(property)}`);
+                    }
+                    const child = Reflect.get(value, property);
+                    if ((property === 'select' || property === 'selectOrCreate') &&
+                        typeof child === 'function') {
+                        return (...args) => createFacade(Reflect.apply(child, value, args), identity, `${path}.${String(property)}.${String(args[0] ?? 'selected')}`);
+                    }
+                    return createFacade(child, {
+                        ...identity,
+                        insertion: identity.insertion ??
+                            (typeof property === 'string' ? property : undefined),
+                    }, `${path}.${String(property)}`);
+                },
+                ownKeys: (target) => [
+                    ...new Set([...Reflect.ownKeys(target), ...Reflect.ownKeys(value)]),
+                ],
+                getOwnPropertyDescriptor(_target, property) {
+                    const targetDescriptor = Reflect.getOwnPropertyDescriptor(reader, property);
+                    if (targetDescriptor)
+                        return targetDescriptor;
+                    const descriptor = Reflect.getOwnPropertyDescriptor(value, property);
+                    return descriptor
+                        ? { ...descriptor, configurable: true }
+                        : undefined;
+                },
+                has: (_target, property) => property === YIELDABLE_VALUE ||
+                    property === RAW_REACTIVE_VALUE ||
+                    Reflect.has(value, property),
+            });
+    }
+    else {
+        facade = new Proxy(value, {
+            get(target, property, receiver) {
+                const child = Reflect.get(target, property, receiver);
+                if ((property === 'reload' || property === 'refresh') &&
+                    typeof child === 'function') {
+                    const action = function* yieldableReactiveAction(...args) {
+                        return Reflect.apply(child, target, args);
+                    };
+                    Object.defineProperty(action, RAW_REACTIVE_ACTION, { value: child });
+                    return action;
+                }
+                if ((property === 'select' || property === 'selectOrCreate') &&
+                    typeof child === 'function') {
+                    return (...args) => createFacade(Reflect.apply(child, target, args), identity, `${path}.${String(property)}.${String(args[0] ?? 'selected')}`);
+                }
+                if (!isCraftSignal(child) &&
+                    !isCallableSignal(child) &&
+                    (typeof child !== 'object' || child === null)) {
+                    return child;
+                }
+                return createFacade(child, {
+                    ...identity,
+                    insertion: identity.insertion ??
+                        (typeof property === 'string' ? property : undefined),
+                }, `${path}.${String(property)}`, property === 'exceptions');
+            },
+        });
+    }
+    const nextCache = cachedByPath ?? new Map();
+    nextCache.set(cacheKey, facade);
+    if (!cachedByPath)
+        facadeCache.set(value, nextCache);
+    return facade;
+}
+function isDeepYieldable(value) {
+    return ((typeof value === 'object' && value !== null) ||
+        typeof value === 'function') && '__craftDeepYieldable' in value;
+}
+//# sourceMappingURL=reactive-read.js.map

package/src/lib/reactive-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-read.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/reactive-read.ts"],"names":[],"mappings":"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","sourcesContent":["import { isCraftSignal, type CraftSignal as Signal } from './host/craft-signal';\nimport { craftToken } from './host/craft-injector';\nimport type { SourceBranded } from './util/util';\n\nfunction isCallableSignal(value: unknown): boolean {\n  if (typeof value !== 'function') {\n    return false;\n  }\n  const symbols = Object.getOwnPropertySymbols(value);\n  return (\n    symbols.some((symbol) => symbol.description === 'SIGNAL') ||\n    'set' in value ||\n    'update' in value\n  );\n}\n\n/** Runtime/type brand carried by named reactive values exposed to templates. */\nexport const YIELDABLE_VALUE = Symbol('craft-yieldable-value');\n\n/** Internal marker used by the synchronous Craft generator driver. */\nexport const REACTIVE_READ_REQUEST = Symbol('craft-reactive-read-request');\n\n/** Internal escape hatch used by Craft itself to retain the raw host signal. */\nexport const RAW_REACTIVE_VALUE = Symbol('craft-raw-reactive-value');\nconst RAW_REACTIVE_ACTION = Symbol('craft-raw-reactive-action');\n\n/** Type/runtime marker retaining the reader's resolved value type. */\nexport const REACTIVE_VALUE_TYPE = Symbol('craft-reactive-value-type');\n\n/** Type-only carrier identifying the root reader and projected path. */\nexport const YIELDABLE_DEPENDENCY = Symbol('craft-yieldable-dependency');\n\n/** Runtime/type marker for an explicitly adapted deep-yieldable reader. */\nexport const DEEP_YIELDABLE = Symbol('craft-deep-yieldable');\n\n/** Type-only carrier propagated by computed readers. */\nexport const REACTIVE_DEPENDENCIES = Symbol('craft-reactive-dependencies');\n\n/** Marker carried by the opt-in primitive insertion. */\nexport const DEEP_YIELDABLE_INSERTION = Symbol(\n  'craft-deep-yieldable-insertion',\n);\n\nexport type ReactiveDependencyMap = Readonly<{\n  readonly source: unknown;\n  readonly path: string;\n}>;\n\nexport type YieldableDependency<Source, Path extends string> = {\n  readonly [YIELDABLE_DEPENDENCY]?: {\n    readonly source: Source;\n    readonly path: Path;\n  };\n};\n\ntype DeepYieldableReadRequest<\n  Value,\n  Source,\n  Path extends string,\n> = ReactiveReadRequest<Value> & YieldableDependency<Source, Path>;\n\ntype DeepYieldableObject<\n  Value extends object,\n  Source,\n  Path extends string,\n  Depth extends readonly unknown[],\n> = Depth extends readonly []\n  ? {}\n  : Value extends readonly unknown[]\n    ? {}\n    : Value extends (...args: any[]) => any\n      ? {}\n      : {\n          readonly [Key in keyof Value as Key extends\n            | typeof YIELDABLE_VALUE\n            | typeof RAW_REACTIVE_VALUE\n            | typeof REACTIVE_VALUE_TYPE\n            | typeof YIELDABLE_DEPENDENCY\n            | typeof DEEP_YIELDABLE\n            ? never\n            : Key]: DeepYieldableValue<\n            Value[Key],\n            Source,\n            `${Path}.${Extract<Key, string>}`,\n            Depth extends readonly [unknown, ...infer Rest] ? Rest : readonly []\n          >;\n        };\n\n/** A lazily projected, yieldable view of one value property. */\nexport type DeepYieldableValue<\n  Value,\n  Source,\n  Path extends string,\n  Depth extends readonly unknown[] = readonly [\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n  ],\n> = (() => Generator<\n  DeepYieldableReadRequest<Value, Source, Path>,\n  Value,\n  unknown\n>) &\n  YieldableDependency<Source, Path> &\n  (Value extends object ? DeepYieldableObject<Value, Source, Path, Depth> : {});\n\ntype ReaderValue<Reader> =\n  Reader extends YieldableReactiveValue<infer Value, any, any>\n    ? Value\n    : Reader extends (...args: any[]) => Generator<any, infer Value, any>\n      ? Value\n      : never;\n\ntype ReaderName<Reader> =\n  Reader extends YieldableReactiveValue<any, infer Name extends string, any>\n    ? Name\n    : string;\n\n/** Type returned by {@link deepYieldable}. */\nexport type DeepYieldableReaderOf<Reader> = Reader &\n  DeepYieldableObject<\n    NonNullable<ReaderValue<Reader>> extends object\n      ? NonNullable<ReaderValue<Reader>>\n      : {},\n    Reader,\n    ReaderName<Reader>,\n    readonly [\n      unknown,\n      unknown,\n      unknown,\n      unknown,\n      unknown,\n      unknown,\n      unknown,\n      unknown,\n    ]\n  > &\n  DeepYieldableMarker & {\n    readonly [DEEP_YIELDABLE]: true;\n  };\n\n/**\n * A reactive reader whose object-valued result can be projected property by\n * property (`reader.profile.name`) while keeping every projection yieldable.\n */\nexport type DeepYieldableReactiveValue<\n  Value,\n  Name extends string = string,\n> = DeepYieldableReaderOf<YieldableReactiveValue<Value, Name>>;\n\n/** Structural companion to the runtime symbol, usable across project references. */\nexport type DeepYieldableMarker = {\n  readonly __craftDeepYieldable: true;\n};\n\nexport type ReactiveDependencyMapFromYielded<Yielded> = Yielded extends {\n  readonly [YIELDABLE_DEPENDENCY]?: infer Dependency;\n}\n  ? Dependency\n  : never;\n\nexport type DeepYieldableInsertion = {\n  readonly [DEEP_YIELDABLE_INSERTION]: true;\n} & ((context: unknown) => {\n  readonly [DEEP_YIELDABLE_INSERTION]: true;\n});\n\nexport function insertDeepYieldable(): DeepYieldableInsertion {\n  const insertion = (() => ({})) as unknown as DeepYieldableInsertion;\n  Object.defineProperty(insertion, DEEP_YIELDABLE_INSERTION, {\n    value: true,\n    enumerable: false,\n  });\n  return insertion;\n}\n\nexport function hasDeepYieldableInsertion(\n  insertions: readonly unknown[],\n): boolean {\n  return insertions.some(\n    (insertion) =>\n      typeof insertion === 'function' && DEEP_YIELDABLE_INSERTION in insertion,\n  );\n}\n\nexport type NamedYieldableValue<\n  Name extends string = string,\n  Value = unknown,\n> = Value & {\n  readonly [YIELDABLE_VALUE]: Name;\n};\n\nexport type ReactiveReadIdentity = Readonly<{\n  /** Stable display name of the reactive value. */\n  name: string;\n  /** Owning primitive, when the reader comes from one. */\n  primitive?: string;\n  /** Full property path below the owning primitive. */\n  path?: string;\n  /** Insertion key, when the value was created by an insertion. */\n  insertion?: string;\n  /** Computed name, when the value is a craftComputed. */\n  computed?: string;\n}>;\n\n/** A request emitted by a public reactive reader and resolved by Craft. */\nexport type ReactiveReadRequest<T = unknown> = Readonly<{\n  [REACTIVE_READ_REQUEST]: true;\n  identity: ReactiveReadIdentity;\n  read: () => T;\n}>;\n\n/** Public contract of every reactive value exposed by Craft. */\nexport type YieldableReactiveValue<\n  T,\n  Name extends string = string,\n  Yielded = never,\n> = NamedYieldableValue<\n  Name,\n  (() => Generator<ReactiveReadRequest<T> | Yielded, T, unknown>) & {\n    readonly [RAW_REACTIVE_VALUE]: Signal<T>;\n    readonly [REACTIVE_VALUE_TYPE]: T;\n  } & Signal<T>\n>;\n\nexport type YieldableReactiveSignal<\n  Value extends Signal<any>,\n  Name extends string,\n> = YieldableReactiveValue<\n  Value extends Signal<infer State> ? State : never,\n  Name\n> &\n  Omit<Value, keyof Signal<any>>;\n\nexport type YieldableReactiveAction<Action extends (...args: any[]) => any> = ((\n  ...args: Parameters<Action>\n) => Generator<never, ReturnType<Action>, unknown>) & {\n  readonly [RAW_REACTIVE_ACTION]: Action;\n};\n\n/** Recursively restores the raw signal-shaped contract used by Craft internals. */\nexport type RawReactiveProperties<Shape> =\n  Shape extends YieldableReactiveValue<infer Value, any>\n    ? Signal<Value>\n    : Shape extends { readonly [RAW_REACTIVE_ACTION]: infer Action }\n      ? Action\n      : Shape extends (...args: any[]) => any\n        ? Shape\n        : Shape extends object\n          ? {\n              [Key in keyof Shape]: Key extends 'select' | 'selectOrCreate'\n                ? Shape[Key] extends (...args: infer Args) => infer Result\n                  ? (...args: Args) => RawReactiveProperties<Result>\n                  : RawReactiveProperties<Shape[Key]>\n                : RawReactiveProperties<Shape[Key]>;\n            }\n          : Shape;\n\n/** Recursively replaces exposed Angular signals while preserving methods/plain values. */\nexport type YieldableReactiveProperties<Shape> = Shape extends SourceBranded\n  ? Shape extends Signal<any>\n    ? YieldableReactiveSignal<Shape, string>\n    : Shape\n  : Shape extends YieldableReactiveValue<any, any>\n    ? Shape\n    : Shape extends Signal<any>\n      ? YieldableReactiveSignal<Shape, string>\n      : Shape extends (...args: any[]) => any\n        ? Shape\n        : Shape extends object\n          ? {\n              [Key in keyof Shape]: Shape[Key] extends SourceBranded\n                ? Shape[Key] extends Signal<any>\n                  ? YieldableReactiveSignal<\n                      Shape[Key],\n                      Key extends string ? Key : string\n                    >\n                  : Shape[Key]\n                : Shape[Key] extends Signal<any>\n                  ? Shape[Key] extends YieldableReactiveValue<any, any>\n                    ? Shape[Key]\n                    : YieldableReactiveSignal<\n                        Shape[Key],\n                        Key extends string ? Key : string\n                      >\n                  : Shape[Key] extends YieldableReactiveValue<any, any>\n                    ? Shape[Key]\n                    : Shape[Key] extends (...args: any[]) => any\n                      ? Key extends 'select' | 'selectOrCreate'\n                        ? (\n                            ...args: Parameters<Shape[Key]>\n                          ) => YieldableReactiveProperties<\n                            ReturnType<Shape[Key]>\n                          >\n                        : Key extends 'reload' | 'refresh'\n                          ? YieldableReactiveAction<Shape[Key]>\n                          : Shape[Key]\n                      : Shape[Key] extends object\n                        ? YieldableReactiveProperties<Shape[Key]>\n                        : Shape[Key];\n            }\n          : Shape;\n\nexport type ReactiveReadEdge = Readonly<{\n  reader?: ReactiveReadIdentity;\n  dependency: ReactiveReadIdentity;\n}>;\n\nexport type ReactiveReadObserver = (edge: ReactiveReadEdge) => void;\n\nlet activeReactiveReader: ReactiveReadIdentity | undefined;\n\nexport function ɵactiveReactiveReader(): ReactiveReadIdentity | undefined {\n  return activeReactiveReader;\n}\n\nexport function ɵwithActiveReactiveReader<T>(\n  identity: ReactiveReadIdentity,\n  read: () => T,\n): T {\n  const previous = activeReactiveReader;\n  activeReactiveReader = identity;\n  try {\n    return read();\n  } finally {\n    activeReactiveReader = previous;\n  }\n}\n\n/** Observability hook notified whenever a Craft generator resolves a reactive read. */\nexport const REACTIVE_READ_OBSERVERS = Object.assign(\n  craftToken<readonly ReactiveReadObserver[]>('REACTIVE_READ_OBSERVERS'),\n  {\n    ɵfactory: (): readonly ReactiveReadObserver[] => [],\n  },\n);\n\nexport function provideReactiveReadObserver(\n  observer: ReactiveReadObserver,\n): {\n  provide: typeof REACTIVE_READ_OBSERVERS;\n  useValue: ReactiveReadObserver;\n  multi: true;\n} {\n  return { provide: REACTIVE_READ_OBSERVERS, useValue: observer, multi: true };\n}\n\nexport function isReactiveReadRequest(\n  value: unknown,\n): value is ReactiveReadRequest {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    REACTIVE_READ_REQUEST in value\n  );\n}\n\nexport function isYieldableReactiveValue(\n  value: unknown,\n): value is YieldableReactiveValue<unknown> {\n  return (\n    typeof value === 'function' &&\n    RAW_REACTIVE_VALUE in value &&\n    YIELDABLE_VALUE in value\n  );\n}\n\nexport function rawReactiveValue<T>(\n  value: YieldableReactiveValue<T>,\n): Signal<T> {\n  return value[RAW_REACTIVE_VALUE];\n}\n\n/** Reconstructs the internal signal-shaped view expected by legacy internals. */\nconst rawFacadeCache = new WeakMap<object, unknown>();\n\nexport function rawReactiveFacade<Shape>(\n  value: Shape,\n): RawReactiveProperties<Shape> {\n  if (isYieldableReactiveValue(value)) {\n    return rawReactiveValue(value) as RawReactiveProperties<Shape>;\n  }\n  if (typeof value === 'function' && RAW_REACTIVE_ACTION in value) {\n    return value[RAW_REACTIVE_ACTION] as RawReactiveProperties<Shape>;\n  }\n  if (typeof value !== 'object' || value === null) {\n    return value as RawReactiveProperties<Shape>;\n  }\n  const cached = rawFacadeCache.get(value);\n  if (cached) return cached as RawReactiveProperties<Shape>;\n  const facade = new Proxy(value, {\n    get(target, property, receiver) {\n      return rawReactiveFacade(Reflect.get(target, property, receiver));\n    },\n  });\n  rawFacadeCache.set(value, facade);\n  return facade as RawReactiveProperties<Shape>;\n}\n\n/** Applies an insertion key to an anonymous craftComputed reader. */\nexport function nameInsertedReactiveValue<const Name extends string>(\n  value: unknown,\n  name: Name,\n  primitive: string,\n  path: string,\n): unknown {\n  if (!isYieldableReactiveValue(value)) return value;\n  if (value[YIELDABLE_VALUE] !== 'computed') return value;\n  return createYieldableReactiveValue(value[RAW_REACTIVE_VALUE], name, {\n    primitive,\n    insertion: name,\n    computed: name,\n    path,\n  });\n}\n\nexport function createYieldableReactiveValue<T, const Name extends string>(\n  source: Signal<T>,\n  name: Name,\n  identity: Omit<ReactiveReadIdentity, 'name'> = {},\n): YieldableReactiveValue<T, Name> {\n  const reader = function* reactiveReader(): Generator<\n    ReactiveReadRequest<T>,\n    T,\n    unknown\n  > {\n    const value = yield {\n      [REACTIVE_READ_REQUEST]: true,\n      identity: { name, ...identity },\n      read: source,\n    };\n    return value as T;\n  };\n\n  Object.defineProperties(reader, {\n    [YIELDABLE_VALUE]: {\n      value: name,\n      enumerable: false,\n      configurable: true,\n    },\n    [RAW_REACTIVE_VALUE]: {\n      value: source,\n      enumerable: false,\n      configurable: true,\n    },\n    [REACTIVE_VALUE_TYPE]: {\n      get: source,\n      enumerable: false,\n      configurable: true,\n    },\n  });\n\n  return reader as YieldableReactiveValue<T, Name>;\n}\n\nconst deepYieldableCache = new WeakMap<object, unknown>();\nconst deepYieldableRoots = new WeakSet<object>();\n\nfunction rawSourceOf(value: object): Signal<unknown> | undefined {\n  const descriptor = Object.getOwnPropertyDescriptor(value, RAW_REACTIVE_VALUE);\n  return descriptor?.value as Signal<unknown> | undefined;\n}\n\nfunction readProjectedPath(\n  source: () => unknown,\n  path: readonly PropertyKey[],\n): unknown {\n  let value: unknown = source();\n  for (const property of path) {\n    value = value == null ? undefined : Reflect.get(Object(value), property);\n  }\n  return value;\n}\n\nfunction createDeepProjection(\n  root: object,\n  path: readonly PropertyKey[],\n): unknown {\n  const pathText = [\n    String(Reflect.get(root, YIELDABLE_VALUE) ?? 'reader'),\n    ...path.map(String),\n  ].join('.');\n  const rootSignal = rawSourceOf(root);\n\n  const reader = function* deepProjectedReader(): Generator<\n    ReactiveReadRequest<unknown>,\n    unknown,\n    unknown\n  > {\n    if (rootSignal) {\n      const value = yield {\n        [REACTIVE_READ_REQUEST]: true,\n        identity: {\n          name: String(path[path.length - 1] ?? pathText),\n          path: pathText,\n        },\n        read: () => readProjectedPath(rootSignal, path),\n      };\n      return value;\n    }\n\n    const rootValue =\n      typeof root === 'function'\n        ? yield* (\n            root as unknown as () => Generator<\n              ReactiveReadRequest<unknown>,\n              unknown,\n              unknown\n            >\n          )()\n        : root;\n    return readProjectedPath(() => rootValue, path);\n  };\n\n  Object.defineProperty(reader, YIELDABLE_VALUE, {\n    value: pathText,\n    enumerable: false,\n  });\n\n  return new Proxy(reader, {\n    get(target, property, receiver) {\n      if (isFunctionNativeProperty(property)) {\n        return Reflect.get(target, property, receiver);\n      }\n      if (property === '__craftDeepYieldable') return true;\n      if (property !== 'name' && Reflect.has(target, property)) {\n        return Reflect.get(target, property, receiver);\n      }\n      if (typeof property !== 'string' && typeof property !== 'number') {\n        return undefined;\n      }\n      return getDeepProjection(root, [...path, property]);\n    },\n    has(target, property) {\n      if (isFunctionNativeProperty(property)) return true;\n      return Reflect.has(target, property);\n    },\n  });\n}\n\nfunction getDeepProjection(\n  root: object,\n  path: readonly PropertyKey[],\n): unknown {\n  const cacheKey = path.map(String).join('.');\n  const cached = deepYieldableCache.get(root);\n  if (cached && cached instanceof Map && cached.has(cacheKey)) {\n    return cached.get(cacheKey);\n  }\n\n  const projection = createDeepProjection(root, path);\n  const nextCache = cached instanceof Map ? cached : new Map<string, unknown>();\n  nextCache.set(cacheKey, projection);\n  deepYieldableCache.set(root, nextCache);\n  return projection;\n}\n\nfunction isFunctionNativeProperty(property: PropertyKey): boolean {\n  return (\n    property === 'prototype' ||\n    property === 'arguments' ||\n    property === 'caller'\n  );\n}\n\n/**\n * Explicitly adapts a reader so data properties become stable lazy readers.\n * Ordinary readers are deliberately left untouched until this function is\n * called.\n */\nexport function deepYieldable<Reader>(\n  reader: Reader,\n): Reader extends object ? DeepYieldableReaderOf<Reader> : Reader {\n  if (\n    (typeof reader !== 'function' &&\n      (typeof reader !== 'object' || reader === null)) ||\n    deepYieldableRoots.has(reader as object)\n  ) {\n    return reader as Reader extends object\n      ? DeepYieldableReaderOf<Reader>\n      : Reader;\n  }\n\n  const root = reader as unknown as object;\n  const facade = new Proxy(root, {\n    get(target, property, receiver) {\n      if (isFunctionNativeProperty(property)) {\n        return Reflect.get(target, property, receiver);\n      }\n      if (property === '__craftDeepYieldable') return true;\n      if (\n        property !== 'name' &&\n        rawSourceOf(root) &&\n        Reflect.has(target, property)\n      ) {\n        return Reflect.get(target, property, receiver);\n      }\n      if (property === YIELDABLE_VALUE) return 'deep-yieldable';\n      if (property === DEEP_YIELDABLE) return true;\n      if (typeof property !== 'string' && typeof property !== 'number') {\n        return undefined;\n      }\n      return getDeepProjection(root, [property]);\n    },\n    has(target, property) {\n      if (isFunctionNativeProperty(property)) return true;\n      return (\n        property === '__craftDeepYieldable' ||\n        property === YIELDABLE_VALUE ||\n        property === DEEP_YIELDABLE ||\n        Reflect.has(target, property)\n      );\n    },\n  });\n  Object.defineProperty(facade, '__craftDeepYieldable', {\n    value: true,\n    enumerable: false,\n  });\n  deepYieldableRoots.add(facade);\n  return facade as Reader extends object\n    ? DeepYieldableReaderOf<Reader>\n    : Reader;\n}\n\nconst facadeCache = new WeakMap<object, Map<string, unknown>>();\n\n/**\n * Creates a non-mutating public view of a primitive/ref. Signal calls become\n * reactive read generators; non-reactive methods and values keep their runtime\n * contract. Nested signal properties are adapted lazily and cached.\n */\nexport function createYieldableReactiveFacade<Shape>(\n  value: Shape,\n  identity: ReactiveReadIdentity,\n): YieldableReactiveProperties<Shape> {\n  return createFacade(\n    value,\n    identity,\n    identity.path ?? identity.name,\n  ) as YieldableReactiveProperties<Shape>;\n}\n\n/**\n * Creates the deep reader used by resource collections such as\n * `query.exceptions`. Unlike `deepYieldable`, this starts from the raw signal\n * so the primitive can opt one reactive property into deep projection without\n * making the whole primitive deeply yieldable.\n */\nexport function createDeepYieldableReactiveValue<\n  Value,\n  const Name extends string,\n>(\n  source: Signal<Value>,\n  name: Name,\n  identity: Omit<ReactiveReadIdentity, 'name'> = {},\n): DeepYieldableReactiveValue<Value, Name> {\n  return deepYieldable(\n    createYieldableReactiveValue(source, name, identity),\n  ) as DeepYieldableReactiveValue<Value, Name>;\n}\n\nfunction createFacade(\n  value: unknown,\n  identity: ReactiveReadIdentity,\n  path: string,\n  deep = false,\n): unknown {\n  if (typeof value !== 'object' && typeof value !== 'function') return value;\n  if (value === null) return value;\n  // Generator/iterator instances carry native methods whose receiver must be\n  // the original instance. Proxying one (for example, the invocation returned\n  // by an insertion method named `select`) makes `yield*` call `.next` with the\n  // proxy as receiver and throws \"incompatible receiver\".\n  if (\n    'next' in value &&\n    typeof (value as { next?: unknown }).next === 'function'\n  ) {\n    return value;\n  }\n  if (isDeepYieldable(value) || isYieldableReactiveValue(value)) return value;\n\n  const cacheKey = `${identity.primitive ?? ''}|${identity.computed ?? ''}|${path}`;\n  const cachedByPath = facadeCache.get(value as object);\n  if (cachedByPath?.has(cacheKey)) return cachedByPath.get(cacheKey);\n\n  let facade: unknown;\n  if (isCraftSignal(value) || isCallableSignal(value)) {\n    const pathParts = path.split('.');\n    const propertyName = pathParts[pathParts.length - 1] ?? identity.name;\n    const reader = createYieldableReactiveValue(\n      value as unknown as Signal<unknown>,\n      propertyName,\n      {\n        ...identity,\n        path,\n      },\n    );\n    facade = deep\n      ? deepYieldable(reader)\n      : new Proxy(reader, {\n          get(_target, property) {\n            if (\n              property === YIELDABLE_VALUE ||\n              property === RAW_REACTIVE_VALUE\n            ) {\n              return Reflect.get(reader, property);\n            }\n            if (!Reflect.has(value, property) && Reflect.has(reader, property)) {\n              return createFacade(\n                Reflect.get(reader, property),\n                identity,\n                `${path}.${String(property)}`,\n              );\n            }\n            const child = Reflect.get(value, property);\n            if (\n              (property === 'select' || property === 'selectOrCreate') &&\n              typeof child === 'function'\n            ) {\n              return (...args: unknown[]) =>\n                createFacade(\n                  Reflect.apply(child, value, args),\n                  identity,\n                  `${path}.${String(property)}.${String(args[0] ?? 'selected')}`,\n                );\n            }\n            return createFacade(\n              child,\n              {\n                ...identity,\n                insertion:\n                  identity.insertion ??\n                  (typeof property === 'string' ? property : undefined),\n              },\n              `${path}.${String(property)}`,\n            );\n          },\n          ownKeys: (target) => [\n            ...new Set([...Reflect.ownKeys(target), ...Reflect.ownKeys(value)]),\n          ],\n          getOwnPropertyDescriptor(_target, property) {\n            const targetDescriptor = Reflect.getOwnPropertyDescriptor(\n              reader,\n              property,\n            );\n            if (targetDescriptor) return targetDescriptor;\n            const descriptor = Reflect.getOwnPropertyDescriptor(value, property);\n            return descriptor\n              ? { ...descriptor, configurable: true }\n              : undefined;\n          },\n          has: (_target, property) =>\n            property === YIELDABLE_VALUE ||\n            property === RAW_REACTIVE_VALUE ||\n            Reflect.has(value, property),\n      });\n  } else {\n    facade = new Proxy(value as object, {\n      get(target, property, receiver) {\n        const child = Reflect.get(target, property, receiver);\n        if (\n          (property === 'reload' || property === 'refresh') &&\n          typeof child === 'function'\n        ) {\n          const action = function* yieldableReactiveAction(\n            ...args: unknown[]\n          ): Generator<never, unknown, unknown> {\n            return Reflect.apply(child, target, args);\n          };\n          Object.defineProperty(action, RAW_REACTIVE_ACTION, { value: child });\n          return action;\n        }\n        if (\n          (property === 'select' || property === 'selectOrCreate') &&\n          typeof child === 'function'\n        ) {\n          return (...args: unknown[]) =>\n            createFacade(\n              Reflect.apply(child, target, args),\n              identity,\n              `${path}.${String(property)}.${String(args[0] ?? 'selected')}`,\n            );\n        }\n        if (\n          !isCraftSignal(child) &&\n          !isCallableSignal(child) &&\n          (typeof child !== 'object' || child === null)\n        ) {\n          return child;\n        }\n        return createFacade(\n          child,\n          {\n            ...identity,\n            insertion:\n              identity.insertion ??\n              (typeof property === 'string' ? property : undefined),\n          },\n          `${path}.${String(property)}`,\n          property === 'exceptions',\n        );\n      },\n    });\n  }\n\n  const nextCache = cachedByPath ?? new Map<string, unknown>();\n  nextCache.set(cacheKey, facade);\n  if (!cachedByPath) facadeCache.set(value as object, nextCache);\n  return facade;\n}\n\nfunction isDeepYieldable(value: unknown): value is DeepYieldableMarker {\n  return (\n    (typeof value === 'object' && value !== null) ||\n    typeof value === 'function'\n  ) && '__craftDeepYieldable' in (value as object);\n}\n"]}

package/src/lib/resource-by-id.d.ts

@@ -0,0 +1,71 @@
+import { ResourceOptions, Signal } from './host/craft-compat';
+import { Prettify } from './util/util.type';
+import { CraftResourceRef } from './util/craft-resource-ref';
+import { resourceByIdChangesTrackerResult } from './util/resource-by-id-changes-tracker.util';
+export type ResourceByIdHandler<GroupIdentifier extends string, State, ResourceParams> = {
+    /**
+     * Reset all the CraftResourceRef instance stored in the ResourceByIdRef
+     */
+    reset: () => void;
+    /**
+     * Reset the CraftResourceRef instance associated with the provided id
+     */
+    resetResource: (id: GroupIdentifier) => void;
+    /**
+     * Add a new CraftResourceRef instance
+     */
+    add: (params: ResourceParams, options?: {
+        defaultValue?: State;
+    }) => CraftResourceRef<State, ResourceParams>;
+    /**
+     * ! The added resource may not load immediately if the global params do not match the identifier function.
+     * Useful at the app initialization when the resource value is retrieved from a persister for example.
+     */
+    addById: (id: GroupIdentifier, options?: {
+        defaultParam?: ResourceParams;
+        defaultValue?: State;
+        paramsFromResourceById?: CraftResourceRef<unknown, unknown>;
+    }) => CraftResourceRef<State, ResourceParams>;
+    /**
+     * Set the values of multiple resources. If a resource doesn't exist, it will be created.
+     */
+    set: (payload: Partial<Record<GroupIdentifier, State>>) => void;
+    /**
+     * Update values of multiple resources without removing existing ones.
+     * If a resource doesn't exist, it will be created.
+     */
+    update: (payload: (state: Partial<Record<GroupIdentifier, State>>) => Partial<Record<GroupIdentifier, State>>) => void;
+    /**
+     * Tracks the status and value changes of resources.
+     * Provides signals for hasChange, ids, resolved, loading, reloading, error, and onlyValueChange.
+     */
+    changes: resourceByIdChangesTrackerResult<GroupIdentifier>;
+    /**
+     * A computed signal that returns a record of all resource states by their group identifier.
+     */
+    state: Signal<Partial<Record<GroupIdentifier, State>>>;
+};
+export type Identifier<ResourceParams, GroupIdentifier> = (request: NonNullable<ResourceParams>) => GroupIdentifier;
+export type ResourceByIdRef<GroupIdentifier extends string, State, ResourceParams> = Signal<Prettify<Partial<Record<GroupIdentifier, CraftResourceRef<State, ResourceParams>>>>> & ResourceByIdHandler<GroupIdentifier, State, ResourceParams>;
+export type EqualParams<ResourceParams, GroupIdentifier extends string> = 'default' | 'useIdentifier' | ((a: ResourceParams, b: ResourceParams, identifierFn: (params: ResourceParams) => GroupIdentifier) => boolean);
+type ResourceByIdConfig<State, ResourceParams, GroupIdentifier extends string, FromObjectGroupIdentifier extends string, FromObjectState, FromObjectResourceParams> = Omit<ResourceOptions<State, ResourceParams>, 'params'> & {
+    /** @internal Shared source name used by the server policy gate. */
+    ssrSourceName?: string;
+} & ({
+    fromResourceById?: never;
+    params: () => ResourceParams;
+    identifier: Identifier<NoInfer<ResourceParams>, GroupIdentifier>;
+    equalParams?: EqualParams<ResourceParams, GroupIdentifier>;
+} | {
+    /**
+     * Use it, when you need to bind a ResourceByIdRef to another ResourceByIdRef.
+     * It will kill the fromObject keys syncing when the fromObject resource change.
+     */
+    fromResourceById: ResourceByIdRef<FromObjectGroupIdentifier, FromObjectState, FromObjectResourceParams>;
+    params: (entity: CraftResourceRef<NoInfer<FromObjectState>, NoInfer<FromObjectResourceParams>>) => ResourceParams;
+    identifier: Identifier<NoInfer<ResourceParams>, GroupIdentifier>;
+    equalParams?: EqualParams<ResourceParams, GroupIdentifier>;
+});
+export declare function resourceById<State, ResourceParams, GroupIdentifier extends string, FromObjectGroupIdentifier extends string, FromObjectState, FromObjectResourceParams>(config: ResourceByIdConfig<State, ResourceParams, GroupIdentifier, FromObjectGroupIdentifier, FromObjectState, FromObjectResourceParams>): ResourceByIdRef<GroupIdentifier, State, ResourceParams>;
+export {};
+//# sourceMappingURL=resource-by-id.d.ts.map

package/src/lib/resource-by-id.d.ts.map

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