@x12i/catalox 5.1.3 → 5.9.6

package/dist/src/contracts/presentation-binding.d.ts

@@ -1,116 +0,0 @@
-import type { CatalogDescriptor } from "./descriptors.js";
-import type { CatalogPresentationSpec } from "./presentation.js";
-import type { CatalogCustomRenderer, CustomRendererEntry } from "./render-map.js";
-import type { CatalogDesignObjectRecord, CatalogDesignRef, CatalogDesignScope } from "./design-objects.js";
-import type { CatalogRendererMode, CatalogRendererRole, CatalogRendererSnippetRecord } from "./renderer-snippets.js";
-export type CatalogPresentationStrategy = "native-auto" | "template" | "custom-renderer";
-export type CatalogPresentationScope = {
-    catalogId?: string;
-    catalogType?: string;
-};
-export type CatalogPresentationProfileRecord = {
-    profileId: string;
-    scope: CatalogPresentationScope;
-    /**
-     * Declarative presentation hints. If present, can override/augment descriptor presentationSpec.
-     */
-    presentationSpec?: CatalogPresentationSpec;
-    /**
-     * Optional template assignment defaults (host-defined). Stored on the profile so multiple catalogs
-     * can share a template selection without copying it into every descriptor.
-     */
-    templates?: CatalogPresentationSpec["templates"];
-    /**
-     * Optional custom renderer defaults shared across catalogs.
-     */
-    customRenderer?: CatalogCustomRenderer;
-    /**
-     * Optional design refs (tokens/branding/content) that apply under this scope.
-     */
-    designRefs?: CatalogDesignRef[];
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-};
-export type ResolveCatalogPresentationBindingInput = {
-    descriptor: CatalogDescriptor | null;
-    /**
-     * Optional presentation profiles; caller can provide a catalog-scoped profile and/or type-scoped profile.
-     */
-    profiles?: CatalogPresentationProfileRecord[];
-    role: Exclude<CatalogRendererRole, "core">;
-    mode?: CatalogRendererMode;
-    /**
-     * Current list-like display context. Used when selecting templates for list/grid/cards.
-     */
-    displayContext?: "grid" | "list" | "cards" | "form";
-    /**
-     * Optional snippet record resolved by the caller (Catalox can fetch it when wired).
-     * This is metadata only; evaluation is a host concern.
-     */
-    snippet?: CatalogRendererSnippetRecord | null;
-    /**
-     * Optional design objects available to match/merge.
-     */
-    designObjects?: CatalogDesignObjectRecord[];
-    /**
-     * Runtime scope used to select design objects, if requested.
-     */
-    designScope?: CatalogDesignScope;
-};
-export type ResolvedCatalogPresentationBinding = {
-    strategy: CatalogPresentationStrategy;
-    /**
-     * The effective presentation spec to use for native automatic or as a supplement to templates/custom renderers.
-     */
-    presentationSpec?: CatalogPresentationSpec;
-    /**
-     * The resolved template assignment, when strategy is "template".
-     */
-    template?: {
-        templateId: string;
-        props?: Record<string, unknown>;
-        designRefs?: CatalogDesignRef[];
-        metadata?: Record<string, unknown>;
-    };
-    /**
-     * The resolved custom renderer entry, when strategy is "custom-renderer".
-     */
-    customRenderer?: {
-        entry: CustomRendererEntry;
-        snippet?: CatalogRendererSnippetRecord | null;
-    };
-    /**
-     * Merged opaque design payload and provenance.
-     */
-    design?: {
-        merged: Record<string, unknown>;
-        contributingDesignIds: string[];
-    };
-    /**
-     * Helpful debug info for hosts (non-authoritative).
-     */
-    debug?: {
-        fromCatalogId?: string;
-        fromCatalogType?: string;
-        usedProfileIds?: string[];
-    };
-};
-/**
- * Lightweight helper to merge JSON objects in order (later wins).
- * This is intentionally shallow; hosts can implement deep merge if they want.
- */
-export declare function mergeDesignObjects(objects: CatalogDesignObjectRecord[]): {
-    merged: Record<string, unknown>;
-    contributingDesignIds: string[];
-};
-/**
- * Resolve a catalog presentation binding for a given role/mode without rendering anything.
- *
- * Precedence:
- * - catalog-scoped profiles override catalog-type-scoped profiles
- * - `customRenderer` wins over templates, templates win over native-auto
- * - design refs are applied (explicit refs first), then optionally scope-matched design objects
- */
-export declare function resolveCatalogPresentationBinding(input: ResolveCatalogPresentationBindingInput): ResolvedCatalogPresentationBinding;
-//# sourceMappingURL=presentation-binding.d.ts.map

