@mszr/idb-dux 1.0.0

package/dist/esm/query/constants.js

@@ -0,0 +1,13 @@
+/**
+ * `$only` is a `true` constant sharing its name with the `$:` key it enables,
+ * so property shorthand reads as the declaration it is:
+ * `$: { where: { id }, $only }` ≡ `$: { where: { id }, $only: true }`.
+ */
+export const $only = true;
+/**
+ * `$skip` is an `undefined` constant: an `undefined` value in a `where`
+ * clause drops that clause before the query goes on the wire, so
+ * `where: { workspace: current?.id ?? $skip }` reads as intended.
+ */
+export const $skip = undefined;
+//# sourceMappingURL=constants.js.map

package/dist/esm/query/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/query/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAa,CAAA;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAA","sourcesContent":["/**\n * `$only` is a `true` constant sharing its name with the `$:` key it enables,\n * so property shorthand reads as the declaration it is:\n * `$: { where: { id }, $only }` ≡ `$: { where: { id }, $only: true }`.\n */\nexport const $only = true as const\n\n/**\n * `$skip` is an `undefined` constant: an `undefined` value in a `where`\n * clause drops that clause before the query goes on the wire, so\n * `where: { workspace: current?.id ?? $skip }` reads as intended.\n */\nexport const $skip = undefined\n"]}

package/dist/esm/query/defineQuery.d.ts

@@ -0,0 +1,33 @@
+import type { IdbSchema } from '../schema/defineSchema.js';
+import type { IdbRegisteredSchema } from '../schema/register.js';
+import type { IdbValidQuery } from './validation.js';
+/**
+ * A schema-bound `q`: validates the query and returns it, type intact.
+ * The `const` type parameter keeps `$only: true`, `$as` names, and `indexBy`
+ * keys literal — the shaping mirror depends on them.
+ */
+export interface IdbQueryBuilder<S extends IdbSchema> {
+    <const Q extends IdbValidQuery<Q, S>>(query: Q): Q;
+}
+/**
+ * The multi-schema escape hatch: a `q` bound to an explicit schema type.
+ * The runtime is schema-independent — all validation is type-level.
+ *
+ * @example
+ *   const oq = defineQuery<OtherSchema>()
+ *   const query = oq({ posts: {} })
+ */
+export declare function defineQuery<S extends IdbSchema = IdbRegisteredSchema>(): IdbQueryBuilder<S>;
+/**
+ * Schema-aware query authoring, ready-made via registration. Wrap a query in
+ * `q()` to get completions and field-localized errors anywhere — inline,
+ * named and shared, or inside a factory body:
+ *
+ * @example
+ *   const { tasks } = db.useQuery(() => {
+ *     if (!userId) return null
+ *     return q({ tasks: { $: { where: { isDone: false } } } })
+ *   })
+ */
+export declare const q: IdbQueryBuilder<IdbRegisteredSchema>;
+//# sourceMappingURL=defineQuery.d.ts.map

package/dist/esm/query/defineQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineQuery.d.ts","sourceRoot":"","sources":["../../../src/query/defineQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS;IAClD,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,mBAAmB,KAAK,eAAe,CAAC,CAAC,CAAC,CAE3F;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAiC,CAAA"}

package/dist/esm/query/defineQuery.js

@@ -0,0 +1,24 @@
+/**
+ * The multi-schema escape hatch: a `q` bound to an explicit schema type.
+ * The runtime is schema-independent — all validation is type-level.
+ *
+ * @example
+ *   const oq = defineQuery<OtherSchema>()
+ *   const query = oq({ posts: {} })
+ */
+export function defineQuery() {
+    return query => query;
+}
+/**
+ * Schema-aware query authoring, ready-made via registration. Wrap a query in
+ * `q()` to get completions and field-localized errors anywhere — inline,
+ * named and shared, or inside a factory body:
+ *
+ * @example
+ *   const { tasks } = db.useQuery(() => {
+ *     if (!userId) return null
+ *     return q({ tasks: { $: { where: { isDone: false } } } })
+ *   })
+ */
+export const q = /* @__PURE__ */ defineQuery();
+//# sourceMappingURL=defineQuery.js.map

package/dist/esm/query/defineQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineQuery.js","sourceRoot":"","sources":["../../../src/query/defineQuery.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,CAAA;AACvB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,CAAC,GAAyC,eAAe,CAAC,WAAW,EAAE,CAAA","sourcesContent":["import type { IdbSchema } from '../schema/defineSchema.js'\nimport type { IdbRegisteredSchema } from '../schema/register.js'\nimport type { IdbValidQuery } from './validation.js'\n\n/**\n * A schema-bound `q`: validates the query and returns it, type intact.\n * The `const` type parameter keeps `$only: true`, `$as` names, and `indexBy`\n * keys literal — the shaping mirror depends on them.\n */\nexport interface IdbQueryBuilder<S extends IdbSchema> {\n  <const Q extends IdbValidQuery<Q, S>>(query: Q): Q\n}\n\n/**\n * The multi-schema escape hatch: a `q` bound to an explicit schema type.\n * The runtime is schema-independent — all validation is type-level.\n *\n * @example\n *   const oq = defineQuery<OtherSchema>()\n *   const query = oq({ posts: {} })\n */\nexport function defineQuery<S extends IdbSchema = IdbRegisteredSchema>(): IdbQueryBuilder<S> {\n  return query => query\n}\n\n/**\n * Schema-aware query authoring, ready-made via registration. Wrap a query in\n * `q()` to get completions and field-localized errors anywhere — inline,\n * named and shared, or inside a factory body:\n *\n * @example\n *   const { tasks } = db.useQuery(() => {\n *     if (!userId) return null\n *     return q({ tasks: { $: { where: { isDone: false } } } })\n *   })\n */\nexport const q: IdbQueryBuilder<IdbRegisteredSchema> = /* @__PURE__ */ defineQuery()\n"]}