package/dist/src/contracts/presentation-binding.d.ts.map

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

package/dist/src/contracts/presentation-binding.js

@@ -1,215 +0,0 @@
-import { resolveCustomRendererEntry } from "./custom-renderer-resolve.js";
-function isNonEmptyString(v) {
-    return typeof v === "string" && v.trim().length > 0;
-}
-function scopeMatches(target, candidate) {
-    if (!target)
-        return true;
-    if (!candidate)
-        return false;
-    // Every axis provided in target must match candidate.
-    if (target.storeId != null && String(candidate.storeId ?? "") !== String(target.storeId))
-        return false;
-    if (target.appId != null && String(candidate.appId ?? "") !== String(target.appId))
-        return false;
-    if (target.accountId != null && String(candidate.accountId ?? "") !== String(target.accountId))
-        return false;
-    if (target.agentId != null && String(candidate.agentId ?? "") !== String(target.agentId))
-        return false;
-    return true;
-}
-function scopeSpecificity(s) {
-    if (!s)
-        return 0;
-    return Number(Boolean(s.storeId)) + Number(Boolean(s.appId)) + Number(Boolean(s.accountId)) + Number(Boolean(s.agentId));
-}
-function dedupeByDesignId(objs) {
-    const seen = new Set();
-    const out = [];
-    for (const o of objs) {
-        const id = String(o?.designId ?? "");
-        if (!id)
-            continue;
-        if (seen.has(id))
-            continue;
-        seen.add(id);
-        out.push(o);
-    }
-    return out;
-}
-function pickTemplateAssignment(params) {
-    const templates = params.templates ?? [];
-    if (!templates.length)
-        return null;
-    // Merge semantics: core -> role -> role+mode, optionally filtering by displayContext when provided.
-    const candidates = templates.filter((t) => {
-        if (!t || typeof t !== "object")
-            return false;
-        if (!isNonEmptyString(t.templateId))
-            return false;
-        if (params.displayContext && t.displayContext && String(t.displayContext) !== String(params.displayContext))
-            return false;
-        return true;
-    });
-    const core = candidates.find((t) => t.role === "core" && t.mode == null);
-    const roleOnly = candidates.find((t) => t.role === params.role && t.mode == null);
-    const roleMode = params.mode ? candidates.find((t) => t.role === params.role && t.mode === params.mode) : undefined;
-    if (!core && !roleOnly && !roleMode)
-        return null;
-    const merge = (base, override) => {
-        const out = { ...base, ...override };
-        // Merge props/designRefs shallowly (later wins but retains previous keys).
-        if (base?.props || override?.props)
-            out.props = { ...(base?.props ?? {}), ...(override?.props ?? {}) };
-        if (base?.designRefs || override?.designRefs)
-            out.designRefs = [...(base?.designRefs ?? []), ...(override?.designRefs ?? [])];
-        return out;
-    };
-    let out = { templateId: "", props: undefined, designRefs: undefined, metadata: undefined };
-    if (core)
-        out = merge(out, core);
-    if (roleOnly)
-        out = merge(out, roleOnly);
-    if (roleMode)
-        out = merge(out, roleMode);
-    if (!isNonEmptyString(out.templateId))
-        return null;
-    return { templateId: out.templateId, props: out.props, designRefs: out.designRefs, metadata: out.metadata };
-}
-function deriveNativeAutoPresentationSpec(descriptor) {
-    // v1: use explicit presentationSpec when present; derivation can be evolved later.
-    return descriptor?.presentationSpec;
-}
-/**
- * Lightweight helper to merge JSON objects in order (later wins).
- * This is intentionally shallow; hosts can implement deep merge if they want.
- */
-export function mergeDesignObjects(objects) {
-    const merged = {};
-    const contributingDesignIds = [];
-    for (const o of objects) {
-        if (!o || typeof o !== "object")
-            continue;
-        if (!o.designId)
-            continue;
-        contributingDesignIds.push(String(o.designId));
-        Object.assign(merged, o.design ?? {});
-    }
-    return { merged, contributingDesignIds };
-}
-/**
- * Resolve a catalog presentation binding for a given role/mode without rendering anything.
- *
- * Precedence:
- * - catalog-scoped profiles override catalog-type-scoped profiles
- * - `customRenderer` wins over templates, templates win over native-auto
- * - design refs are applied (explicit refs first), then optionally scope-matched design objects
- */
-export function resolveCatalogPresentationBinding(input) {
-    const descriptor = input.descriptor ?? null;
-    const catalogId = descriptor?.catalogId ? String(descriptor.catalogId) : undefined;
-    const catalogType = descriptor?.catalogType ? String(descriptor.catalogType) : undefined;
-    const profiles = input.profiles ?? [];
-    const catalogProfiles = catalogId ? profiles.filter((p) => p?.scope?.catalogId && String(p.scope.catalogId) === catalogId) : [];
-    const typeProfiles = catalogType ? profiles.filter((p) => p?.scope?.catalogType && String(p.scope.catalogType) === catalogType) : [];
-    const usedProfiles = [...catalogProfiles, ...typeProfiles];
-    const mergedCustomRenderer = (() => {
-        const fromProfiles = usedProfiles.map((p) => p.customRenderer).filter(Boolean);
-        const fromDescriptor = descriptor?.customRenderer;
-        const renderers = [];
-        for (const cr of [...fromProfiles, ...(fromDescriptor ? [fromDescriptor] : [])]) {
-            for (const e of cr.renderers ?? [])
-                renderers.push(e);
-        }
-        return renderers.length ? { renderers } : null;
-    })();
-    const mergedTemplates = (() => {
-        const out = [];
-        for (const p of usedProfiles)
-            for (const t of (p.templates ?? []))
-                out.push(t);
-        const dTemplates = (descriptor?.presentationSpec?.templates ?? []);
-        for (const t of dTemplates)
-            out.push(t);
-        return out.length ? out : undefined;
-    })();
-    const presentationSpec = (() => {
-        // Profile can override/augment; v1 chooses descriptor.spec if present else first profile.spec.
-        const d = descriptor?.presentationSpec;
-        if (d)
-            return d;
-        const p = usedProfiles.find((x) => x.presentationSpec)?.presentationSpec;
-        return p;
-    })();
-    const resolvedCustom = resolveCustomRendererEntry({
-        customRenderer: mergedCustomRenderer ?? undefined,
-        role: input.role,
-        ...(input.mode ? { mode: input.mode } : {}),
-    });
-    const resolvedTemplate = !resolvedCustom
-        ? pickTemplateAssignment({
-            templates: mergedTemplates,
-            role: input.role,
-            ...(input.mode ? { mode: input.mode } : {}),
-            ...(input.displayContext ? { displayContext: input.displayContext } : {}),
-        })
-        : null;
-    const strategy = resolvedCustom ? "custom-renderer" : resolvedTemplate ? "template" : "native-auto";
-    // Design resolution
-    const allDesignRefs = [
-        ...(usedProfiles.flatMap((p) => p.designRefs ?? []) ?? []),
-        ...(descriptor?.presentationSpec?.designRefs ?? []),
-        ...(resolvedTemplate?.designRefs ?? []),
-    ].filter(Boolean);
-    const availableDesigns = (input.designObjects ?? []).filter((d) => d && typeof d === "object" && d.design && typeof d.design === "object" && !Array.isArray(d.design));
-    const explicitlyPicked = dedupeByDesignId(allDesignRefs
-        .map((r) => {
-        if (!r?.designId)
-            return null;
-        const id = String(r.designId);
-        return availableDesigns.find((d) => String(d.designId) === id) ?? null;
-    })
-        .filter(Boolean));
-    const scopePicked = (() => {
-        if (!input.designScope)
-            return [];
-        // Match designs by runtime scope and sort by specificity (broad -> specific) so specific overrides last.
-        const matches = availableDesigns.filter((d) => scopeMatches(input.designScope, d.scope));
-        matches.sort((a, b) => scopeSpecificity(a.scope) - scopeSpecificity(b.scope));
-        return dedupeByDesignId(matches);
-    })();
-    const contributing = dedupeByDesignId([...explicitlyPicked, ...scopePicked]);
-    const design = contributing.length ? mergeDesignObjects(contributing) : undefined;
-    return {
-        strategy,
-        ...(() => {
-            const spec = strategy === "native-auto" ? deriveNativeAutoPresentationSpec(descriptor) ?? presentationSpec : presentationSpec;
-            return spec != null ? { presentationSpec: spec } : {};
-        })(),
-        ...(resolvedTemplate
-            ? {
-                template: {
-                    templateId: resolvedTemplate.templateId,
-                    ...(resolvedTemplate.props ? { props: resolvedTemplate.props } : {}),
-                    ...(resolvedTemplate.designRefs ? { designRefs: resolvedTemplate.designRefs } : {}),
-                    ...(resolvedTemplate.metadata ? { metadata: resolvedTemplate.metadata } : {}),
-                },
-            }
-            : {}),
-        ...(resolvedCustom
-            ? {
-                customRenderer: {
-                    entry: resolvedCustom,
-                    ...(input.snippet !== undefined ? { snippet: input.snippet } : {}),
-                },
-            }
-            : {}),
-        ...(design ? { design } : {}),
-        debug: {
-            ...(catalogId ? { fromCatalogId: catalogId } : {}),
-            ...(catalogType ? { fromCatalogType: catalogType } : {}),
-            ...(usedProfiles.length ? { usedProfileIds: usedProfiles.map((p) => p.profileId) } : {}),
-        },
-    };
-}
-//# sourceMappingURL=presentation-binding.js.map