package/dist/esm/query/index.d.ts

@@ -0,0 +1,9 @@
+export { $only, $skip } from './constants.js';
+export type { IdbQueryBuilder } from './defineQuery.js';
+export { defineQuery, q } from './defineQuery.js';
+export type { HasPick, ResolvedScopeKey, SingularScopeKey } from './keys.js';
+export { resultKeys, shapeResult, shapingSchema } from './shapeResult.js';
+export type { IdbMBlock, IdbMTransform, IdbQuery, IdbQueryData, IdbQueryEntity, IdbQueryFields, IdbQueryNode, IdbQueryOptions, IdbQueryPageInfo, IdbQuerySubquery, IdbSchemaRuleParams, IdbWhereOps, } from './types.js';
+export type { IdbValidQuery } from './validation.js';
+export { toWireQuery } from './wire.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACzE,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/esm/query/index.js

@@ -0,0 +1,5 @@
+export { $only, $skip } from './constants.js';
+export { defineQuery, q } from './defineQuery.js';
+export { resultKeys, shapeResult, shapingSchema } from './shapeResult.js';
+export { toWireQuery } from './wire.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAgBzE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA","sourcesContent":["export { $only, $skip } from './constants.js'\nexport type { IdbQueryBuilder } from './defineQuery.js'\nexport { defineQuery, q } from './defineQuery.js'\nexport type { HasPick, ResolvedScopeKey, SingularScopeKey } from './keys.js'\nexport { resultKeys, shapeResult, shapingSchema } from './shapeResult.js'\nexport type {\n  IdbMBlock,\n  IdbMTransform,\n  IdbQuery,\n  IdbQueryData,\n  IdbQueryEntity,\n  IdbQueryFields,\n  IdbQueryNode,\n  IdbQueryOptions,\n  IdbQueryPageInfo,\n  IdbQuerySubquery,\n  IdbSchemaRuleParams,\n  IdbWhereOps,\n} from './types.js'\nexport type { IdbValidQuery } from './validation.js'\nexport { toWireQuery } from './wire.js'\n"]}

package/dist/esm/query/keys.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type-level scope-key resolution — the mirror of `resolveSingularKey` in
+ * `shapeResult.ts`. Both derive from the same schema metadata, so the
+ * TypeScript key and the runtime key always match.
+ *
+ * `ParentNS` is `null` for top-level scopes (the key is a namespace name) and
+ * the parent's namespace name for nested scopes (the key is a link label).
+ */
+import type { IdbSchema } from '../schema/defineSchema.js';
+import type { Singularize } from '../schema/singularize.js';
+type DeclaredSingular<S extends IdbSchema, ParentNS extends string | null, Key extends string> = ParentNS extends null ? Key extends keyof S['$dux']['namespaces'] ? S['$dux']['namespaces'][Key]['singular'] : undefined : ParentNS extends keyof S['$dux']['linkSingulars'] ? Key extends keyof S['$dux']['linkSingulars'][ParentNS] ? S['$dux']['linkSingulars'][ParentNS][Key] : undefined : undefined;
+/** The singular form of a scope key per the schema's `options.singularize`. */
+export type SingularScopeKey<S extends IdbSchema, ParentNS extends string | null, Key extends string> = S['$dux']['options']['singularize'] extends 'off' ? Key : DeclaredSingular<S, ParentNS, Key> extends infer Declared ? Declared extends string ? Declared : S['$dux']['options']['singularize'] extends 'explicit' ? Key : Singularize<Key> : never;
+/** Whether a scope node coerces its array to a single entity. */
+export type HasPick<Node> = Node extends {
+    $: infer Dollar;
+} ? Dollar extends {
+    $only: true;
+} | {
+    $at: number;
+} ? true : false : false;
+/** The output key of a scope: `$as` wins, `$only`/`$at` singularize, else as-is. */
+export type ResolvedScopeKey<S extends IdbSchema, ParentNS extends string | null, Key extends string, Node> = Node extends {
+    $: infer Dollar;
+} ? Dollar extends {
+    $as: infer As extends string;
+} ? As : Dollar extends {
+    $only: true;
+} | {
+    $at: number;
+} ? SingularScopeKey<S, ParentNS, Key> : Key : Key;
+export {};
+//# sourceMappingURL=keys.d.ts.map

package/dist/esm/query/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/query/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,KAAK,gBAAgB,CACnB,CAAC,SAAS,SAAS,EACnB,QAAQ,SAAS,MAAM,GAAG,IAAI,EAC9B,GAAG,SAAS,MAAM,IAChB,QAAQ,SAAS,IAAI,GACrB,GAAG,SAAS,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACvC,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GACxC,SAAS,GACX,QAAQ,SAAS,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,GAC/C,GAAG,SAAS,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,GACpD,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GACzC,SAAS,GACX,SAAS,CAAA;AAEf,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,SAAS,EACnB,QAAQ,SAAS,MAAM,GAAG,IAAI,EAC9B,GAAG,SAAS,MAAM,IAChB,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,SAAS,KAAK,GACjD,GAAG,GACH,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,MAAM,QAAQ,GACvD,QAAQ,SAAS,MAAM,GACrB,QAAQ,GACR,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,SAAS,UAAU,GACpD,GAAG,GACH,WAAW,CAAC,GAAG,CAAC,GACpB,KAAK,CAAA;AAEX,iEAAiE;AACjE,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,IAAI,SAAS;IAAE,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,GACxD,MAAM,SAAS;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9C,IAAI,GACJ,KAAK,GACP,KAAK,CAAA;AAET,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,SAAS,EACnB,QAAQ,SAAS,MAAM,GAAG,IAAI,EAC9B,GAAG,SAAS,MAAM,EAClB,IAAI,IACF,IAAI,SAAS;IAAE,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,GAChC,MAAM,SAAS;IAAE,GAAG,EAAE,MAAM,EAAE,SAAS,MAAM,CAAA;CAAE,GAC7C,EAAE,GACF,MAAM,SAAS;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9C,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,GAClC,GAAG,GACP,GAAG,CAAA"}

package/dist/esm/query/keys.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keys.js.map

package/dist/esm/query/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/query/keys.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Type-level scope-key resolution — the mirror of `resolveSingularKey` in\n * `shapeResult.ts`. Both derive from the same schema metadata, so the\n * TypeScript key and the runtime key always match.\n *\n * `ParentNS` is `null` for top-level scopes (the key is a namespace name) and\n * the parent's namespace name for nested scopes (the key is a link label).\n */\nimport type { IdbSchema } from '../schema/defineSchema.js'\nimport type { Singularize } from '../schema/singularize.js'\n\ntype DeclaredSingular<\n  S extends IdbSchema,\n  ParentNS extends string | null,\n  Key extends string,\n> = ParentNS extends null\n  ? Key extends keyof S['$dux']['namespaces']\n    ? S['$dux']['namespaces'][Key]['singular']\n    : undefined\n  : ParentNS extends keyof S['$dux']['linkSingulars']\n    ? Key extends keyof S['$dux']['linkSingulars'][ParentNS]\n      ? S['$dux']['linkSingulars'][ParentNS][Key]\n      : undefined\n    : undefined\n\n/** The singular form of a scope key per the schema's `options.singularize`. */\nexport type SingularScopeKey<\n  S extends IdbSchema,\n  ParentNS extends string | null,\n  Key extends string,\n> = S['$dux']['options']['singularize'] extends 'off'\n  ? Key\n  : DeclaredSingular<S, ParentNS, Key> extends infer Declared\n    ? Declared extends string\n      ? Declared\n      : S['$dux']['options']['singularize'] extends 'explicit'\n        ? Key\n        : Singularize<Key>\n    : never\n\n/** Whether a scope node coerces its array to a single entity. */\nexport type HasPick<Node> = Node extends { $: infer Dollar }\n  ? Dollar extends { $only: true } | { $at: number }\n    ? true\n    : false\n  : false\n\n/** The output key of a scope: `$as` wins, `$only`/`$at` singularize, else as-is. */\nexport type ResolvedScopeKey<\n  S extends IdbSchema,\n  ParentNS extends string | null,\n  Key extends string,\n  Node,\n> = Node extends { $: infer Dollar }\n  ? Dollar extends { $as: infer As extends string }\n    ? As\n    : Dollar extends { $only: true } | { $at: number }\n      ? SingularScopeKey<S, ParentNS, Key>\n      : Key\n  : Key\n"]}

package/dist/esm/query/shapeResult.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The one place result-shaping logic exists. `/vue` wraps it reactively,
+ * `/admin` applies it post-`await` — both deliver identical shapes for the
+ * same query by construction. The type-level mirror is `IdbQueryData`
+ * (`types.ts`); the two derive from the same schema source so the runtime key
+ * and the TypeScript key always match.
+ *
+ * Shaping per scope:
+ * - top-level namespaces normalize to `Entity[]` — never `undefined`
+ * - `$only` picks element 0, `$at: n` picks position n (negative from the
+ *   end); both rename the scope key to its singular form per the schema
+ * - `$as` renames explicitly and always wins
+ * - `$m` adds labeled sibling keys (`indexBy` / `groupBy` / `at`) computed in
+ *   a single pass over the scope's data, leaving the original key untouched
+ * - nested link scopes shape recursively inside each entity; untouched
+ *   subtrees are returned by reference, never copied
+ */
+import type { IdbSchema } from '../schema/defineSchema.js';
+type AnyRecord = Record<string, any>;
+/**
+ * The top-level keys a shaped result will carry for a query — the resolved
+ * scope keys plus every `$m` sibling label — derived from the query structure
+ * alone, no data needed. The client overlay uses this to expose one reactive
+ * ref per scope for destructuring.
+ */
+export declare function resultKeys(query: AnyRecord, schema: IdbSchema): string[];
+/**
+ * A schema with a usable `$dux` projection for runtime shaping — the real
+ * schema when one is registered, a permissive stub otherwise (singularize
+ * 'auto', no declared singulars, no link metadata). Both clients reach for it
+ * so a query with no schema still shapes consistently.
+ */
+export declare function shapingSchema(schema: IdbSchema | undefined): IdbSchema;
+export declare function shapeResult(rawData: AnyRecord | undefined, query: AnyRecord, schema: IdbSchema): AnyRecord;
+export {};
+//# sourceMappingURL=shapeResult.d.ts.map

package/dist/esm/query/shapeResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeResult.d.ts","sourceRoot":"","sources":["../../../src/query/shapeResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAG1D,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAQpC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAmBxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAStE;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,GAChB,SAAS,CAUX"}

package/dist/esm/query/shapeResult.js