package/dist/src/contracts/presentation-binding.js.map

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

package/dist/src/contracts/presentation.d.ts

@@ -1,225 +0,0 @@
-import type { FieldSource } from "./field-source.js";
-import type { CatalogDesignRef } from "./design-objects.js";
-import type { CatalogRendererMode, CatalogRendererRole } from "./renderer-snippets.js";
-export type CatalogDisplayContext = "grid" | "list" | "cards" | "form";
-export type CatalogUIMode = "view" | "edit";
-export type CatalogPresentationDensity = "compact" | "default" | "comfortable";
-export type FieldRenderHint = "text" | "number" | "currency" | "percentage" | "date" | "datetime" | "relative-time" | "badge" | "tag" | "status-dot" | "avatar" | "image" | "thumbnail" | "link" | "email" | "phone" | "progress" | "rating" | "code" | "markdown" | "color" | "boolean" | "json" | "key-value" | "list";
-export type FieldEditInputType = "text" | "textarea" | "number" | "select" | "multi-select" | "date" | "datetime" | "toggle" | "color" | "slider" | "autocomplete" | "tags" | "rich-text" | "code" | "file" | "hidden";
-export type EditFieldValidationSpec = {
-    required?: boolean;
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    patternMessage?: string;
-};
-export type EditFieldSpec = {
-    enabled?: boolean;
-    inputType: FieldEditInputType;
-    placeholder?: string;
-    helperText?: string;
-    /**
-     * Dot-path to another field. Used by UIs to recompute this field's source
-     * when the dependency changes (cascading selects).
-     */
-    dependsOn?: string;
-    validation?: EditFieldValidationSpec;
-    metadata?: Record<string, unknown>;
-};
-export type FieldPresentation = {
-    /**
-     * Dot-path into item.data.
-     */
-    fieldPath: string;
-    label?: string;
-    description?: string;
-    renderHint?: FieldRenderHint;
-    format?: string;
-    emptyText?: string;
-    truncate?: number;
-    copyable?: boolean;
-    colorMap?: Record<string, string>;
-    source?: FieldSource;
-    edit?: EditFieldSpec;
-    metadata?: Record<string, unknown>;
-};
-export type GridColumnSpec = {
-    fieldPath: string;
-    width?: "auto" | "sm" | "md" | "lg" | "xl" | "fill";
-    pinned?: "left" | "right";
-    sortable?: boolean;
-    metadata?: Record<string, unknown>;
-};
-export type GridSpec = {
-    columns: GridColumnSpec[];
-    rowHeight?: CatalogPresentationDensity;
-    editableInline?: boolean;
-    showRowNumbers?: boolean;
-    metadata?: Record<string, unknown>;
-};
-export type ListSpec = {
-    primaryField: string;
-    secondaryField?: string;
-    tertiaryField?: string;
-    trailingField?: string;
-    avatar?: string;
-    metadata?: Record<string, unknown>;
-};
-export type CardsSpec = {
-    title: string;
-    subtitle?: string;
-    image?: string;
-    badge?: string;
-    body?: string[];
-    footer?: string[];
-    size?: "sm" | "md" | "lg";
-    aspectRatio?: "square" | "landscape" | "portrait";
-    metadata?: Record<string, unknown>;
-};
-export type FormFieldPlacement = {
-    fieldPath: string;
-    span?: 1 | 2 | 3 | 4;
-    viewOnly?: boolean;
-    editOnly?: boolean;
-    metadata?: Record<string, unknown>;
-};
-export type FormSection = {
-    key: string;
-    label: string;
-    description?: string;
-    fields: FormFieldPlacement[];
-    collapsible?: boolean;
-    collapsed?: boolean;
-    columns?: 1 | 2 | 3 | 4;
-    metadata?: Record<string, unknown>;
-};
-export type FormTab = {
-    key: string;
-    label: string;
-    icon?: string;
-    /**
-     * Ordered section keys (must exist in FormSpec.sections).
-     */
-    sections: string[];
-    badge?: {
-        fieldPath: string;
-    };
-    metadata?: Record<string, unknown>;
-};
-export type FormHeaderFields = {
-    title: string;
-    subtitle?: string;
-    status?: string;
-    avatar?: string;
-    metadata?: Record<string, unknown>;
-};
-export type FormSpec = {
-    sections: FormSection[];
-    tabs?: FormTab[];
-    columns?: 1 | 2 | 3 | 4;
-    headerFields?: FormHeaderFields;
-    actionsPlacement?: "header" | "footer" | "both";
-    metadata?: Record<string, unknown>;
-};
-export type EmptyStateSpec = {
-    title: string;
-    description?: string;
-    icon?: string;
-    metadata?: Record<string, unknown>;
-};
-export type RelationSectionSpec = {
-    /**
-     * Optional allowlist of relation types to include in this section.
-     * If omitted, hosts may show all relations (or those declared on the descriptor).
-     */
-    relationTypes?: string[];
-    label: string;
-    description?: string;
-    /**
-     * When true, hosts should emphasize this section in create/edit flows.
-     * Validation enforcement comes from `CatalogDescriptor.relationRules`.
-     */
-    required?: boolean;
-    /**
-     * Display hint: show relation count in the section header.
-     */
-    showCount?: boolean;
-    metadata?: Record<string, unknown>;
-};
-export type RelationsPresentationSpec = {
-    /**
-     * Optional ordered sections for rendering relations on item/detail surfaces.
-     */
-    sections?: RelationSectionSpec[];
-    /**
-     * Display hint for list/grid/cards surfaces (host-defined).
-     */
-    showInSummary?: boolean;
-    metadata?: Record<string, unknown>;
-};
-export type CatalogPresentationSpec = {
-    /**
-     * Per-field rendering + edit semantics (view + edit in one place).
-     */
-    fields: FieldPresentation[];
-    defaultContext?: Exclude<CatalogDisplayContext, "form">;
-    allowContextSwitch?: boolean;
-    grid?: GridSpec;
-    list?: ListSpec;
-    cards?: CardsSpec;
-    form?: FormSpec;
-    density?: CatalogPresentationDensity;
-    pageSize?: number;
-    pageSizeOptions?: number[];
-    showSearch?: boolean;
-    searchFields?: string[];
-    emptyState?: EmptyStateSpec;
-    /**
-     * Optional template assignments (host-defined). This is a declarative, non-code way
-     * to select presentation. Rendering is performed by the host presentation layer.
-     */
-    templates?: CatalogPresentationTemplateAssignment[];
-    /**
-     * Optional design references to scoped design objects (tokens/branding/content).
-     * Payloads remain opaque to Catalox.
-     */
-    designRefs?: CatalogDesignRef[];
-    /**
-     * Optional declarative presentation hints for item relations (links).
-     * Actual enforcement is driven by `CatalogDescriptor.relationRules`.
-     */
-    relations?: RelationsPresentationSpec;
-    metadata?: Record<string, unknown>;
-};
-export type CatalogPresentationTemplateAssignment = {
-    /**
-     * Matches the same renderer surface roles as custom renderers.
-     * Use "core" to express defaults that hosts may merge.
-     */
-    role: CatalogRendererRole;
-    /**
-     * Optional mode variant. Only meaningful for list/grid/item roles.
-     */
-    mode?: CatalogRendererMode;
-    /**
-     * Optional displayContext override used by list-like surfaces.
-     * If omitted, the host decides based on the active map context.
-     */
-    displayContext?: Exclude<CatalogDisplayContext, "form">;
-    /**
-     * Host-owned template identifier (not an import path).
-     */
-    templateId: string;
-    /**
-     * Static JSON props passed to the template by the host.
-     */
-    props?: Record<string, unknown>;
-    /**
-     * Optional design refs specifically for this template assignment.
-     */
-    designRefs?: CatalogDesignRef[];
-    metadata?: Record<string, unknown>;
-};
-//# sourceMappingURL=presentation.d.ts.map

package/dist/src/contracts/presentation.d.ts.map

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

package/dist/src/contracts/presentation.js

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

package/dist/src/contracts/presentation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../../src/contracts/presentation.ts"],"names":[],"mappings":""}

package/dist/src/contracts/query.d.ts

@@ -1,10 +0,0 @@
-export type CatalogQueryCapabilities = {
-    filterableFields: string[];
-    sortableFields: string[];
-    defaultSort?: {
-        field: string;
-        direction: "asc" | "desc";
-    };
-    supportedOperators?: Record<string, Array<"eq" | "neq" | "in" | "contains" | "gt" | "gte" | "lt" | "lte">>;
-};
-//# sourceMappingURL=query.d.ts.map

package/dist/src/contracts/query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/contracts/query.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG;IACrC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;KAC3B,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,CACzB,MAAM,EACN,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,CACtE,CAAC;CACH,CAAC"}

package/dist/src/contracts/query.js

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

package/dist/src/contracts/query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/contracts/query.ts"],"names":[],"mappings":""}