@@ -0,0 +1,168 @@
+/**
+ * The one place result-shaping logic exists. `/vue` wraps it reactively,
+ * `/admin` applies it post-`await` — both deliver identical shapes for the
+ * same query by construction. The type-level mirror is `IdbQueryData`
+ * (`types.ts`); the two derive from the same schema source so the runtime key
+ * and the TypeScript key always match.
+ *
+ * Shaping per scope:
+ * - top-level namespaces normalize to `Entity[]` — never `undefined`
+ * - `$only` picks element 0, `$at: n` picks position n (negative from the
+ *   end); both rename the scope key to its singular form per the schema
+ * - `$as` renames explicitly and always wins
+ * - `$m` adds labeled sibling keys (`indexBy` / `groupBy` / `at`) computed in
+ *   a single pass over the scope's data, leaving the original key untouched
+ * - nested link scopes shape recursively inside each entity; untouched
+ *   subtrees are returned by reference, never copied
+ */
+import { singularize } from '../schema/singularize.js';
+/**
+ * The top-level keys a shaped result will carry for a query — the resolved
+ * scope keys plus every `$m` sibling label — derived from the query structure
+ * alone, no data needed. The client overlay uses this to expose one reactive
+ * ref per scope for destructuring.
+ */
+export function resultKeys(query, schema) {
+    const keys = [];
+    for (const [key, node] of Object.entries(query)) {
+        if (key === '$$ruleParams')
+            continue;
+        const dollar = node?.$ ?? {};
+        const pick = dollar.$only === true || typeof dollar.$at === 'number';
+        keys.push(typeof dollar.$as === 'string'
+            ? dollar.$as
+            : pick
+                ? resolveSingularKey(key, null, schema)
+                : key);
+        const m = node?.$m;
+        if (m)
+            keys.push(...Object.keys(m));
+    }
+    return keys;
+}
+/**
+ * A schema with a usable `$dux` projection for runtime shaping — the real
+ * schema when one is registered, a permissive stub otherwise (singularize
+ * 'auto', no declared singulars, no link metadata). Both clients reach for it
+ * so a query with no schema still shapes consistently.
+ */
+export function shapingSchema(schema) {
+    if (schema)
+        return schema;
+    return {
+        entities: {},
+        links: {},
+        rooms: {},
+        $dux: { namespaces: {}, linkSingulars: {}, options: { singularize: 'auto' } },
+    };
+}
+export function shapeResult(rawData, query, schema) {
+    const out = {};
+    for (const [key, node] of Object.entries(query)) {
+        // `$`-prefixed namespaces ($users, …) are data; only the internal
+        // ruleParams envelope is not a scope.
+        if (key === '$$ruleParams')
+            continue;
+        shapeScopeInto(out, rawData?.[key] ?? [], key, node ?? {}, null, key, schema);
+    }
+    return out;
+}
+/**
+ * Shapes one scope into `out`: the resolved scope key, plus any `$m` sibling
+ * keys. `parentNs` is the namespace the scope key sits on (`null` for
+ * top-level scopes); `ns` is the namespace the scope's entities belong to.
+ */
+function shapeScopeInto(out, raw, key, node, parentNs, ns, schema) {
+    const dollar = node.$ ?? {};
+    const value = shapeChildren(raw, node, ns, schema);
+    if (node.$m && Array.isArray(value))
+        applyMSiblings(out, value, node.$m);
+    const pick = dollar.$only === true ? 0 : typeof dollar.$at === 'number' ? dollar.$at : null;
+    const picked = pick !== null && Array.isArray(value) ? value.at(pick) : value;
+    const outputKey = typeof dollar.$as === 'string'
+        ? dollar.$as
+        : pick !== null
+            ? resolveSingularKey(key, parentNs, schema)
+            : key;
+    out[outputKey] = picked;
+}
+/**
+ * Recursively shapes the nested link scopes inside each entity of a scope
+ * whose entities belong to `ns`. Entities are copied only along paths that
+ * actually change.
+ */
+function shapeChildren(raw, node, ns, schema) {
+    const childKeys = Object.keys(node).filter(k => k !== '$' && k !== '$m');
+    if (childKeys.length === 0 || !childKeys.some(k => subtreeReshapes(node[k])))
+        return raw;
+    const shapeEntity = (entity) => {
+        if (entity === null || typeof entity !== 'object')
+            return entity;
+        const copy = { ...entity };
+        for (const childKey of childKeys) {
+            const childRaw = copy[childKey];
+            delete copy[childKey];
+            const childNs = linkTarget(schema, ns, childKey);
+            shapeScopeInto(copy, childRaw, childKey, node[childKey] ?? {}, ns, childNs, schema);
+        }
+        return copy;
+    };
+    return Array.isArray(raw) ? raw.map(shapeEntity) : shapeEntity(raw);
+}
+/** The namespace a link label on `ns` points to, via the enriched entity defs. */
+function linkTarget(schema, ns, label) {
+    return schema.entities[ns]?.links?.[label]?.entityName ?? label;
+}
+/** Whether a subtree contains any directive that changes the data shape. */
+function subtreeReshapes(node) {
+    if (node === null || typeof node !== 'object')
+        return false;
+    const record = node;
+    if (record.$m !== undefined)
+        return true;
+    const dollar = record.$;
+    if (dollar && (dollar.$only !== undefined || dollar.$at !== undefined || dollar.$as !== undefined))
+        return true;
+    return Object.keys(record).some(k => k !== '$' && k !== '$m' && subtreeReshapes(record[k]));
+}
+/** All `$m` projections for one scope, computed in a single pass. */
+function applyMSiblings(out, entities, transforms) {
+    const labels = Object.entries(transforms);
+    for (const [label, transform] of labels) {
+        out[label] = typeof transform.at === 'number'
+            ? entities.at(transform.at)
+            : {};
+    }
+    for (const entity of entities) {
+        for (const [label, transform] of labels) {
+            if (transform.indexBy !== undefined) {
+                const indexValue = entity[transform.indexBy];
+                if (indexValue !== null && indexValue !== undefined)
+                    out[label][String(indexValue)] = entity;
+            }
+            else if (transform.groupBy !== undefined) {
+                const groupValue = entity[transform.groupBy];
+                if (groupValue !== null && groupValue !== undefined)
+                    (out[label][String(groupValue)] ??= []).push(entity);
+            }
+        }
+    }
+}
+/**
+ * The singular form of a scope key — declared `singular` first (namespace
+ * `singular` for top-level keys, link label `singular` for nested keys), the
+ * shared algorithm as the `'auto'` fallback, honoring `options.singularize`.
+ */
+function resolveSingularKey(key, parentNs, schema) {
+    const meta = schema.$dux;
+    const mode = meta.options.singularize;
+    if (mode === 'off')
+        return key;
+    const declared = parentNs === null
+        ? meta.namespaces[key]?.singular
+        : meta.linkSingulars[parentNs]?.[key];
+    if (declared !== undefined)
+        return declared;
+    return mode === 'auto' ? singularize(key) : key;
+}
+//# sourceMappingURL=shapeResult.js.map

package/dist/esm/query/shapeResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeResult.js","sourceRoot":"","sources":["../../../src/query/shapeResult.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The one place result-shaping logic exists. `/vue` wraps it reactively,\n * `/admin` applies it post-`await` — both deliver identical shapes for the\n * same query by construction. The type-level mirror is `IdbQueryData`\n * (`types.ts`); the two derive from the same schema source so the runtime key\n * and the TypeScript key always match.\n *\n * Shaping per scope:\n * - top-level namespaces normalize to `Entity[]` — never `undefined`\n * - `$only` picks element 0, `$at: n` picks position n (negative from the\n *   end); both rename the scope key to its singular form per the schema\n * - `$as` renames explicitly and always wins\n * - `$m` adds labeled sibling keys (`indexBy` / `groupBy` / `at`) computed in\n *   a single pass over the scope's data, leaving the original key untouched\n * - nested link scopes shape recursively inside each entity; untouched\n *   subtrees are returned by reference, never copied\n */\n\nimport type { IdbSchema } from '../schema/defineSchema.js'\nimport { singularize } from '../schema/singularize.js'\n\ntype AnyRecord = Record<string, any>\n\ninterface MTransform {\n  indexBy?: string\n  groupBy?: string\n  at?: number\n}\n\n/**\n * The top-level keys a shaped result will carry for a query — the resolved\n * scope keys plus every `$m` sibling label — derived from the query structure\n * alone, no data needed. The client overlay uses this to expose one reactive\n * ref per scope for destructuring.\n */\nexport function resultKeys(query: AnyRecord, schema: IdbSchema): string[] {\n  const keys: string[] = []\n  for (const [key, node] of Object.entries(query)) {\n    if (key === '$$ruleParams')\n      continue\n    const dollar: AnyRecord = (node as AnyRecord)?.$ ?? {}\n    const pick = dollar.$only === true || typeof dollar.$at === 'number'\n    keys.push(\n      typeof dollar.$as === 'string'\n        ? dollar.$as\n        : pick\n          ? resolveSingularKey(key, null, schema)\n          : key,\n    )\n    const m = (node as AnyRecord)?.$m\n    if (m)\n      keys.push(...Object.keys(m))\n  }\n  return keys\n}\n\n/**\n * A schema with a usable `$dux` projection for runtime shaping — the real\n * schema when one is registered, a permissive stub otherwise (singularize\n * 'auto', no declared singulars, no link metadata). Both clients reach for it\n * so a query with no schema still shapes consistently.\n */\nexport function shapingSchema(schema: IdbSchema | undefined): IdbSchema {\n  if (schema)\n    return schema\n  return {\n    entities: {},\n    links: {},\n    rooms: {},\n    $dux: { namespaces: {}, linkSingulars: {}, options: { singularize: 'auto' } },\n  } as unknown as IdbSchema\n}\n\nexport function shapeResult(\n  rawData: AnyRecord | undefined,\n  query: AnyRecord,\n  schema: IdbSchema,\n): AnyRecord {\n  const out: AnyRecord = {}\n  for (const [key, node] of Object.entries(query)) {\n    // `$`-prefixed namespaces ($users, …) are data; only the internal\n    // ruleParams envelope is not a scope.\n    if (key === '$$ruleParams')\n      continue\n    shapeScopeInto(out, rawData?.[key] ?? [], key, node ?? {}, null, key, schema)\n  }\n  return out\n}\n\n/**\n * Shapes one scope into `out`: the resolved scope key, plus any `$m` sibling\n * keys. `parentNs` is the namespace the scope key sits on (`null` for\n * top-level scopes); `ns` is the namespace the scope's entities belong to.\n */\nfunction shapeScopeInto(\n  out: AnyRecord,\n  raw: unknown,\n  key: string,\n  node: AnyRecord,\n  parentNs: string | null,\n  ns: string,\n  schema: IdbSchema,\n): void {\n  const dollar: AnyRecord = node.$ ?? {}\n  const value = shapeChildren(raw, node, ns, schema)\n\n  if (node.$m && Array.isArray(value))\n    applyMSiblings(out, value, node.$m as Record<string, MTransform>)\n\n  const pick = dollar.$only === true ? 0 : typeof dollar.$at === 'number' ? dollar.$at : null\n  const picked = pick !== null && Array.isArray(value) ? value.at(pick) : value\n  const outputKey = typeof dollar.$as === 'string'\n    ? dollar.$as\n    : pick !== null\n      ? resolveSingularKey(key, parentNs, schema)\n      : key\n  out[outputKey] = picked\n}\n\n/**\n * Recursively shapes the nested link scopes inside each entity of a scope\n * whose entities belong to `ns`. Entities are copied only along paths that\n * actually change.\n */\nfunction shapeChildren(\n  raw: unknown,\n  node: AnyRecord,\n  ns: string,\n  schema: IdbSchema,\n): unknown {\n  const childKeys = Object.keys(node).filter(k => k !== '$' && k !== '$m')\n  if (childKeys.length === 0 || !childKeys.some(k => subtreeReshapes(node[k])))\n    return raw\n\n  const shapeEntity = (entity: unknown): unknown => {\n    if (entity === null || typeof entity !== 'object')\n      return entity\n    const copy: AnyRecord = { ...entity }\n    for (const childKey of childKeys) {\n      const childRaw = copy[childKey]\n      delete copy[childKey]\n      const childNs = linkTarget(schema, ns, childKey)\n      shapeScopeInto(copy, childRaw, childKey, node[childKey] ?? {}, ns, childNs, schema)\n    }\n    return copy\n  }\n\n  return Array.isArray(raw) ? raw.map(shapeEntity) : shapeEntity(raw)\n}\n\n/** The namespace a link label on `ns` points to, via the enriched entity defs. */\nfunction linkTarget(schema: IdbSchema, ns: string, label: string): string {\n  return schema.entities[ns]?.links?.[label]?.entityName ?? label\n}\n\n/** Whether a subtree contains any directive that changes the data shape. */\nfunction subtreeReshapes(node: unknown): boolean {\n  if (node === null || typeof node !== 'object')\n    return false\n  const record = node as AnyRecord\n  if (record.$m !== undefined)\n    return true\n  const dollar = record.$\n  if (dollar && (dollar.$only !== undefined || dollar.$at !== undefined || dollar.$as !== undefined))\n    return true\n  return Object.keys(record).some(k => k !== '$' && k !== '$m' && subtreeReshapes(record[k]))\n}\n\n/** All `$m` projections for one scope, computed in a single pass. */\nfunction applyMSiblings(\n  out: AnyRecord,\n  entities: AnyRecord[],\n  transforms: Record<string, MTransform>,\n): void {\n  const labels = Object.entries(transforms)\n  for (const [label, transform] of labels) {\n    out[label] = typeof transform.at === 'number'\n      ? entities.at(transform.at)\n      : {}\n  }\n  for (const entity of entities) {\n    for (const [label, transform] of labels) {\n      if (transform.indexBy !== undefined) {\n        const indexValue = entity[transform.indexBy]\n        if (indexValue !== null && indexValue !== undefined)\n          out[label][String(indexValue)] = entity\n      }\n      else if (transform.groupBy !== undefined) {\n        const groupValue = entity[transform.groupBy]\n        if (groupValue !== null && groupValue !== undefined)\n          (out[label][String(groupValue)] ??= []).push(entity)\n      }\n    }\n  }\n}\n\n/**\n * The singular form of a scope key — declared `singular` first (namespace\n * `singular` for top-level keys, link label `singular` for nested keys), the\n * shared algorithm as the `'auto'` fallback, honoring `options.singularize`.\n */\nfunction resolveSingularKey(\n  key: string,\n  parentNs: string | null,\n  schema: IdbSchema,\n): string {\n  const meta = schema.$dux\n  const mode = meta.options.singularize\n  if (mode === 'off')\n    return key\n  const declared = parentNs === null\n    ? meta.namespaces[key]?.singular\n    : meta.linkSingulars[parentNs]?.[key]\n  if (declared !== undefined)\n    return declared\n  return mode === 'auto' ? singularize(key) : key\n}\n"]}

package/dist/esm/query/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * The query-domain types: the authoring shape (`IdbQuery` and its node
+ * types — also the completion source for `q`/`useQuery` literals), the
+ * type-level shaping mirror (`IdbQueryData`, `IdbQueryEntity`), and the
+ * renamed official types (`IdbQueryPageInfo`, `IdbQueryOptions`, …).
+ */
+import type { Cursor, DataAttrDef, PageInfoResponse, ResolveAttrs } from '@instantdb/core';
+import type { IdbSchema } from '../schema/defineSchema.js';
+import type { AttrsOf, AttrValue, FieldKeys, IndexedFieldKeys, LinkCardinality, LinkLabels, LinkTarget, PrimitiveFieldKeys, UniqueFieldKeys, WireValue } from '../schema/fields.js';
+import type { IdbRegisteredSchema } from '../schema/register.js';
+import type { IdbNamespaceName } from '../schema/types.js';
+import type { Expand, UnionToIntersection } from '../schema/util.js';
+import type { HasPick, ResolvedScopeKey } from './keys.js';
+export type { FieldKeys, IndexedFieldKeys, LinkLabels, LinkTarget, UniqueFieldKeys, WireValue, } from '../schema/fields.js';
+type Depth = readonly unknown[];
+export type MaxHops = 3;
+export type NextHop<D extends Depth> = D['length'] extends MaxHops ? D : [...D, unknown];
+/**
+ * The operator object for one field. Every operator is present so the
+ * completion list and the diagnostic are both intentional: operators the
+ * field doesn't support are typed as the `QERR_*` message explaining why.
+ */
+export interface IdbWhereOps<V, _IsRequired, IsIndexed> {
+    $in?: readonly WireValue<V>[];
+    $not?: WireValue<V>;
+    $ne?: WireValue<V>;
+    $gt?: ComparableValue<V, IsIndexed, '$gt'>;
+    $lt?: ComparableValue<V, IsIndexed, '$lt'>;
+    $gte?: ComparableValue<V, IsIndexed, '$gte'>;
+    $lte?: ComparableValue<V, IsIndexed, '$lte'>;
+    $like?: StringPattern<V, IsIndexed, '$like'>;
+    $ilike?: StringPattern<V, IsIndexed, '$ilike'>;
+    $isNull?: boolean;
+}
+type ComparableValue<V, IsIndexed, Op extends string> = [V] extends [
+    string | number | boolean | Date
+] ? IsIndexed extends true ? WireValue<V> : `QERR_WHERE_OPERATOR_INVALID: Operator ${Op} is only available for indexed fields with a checked type.` : `QERR_WHERE_OPERATOR_INVALID: Operator ${Op} is only available for indexed fields with a checked type.`;
+type StringPattern<V, IsIndexed, Op extends string> = [V] extends [string] ? IsIndexed extends true ? string : `QERR_WHERE_OPERATOR_INVALID: Operator ${Op} is only available for indexed string fields.` : `QERR_WHERE_OPERATOR_INVALID: Operator ${Op} is only available for indexed string fields.`;
+type FieldWhereValue<A> = A extends DataAttrDef<infer V, infer R, infer I, any> ? WireValue<V> | IdbWhereOps<V, R, I> | undefined : never;
+type IdAttr = DataAttrDef<string, false, true, true>;
+/**
+ * The where shape: fields, `id`, link labels (matching the linked entity's
+ * id), one enumerated hop of `label.field` dot-paths, and `and`/`or`.
+ * Deeper dot-paths (up to 3 hops) are accepted via validation rather than
+ * enumerated here. `undefined` values (`$skip`) drop the clause.
+ */
+export type IdbWhereShape<S extends IdbSchema, NS extends string> = {
+    [F in FieldKeys<S, NS>]?: FieldWhereValue<AttrsOf<S, NS>[F]>;
+} & {
+    [L in LinkLabels<S, NS>]?: FieldWhereValue<IdAttr>;
+} & {
+    [P in DotPathsOneHop<S, NS>]?: FieldWhereValue<WhereKeyAttr<S, NS, P>>;
+} & {
+    id?: FieldWhereValue<IdAttr>;
+    and?: readonly IdbWhereShape<S, NS>[];
+    or?: readonly IdbWhereShape<S, NS>[];
+};
+type DotPathsOneHop<S extends IdbSchema, NS extends string> = {
+    [L in LinkLabels<S, NS>]: `${L}.${FieldKeys<S, LinkTarget<S, NS, L>> | 'id'}`;
+}[LinkLabels<S, NS>];
+/** Resolve the attr def a where key addresses — fields, id, labels, dot-paths ≤ 3 hops. */
+export type WhereKeyAttr<S extends IdbSchema, NS extends string, K extends string, D extends Depth = []> = K extends FieldKeys<S, NS> ? AttrsOf<S, NS>[K] : K extends 'id' ? IdAttr : K extends `${infer L}.${infer Rest}` ? L extends LinkLabels<S, NS> ? D['length'] extends MaxHops ? never : WhereKeyAttr<S, LinkTarget<S, NS, L>, Rest, NextHop<D>> : never : K extends LinkLabels<S, NS> ? IdAttr : never;
+/** Direct indexed fields and `serverCreatedAt` — ordering never traverses links. */
+export type IdbOrderShape<S extends IdbSchema, NS extends string> = {
+    [K in IndexedFieldKeys<S, NS> | 'serverCreatedAt']?: 'asc' | 'desc';
+};
+/** The `fields` array type for a namespace. */
+export type IdbQueryFields<NS extends IdbNamespaceName<S>, S extends IdbSchema = IdbRegisteredSchema> = (FieldKeys<S, NS> | 'id')[];
+/**
+ * One `$m` transform:
+ * - `indexBy` — a unique field (or `id`); yields `Record<string, Entity>`
+ * - `groupBy` — a primitive field; yields `Record<string, Entity[]>`
+ * - `at` — a position (negative from the end); yields `Entity | undefined`
+ */
+export type IdbMTransform<S extends IdbSchema, NS extends string> = {
+    indexBy: UniqueFieldKeys<S, NS> | 'id';
+} | {
+    groupBy: PrimitiveFieldKeys<S, NS>;
+} | {
+    at: number;
+};
+export type IdbMBlock<S extends IdbSchema, NS extends string> = Record<string, IdbMTransform<S, NS>>;
+interface IdbDuxDollarKeys {
+    /** Coerce this scope to `Entity | undefined` and singularize its key. */
+    $only?: true;
+    /** Pick the element at this position (negative from the end); singularizes the key. */
+    $at?: number;
+    /** Rename this scope's result key explicitly — always wins. */
+    $as?: string;
+}
+interface IdbPaginationKeys {
+    last?: number;
+    first?: number;
+    offset?: number;
+    after?: Cursor;
+    afterInclusive?: boolean;
+    before?: Cursor;
+    beforeInclusive?: boolean;
+}
+export type IdbDollar<S extends IdbSchema, NS extends string, TopLevel extends boolean> = {
+    where?: IdbWhereShape<S, NS>;
+    order?: IdbOrderShape<S, NS>;
+    fields?: readonly (FieldKeys<S, NS> | 'id')[];
+    limit?: number;
+} & IdbDuxDollarKeys & (TopLevel extends true ? IdbPaginationKeys : {});
+/** One scope of a query: `$`, `$m`, and nested link labels (3 hops, then open). */
+export type IdbQueryNode<S extends IdbSchema, NS extends string, D extends Depth = [], TopLevel extends boolean = false> = D['length'] extends MaxHops ? Record<string, any> : {
+    $?: IdbDollar<S, NS, TopLevel>;
+    $m?: IdbMBlock<S, NS>;
+} & {
+    [L in LinkLabels<S, NS>]?: IdbQueryNode<S, LinkTarget<S, NS, L>, NextHop<D>>;
+};
+/**
+ * The valid-query-object type — handy for function params. Authoring
+ * completions for `q`/`useQuery` literals come from this shape; per-call
+ * validation is `IdbValidQuery` (`validation.ts`).
+ */
+export type IdbQuery<S extends IdbSchema = IdbRegisteredSchema> = {
+    [NS in IdbNamespaceName<S>]?: IdbQueryNode<S, NS, [], true>;
+};
+/** The subquery shape for one namespace — what `IdbQueryEntity` accepts. */
+export type IdbQuerySubquery<NS extends IdbNamespaceName<S>, S extends IdbSchema = IdbRegisteredSchema> = IdbQueryNode<S, NS>;
+type EntityFields<S extends IdbSchema, NS extends string, Node> = Node extends {
+    $: {
+        fields: infer F extends readonly string[];
+    };
+} ? Pick<ResolveAttrs<S['entities'], NS, false>, Exclude<F[number], 'id'> & keyof ResolveAttrs<S['entities'], NS, false>> : ResolveAttrs<S['entities'], NS, false>;
+type ChildKeys<Node> = Exclude<keyof Node & string, '$' | '$m'>;
+type ShapedChildren<S extends IdbSchema, NS extends string, Node> = {
+    [L in ChildKeys<Node> as L extends LinkLabels<S, NS> ? ResolvedScopeKey<S, NS, L, Node[L]> : never]: L extends LinkLabels<S, NS> ? ChildData<S, NS, L, Node[L]> : never;
+};
+type ChildData<S extends IdbSchema, NS extends string, L extends LinkLabels<S, NS>, Node> = HasPick<Node> extends true ? ShapedEntity<S, LinkTarget<S, NS, L>, Node> | undefined : LinkCardinality<S, NS, L> extends 'one' ? ShapedEntity<S, LinkTarget<S, NS, L>, Node> | undefined : ShapedEntity<S, LinkTarget<S, NS, L>, Node>[];
+type MValue<T, E> = T extends {
+    indexBy: any;
+} ? Record<string, E> : T extends {
+    groupBy: any;
+} ? Record<string, E[]> : T extends {
+    at: number;
+} ? E | undefined : never;
+/** The `$m` sibling keys a scope contributes beside its own result key. */
+type MSiblings<S extends IdbSchema, NS extends string, Node> = Node extends {
+    $m: infer M;
+} ? {
+    -readonly [Label in keyof M]: MValue<M[Label], ShapedEntity<S, NS, Node>>;
+} : {};
+type ChildrenMSiblings<S extends IdbSchema, NS extends string, Node> = [
+    ChildKeys<Node>
+] extends [never] ? {} : UnionToIntersection<{
+    [L in ChildKeys<Node>]: L extends LinkLabels<S, NS> ? MSiblings<S, LinkTarget<S, NS, L>, Node[L]> : {};
+}[ChildKeys<Node>]>;
+type ShapedEntity<S extends IdbSchema, NS extends string, Node> = Expand<{
+    id: string;
+} & EntityFields<S, NS, Node> & ShapedChildren<S, NS, Node> & ChildrenMSiblings<S, NS, Node>>;
+/**
+ * An entity shaped by query syntax — `$` and `$m` fully supported, including
+ * `$: { fields }`.
+ */
+export type IdbQueryEntity<NS extends IdbNamespaceName<S>, Subquery = {}, S extends IdbSchema = IdbRegisteredSchema> = ShapedEntity<S, NS, Subquery>;
+type TopScopeData<S extends IdbSchema, NS extends string, Node> = HasPick<Node> extends true ? ShapedEntity<S, NS, Node> | undefined : ShapedEntity<S, NS, Node>[];
+type TopMSiblings<Q, S extends IdbSchema> = [keyof Q] extends [never] ? {} : UnionToIntersection<{
+    [K in keyof Q & string]: K extends IdbNamespaceName<S> ? MSiblings<S, K, Q[K]> : {};
+}[keyof Q & string]>;
+/**
+ * The shaped data for a query — the exact shape `useQuery`, `queryOnce`, and
+ * `adminDb.query` deliver: normalized arrays, `$only`/`$at` coercion,
+ * singularized/`$as` keys, `$m` siblings.
+ */
+export type IdbQueryData<Q, S extends IdbSchema = IdbRegisteredSchema> = Expand<{
+    [K in keyof Q & string as K extends IdbNamespaceName<S> ? ResolvedScopeKey<S, null, K, Q[K]> : never]: K extends IdbNamespaceName<S> ? TopScopeData<S, K, Q[K]> : never;
+} & TopMSiblings<Q, S>>;
+type NamespaceRuleParams<RP> = RP extends Record<string, DataAttrDef<any, any, any, any>> ? {
+    [K in keyof RP]?: AttrValue<RP[K]>;
+} : {};
+/**
+ * Every rule param declared in the schema, merged and optional — the
+ * query-level companion to the per-namespace tx typing.
+ */
+export type IdbSchemaRuleParams<S extends IdbSchema = IdbRegisteredSchema> = Expand<UnionToIntersection<{
+    [NS in keyof S['$dux']['namespaces']]: NamespaceRuleParams<S['$dux']['namespaces'][NS]['ruleParams']>;
+}[keyof S['$dux']['namespaces']]>>;
+/** Per-call query options — `ruleParams` typed from the schema. */
+export interface IdbQueryOptions<S extends IdbSchema = IdbRegisteredSchema> {
+    ruleParams: IdbSchemaRuleParams<S>;
+}
+/** Pagination cursors, keyed by the query's top-level namespace keys. */
+export type IdbQueryPageInfo<Q = Record<string, unknown>> = PageInfoResponse<Q>;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/query/types.d.ts.map

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

package/dist/esm/query/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map