@elytracms/studio 0.0.1

package/dist/lib/references/impact.d.ts

@@ -0,0 +1,64 @@
+import type { CollectionDef, DocumentRef, RelationFieldDef } from '@elytracms/cms-core';
+import type { ReferenceEntryView } from './reference-model';
+/**
+ * Pure impact model for the EC-173 safe-unpublish/delete flows: given the
+ * inbound reference entries of one or more target documents (the EC-172 panel
+ * views), compute what *breaks* when the action proceeds and what *blocks* it
+ * outright (strict relation fields). No data fetching, no React — fully
+ * deterministic and node-testable, like `reference-model.ts`.
+ *
+ * Semantics (weak by default, vision 3.6):
+ * - **unpublish** breaks only the *published* variant of an entry — a
+ *   draft-only reference never serves the published site, so it neither
+ *   counts nor blocks.
+ * - **delete** breaks both variants — the stored value dangles either way.
+ * - An entry **blocks** when its holding field is a relation declared
+ *   `strict: true` in the schema (and, for unpublish, it is published).
+ * - Entries whose *source* is itself among the acted-on documents are
+ *   excluded: a reference between two documents deleted/unpublished together
+ *   does not survive the action, so it cannot break.
+ */
+export type ReferenceAction = 'unpublish' | 'delete';
+/** Does this entry break (dangle / fall back) when `action` proceeds? */
+export declare function entryBreaksOnAction(entry: ReferenceEntryView, action: ReferenceAction): boolean;
+/** The relation field holding a document-sourced relation entry, if resolvable. */
+export declare function relationFieldOfEntry(collections: readonly CollectionDef[], entry: ReferenceEntryView): RelationFieldDef | undefined;
+/** Does this entry *block* the action (strict opt-in, EC-173)? */
+export declare function entryBlocksAction(collections: readonly CollectionDef[], entry: ReferenceEntryView, action: ReferenceAction): boolean;
+/** The impact of one action on one target document. */
+export interface DocumentReferenceImpact {
+    ref: DocumentRef;
+    /** Inbound entries that will break (fallbacks + validation issues). */
+    broken: ReferenceEntryView[];
+    /** The subset held by strict relation fields — these block the action. */
+    blocking: ReferenceEntryView[];
+}
+/** The aggregate impact of one action over a set of target documents. */
+export interface ReferenceImpact {
+    action: ReferenceAction;
+    documents: DocumentReferenceImpact[];
+    /** Sum of `broken` across documents ("M inbound references will break"). */
+    totalBroken: number;
+    totalBlocking: number;
+}
+/**
+ * Build the impact of `action` over `targets` from their raw inbound entry
+ * views (keyed by `documentKey`). Sources that are themselves targets are
+ * excluded — they do not survive the action.
+ */
+export declare function buildReferenceImpact(collections: readonly CollectionDef[], action: ReferenceAction, targets: readonly {
+    ref: DocumentRef;
+    inbound: readonly ReferenceEntryView[];
+}[]): ReferenceImpact;
+/**
+ * Impact of deleting an ASSET (EC-202), reusing the document break/block model.
+ * A delete dangles EVERY inbound reference (`delete` breaks both variants), and
+ * nothing *blocks*: assets are held by `asset` fields / `asset`-typed props,
+ * never by `strict: true` relation fields, so the asset path has no block
+ * concept — it is always weak-by-default. Returns the same `{ broken, blocking }`
+ * shape the shared EC-173 impact rows render.
+ */
+export declare function buildAssetReferenceImpact(inbound: readonly ReferenceEntryView[]): {
+    broken: ReferenceEntryView[];
+    blocking: ReferenceEntryView[];
+};

package/dist/lib/references/impact.js

@@ -0,0 +1,62 @@
+import { documentKey } from '@elytracms/cms-core';
+import { parseDocumentFieldPath, parseDocumentKey } from './reference-model';
+/** Does this entry break (dangle / fall back) when `action` proceeds? */
+export function entryBreaksOnAction(entry, action) {
+    return action === 'delete' ? entry.draft || entry.published : entry.published;
+}
+/** The relation field holding a document-sourced relation entry, if resolvable. */
+export function relationFieldOfEntry(collections, entry) {
+    if (entry.kind !== 'relation-field' || entry.source.type !== 'document')
+        return undefined;
+    const sourceRef = parseDocumentKey(entry.source.id);
+    const parsedPath = parseDocumentFieldPath(entry.path);
+    if (!sourceRef || !parsedPath)
+        return undefined;
+    const collection = collections.find((c) => c.id === sourceRef.collection);
+    const field = collection?.fields.find((f) => f.name === parsedPath.field);
+    return field?.type === 'relation' ? field : undefined;
+}
+/** Does this entry *block* the action (strict opt-in, EC-173)? */
+export function entryBlocksAction(collections, entry, action) {
+    if (!entryBreaksOnAction(entry, action))
+        return false;
+    return relationFieldOfEntry(collections, entry)?.strict === true;
+}
+/**
+ * Build the impact of `action` over `targets` from their raw inbound entry
+ * views (keyed by `documentKey`). Sources that are themselves targets are
+ * excluded — they do not survive the action.
+ */
+export function buildReferenceImpact(collections, action, targets) {
+    const actedKeys = new Set(targets.map((target) => documentKey(target.ref)));
+    const documents = targets.map((target) => {
+        const surviving = target.inbound.filter((entry) => !(entry.source.type === 'document' && actedKeys.has(entry.source.id)));
+        const broken = surviving.filter((entry) => entryBreaksOnAction(entry, action));
+        return {
+            ref: target.ref,
+            broken,
+            blocking: broken.filter((entry) => entryBlocksAction(collections, entry, action)),
+        };
+    });
+    return {
+        action,
+        documents,
+        totalBroken: documents.reduce((sum, doc) => sum + doc.broken.length, 0),
+        totalBlocking: documents.reduce((sum, doc) => sum + doc.blocking.length, 0),
+    };
+}
+/**
+ * Impact of deleting an ASSET (EC-202), reusing the document break/block model.
+ * A delete dangles EVERY inbound reference (`delete` breaks both variants), and
+ * nothing *blocks*: assets are held by `asset` fields / `asset`-typed props,
+ * never by `strict: true` relation fields, so the asset path has no block
+ * concept — it is always weak-by-default. Returns the same `{ broken, blocking }`
+ * shape the shared EC-173 impact rows render.
+ */
+export function buildAssetReferenceImpact(inbound) {
+    return {
+        broken: inbound.filter((entry) => entryBreaksOnAction(entry, 'delete')),
+        blocking: [],
+    };
+}
+//# sourceMappingURL=impact.js.map

package/dist/lib/references/impact.js.map

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

package/dist/lib/references/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * References & used-by data layer (EC-172): pure presentation model over the
+ * EC-155 reference index plus the operations-backed panel store.
+ */
+export * from './reference-model';
+export * from './references-store';
+export * from './impact';

package/dist/lib/references/index.js

@@ -0,0 +1,8 @@
+/**
+ * References & used-by data layer (EC-172): pure presentation model over the
+ * EC-155 reference index plus the operations-backed panel store.
+ */
+export * from './reference-model';
+export * from './references-store';
+export * from './impact';
+//# sourceMappingURL=index.js.map

package/dist/lib/references/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/references/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA"}

package/dist/lib/references/reference-model.d.ts

@@ -0,0 +1,125 @@
+import type { CmsDocument, CollectionDef } from '@elytracms/cms-core';
+import type { ComponentNode, ProjectGraph } from '@elytracms/project-graph';
+import type { ReferenceEntryRecord, ReferenceKind, ReferenceSource, ReferenceTarget } from '@elytracms/persistence';
+/**
+ * Pure presentation model for the EC-172 references panels.
+ *
+ * The EC-155 index stores entries as `(source, path, target, kind)` per
+ * variant; this module turns those records into renderable rows: variants
+ * merged onto one row (draft/published badges), human-readable source/
+ * location/target labels, and deep-link descriptors that pinpoint the exact
+ * field (CMS) or graph node (builder) a path identifies. No data fetching, no
+ * React — everything here is a deterministic function of its inputs, so it is
+ * fully testable in the node environment.
+ */
+/** Split a `collection:id` document key (the index's document source/target id). */
+export declare function parseDocumentKey(key: string): {
+    collection: string;
+    id: string;
+} | null;
+export interface DocumentFieldPath {
+    /** Present for `localized/<locale>/<field>` paths. */
+    locale?: string;
+    field: string;
+    /** Tokens below the field value (array indices, rich-text node paths). */
+    rest: readonly string[];
+}
+/**
+ * Parse a document index path (`values/<field>/…` or
+ * `localized/<locale>/<field>/…`) onto the owning field.
+ */
+export declare function parseDocumentFieldPath(path: string): DocumentFieldPath | null;
+export interface ResolvedGraphPath {
+    /** The deepest node the structural prefix resolves to; `null` when the path no longer matches the graph. */
+    node: ComponentNode | null;
+    /** Tokens below the node (`componentId`, `props/<name>/binding`, `condition/source`). */
+    remainder: readonly string[];
+}
+/**
+ * Resolve a graph index path (`root`, then repeated `slots/<slot>/<index>`
+ * hops, then a structure suffix) to the node it identifies. Walks the
+ * slot/index prefix structurally; a prefix that no longer exists (the graph
+ * drifted since indexing) resolves to `null`.
+ */
+export declare function resolveGraphNodePath(root: ComponentNode, path: string): ResolvedGraphPath;
+/** One panel row: the same logical entry across both variants, with flags. */
+export interface MergedReferenceEntry {
+    /** Stable row key (source + path + target + kind). */
+    key: string;
+    source: ReferenceSource;
+    path: string;
+    target: ReferenceTarget;
+    kind: ReferenceKind;
+    /** Present in the draft variant of the index. */
+    draft: boolean;
+    /** Present in the published variant (a live reference). */
+    published: boolean;
+}
+/**
+ * Merge per-variant index records onto one row per logical entry. A
+ * draft-only row (`draft && !published`) is the Sanity hidden-draft-reference
+ * case the panel must make visible. Order is deterministic:
+ * source type → source id → path → target type → target id → kind.
+ */
+export declare function mergeReferenceVariants(records: readonly ReferenceEntryRecord[]): MergedReferenceEntry[];
+/** Human label per reference kind (entry-row badge). */
+export declare const REFERENCE_KIND_LABELS: Record<ReferenceKind, string>;
+/**
+ * A deep-link descriptor the panel renders as a router link. `cms-field`
+ * carries the full index path so the document editor can highlight the exact
+ * field control; `builder-node` carries the resolved node id so the builder
+ * can select + scroll to the node.
+ */
+export type ReferenceDeepLink = {
+    kind: 'cms-field';
+    collectionId: string;
+    documentId: string;
+    fieldPath?: string;
+} | {
+    kind: 'builder-node';
+    pageId?: string;
+    nodeId?: string;
+} | {
+    kind: 'component';
+    componentId: string;
+} | {
+    kind: 'asset';
+    assetId: string;
+};
+/** Everything the model needs to label entries (loaded once per panel). */
+export interface ReferenceLabelContext {
+    collections: readonly CollectionDef[];
+    /** Live documents keyed by `collection:id`. */
+    documents: ReadonlyMap<string, CmsDocument>;
+    /** Latest draft graph (page/layout names + node resolution); `null` when absent. */
+    graph: ProjectGraph | null;
+    /** Asset metadata keyed by asset id. */
+    assets: ReadonlyMap<string, {
+        filename: string;
+        title?: string | undefined;
+    }>;
+    /** Resolves a component id to its manifest title (live registry lookup). */
+    componentTitle: (componentId: string) => string | undefined;
+}
+/** One fully-labelled panel row. */
+export interface ReferenceEntryView extends MergedReferenceEntry {
+    kindLabel: string;
+    /** The holding entity, e.g. `Post · Hello World` or `Page · Home`. */
+    sourceLabel: string;
+    /** The exact location inside the source, e.g. `Author` or `Text (n-post-title)`. */
+    locationLabel: string;
+    /** The referenced entity, e.g. `Ada Lovelace` or `cover.jpg`. */
+    targetLabel: string;
+    /** Deep link to the exact source location (field control / graph node). */
+    sourceLink: ReferenceDeepLink | null;
+    /** Link to the referenced entity's surface. */
+    targetLink: ReferenceDeepLink | null;
+}
+/** Resolve a document's display title (titleField value, default locale first). */
+export declare function documentTitleOf(collection: CollectionDef | undefined, document: CmsDocument | undefined, fallback: string): string;
+/** Strip the namespace off a component id for compact labels. */
+export declare function shortComponentId(componentId: string): string;
+/** Label + link one merged entry (see {@link buildReferenceEntryViews}). */
+export declare function buildReferenceEntryView(entry: MergedReferenceEntry, context: ReferenceLabelContext): ReferenceEntryView;
+/** Merge variants and label every record — the panel's full render model. */
+export declare function buildReferenceEntryViews(records: readonly ReferenceEntryRecord[], context: ReferenceLabelContext): ReferenceEntryView[];

package/dist/lib/references/reference-model.js

@@ -0,0 +1,242 @@
+/**
+ * Pure presentation model for the EC-172 references panels.
+ *
+ * The EC-155 index stores entries as `(source, path, target, kind)` per
+ * variant; this module turns those records into renderable rows: variants
+ * merged onto one row (draft/published badges), human-readable source/
+ * location/target labels, and deep-link descriptors that pinpoint the exact
+ * field (CMS) or graph node (builder) a path identifies. No data fetching, no
+ * React — everything here is a deterministic function of its inputs, so it is
+ * fully testable in the node environment.
+ */
+// --- Path parsing -------------------------------------------------------------
+/** Split a `collection:id` document key (the index's document source/target id). */
+export function parseDocumentKey(key) {
+    const separator = key.indexOf(':');
+    if (separator <= 0 || separator === key.length - 1)
+        return null;
+    return { collection: key.slice(0, separator), id: key.slice(separator + 1) };
+}
+/**
+ * Parse a document index path (`values/<field>/…` or
+ * `localized/<locale>/<field>/…`) onto the owning field.
+ */
+export function parseDocumentFieldPath(path) {
+    const tokens = path.split('/');
+    if (tokens[0] === 'values' && tokens[1]) {
+        return { field: tokens[1], rest: tokens.slice(2) };
+    }
+    if (tokens[0] === 'localized' && tokens[1] && tokens[2]) {
+        return { locale: tokens[1], field: tokens[2], rest: tokens.slice(3) };
+    }
+    return null;
+}
+/**
+ * Resolve a graph index path (`root`, then repeated `slots/<slot>/<index>`
+ * hops, then a structure suffix) to the node it identifies. Walks the
+ * slot/index prefix structurally; a prefix that no longer exists (the graph
+ * drifted since indexing) resolves to `null`.
+ */
+export function resolveGraphNodePath(root, path) {
+    const tokens = path.split('/');
+    if (tokens[0] !== 'root')
+        return { node: null, remainder: tokens };
+    let node = root;
+    let index = 1;
+    while (index < tokens.length && tokens[index] === 'slots') {
+        const slot = tokens[index + 1];
+        const childIndex = Number(tokens[index + 2]);
+        const child = slot !== undefined && Number.isInteger(childIndex)
+            ? node.slots?.[slot]?.[childIndex]
+            : undefined;
+        if (!child)
+            return { node: null, remainder: tokens.slice(index) };
+        node = child;
+        index += 3;
+    }
+    return { node, remainder: tokens.slice(index) };
+}
+/**
+ * Merge per-variant index records onto one row per logical entry. A
+ * draft-only row (`draft && !published`) is the Sanity hidden-draft-reference
+ * case the panel must make visible. Order is deterministic:
+ * source type → source id → path → target type → target id → kind.
+ */
+export function mergeReferenceVariants(records) {
+    const byKey = new Map();
+    for (const record of records) {
+        const key = `${record.source.type} ${record.source.id} ${record.path} ${record.target.type} ${record.target.id} ${record.kind}`;
+        const existing = byKey.get(key);
+        if (existing) {
+            if (record.variant === 'draft')
+                existing.draft = true;
+            else
+                existing.published = true;
+            continue;
+        }
+        byKey.set(key, {
+            key,
+            source: record.source,
+            path: record.path,
+            target: record.target,
+            kind: record.kind,
+            draft: record.variant === 'draft',
+            published: record.variant === 'published',
+        });
+    }
+    return [...byKey.values()].sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+}
+// --- Labels & deep links --------------------------------------------------------
+/** Human label per reference kind (entry-row badge). */
+export const REFERENCE_KIND_LABELS = {
+    'relation-field': 'relation',
+    'asset-field': 'asset field',
+    'rich-text-link': 'rich-text link',
+    'rich-text-node': 'rich-text node',
+    'component-usage': 'component usage',
+    'prop-binding': 'prop binding',
+    'condition-binding': 'condition binding',
+};
+function fieldLabelOf(collection, fieldName) {
+    const field = collection?.fields.find((f) => f.name === fieldName);
+    return field?.form?.label ?? fieldName;
+}
+function collectionLabelOf(collection, collectionId) {
+    return collection?.form?.labelSingular ?? collection?.form?.label ?? collectionId;
+}
+/** Resolve a document's display title (titleField value, default locale first). */
+export function documentTitleOf(collection, document, fallback) {
+    if (!collection || !document)
+        return fallback;
+    const field = collection.titleField ?? 'title';
+    const direct = document.values[field];
+    if (typeof direct === 'string' && direct.length > 0)
+        return direct;
+    const locales = Object.keys(document.localized ?? {}).sort();
+    const preferred = document.defaultLocale;
+    for (const locale of [preferred, ...locales]) {
+        if (!locale)
+            continue;
+        const value = document.localized?.[locale]?.[field];
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return fallback;
+}
+/** Strip the namespace off a component id for compact labels. */
+export function shortComponentId(componentId) {
+    return componentId.replace('base.primitives.', '').replace('project.', '');
+}
+function documentParts(context, key) {
+    const ref = parseDocumentKey(key);
+    if (!ref)
+        return null;
+    const collection = context.collections.find((c) => c.id === ref.collection);
+    return {
+        collection,
+        collectionId: ref.collection,
+        documentId: ref.id,
+        title: documentTitleOf(collection, context.documents.get(key), ref.id),
+    };
+}
+function describeDocumentSource(context, entry) {
+    const parts = documentParts(context, entry.source.id);
+    if (!parts) {
+        return { sourceLabel: entry.source.id, locationLabel: entry.path, sourceLink: null };
+    }
+    const parsed = parseDocumentFieldPath(entry.path);
+    const fieldLabel = parsed ? fieldLabelOf(parts.collection, parsed.field) : entry.path;
+    const qualifiers = [];
+    if (parsed?.locale)
+        qualifiers.push(parsed.locale);
+    if (entry.kind === 'rich-text-link')
+        qualifiers.push('link');
+    if (entry.kind === 'rich-text-node')
+        qualifiers.push('embedded node');
+    if (entry.kind === 'relation-field' &&
+        parsed &&
+        parsed.rest.length === 1 &&
+        /^\d+$/.test(parsed.rest[0])) {
+        qualifiers.push(`item ${parsed.rest[0]}`);
+    }
+    return {
+        sourceLabel: `${collectionLabelOf(parts.collection, parts.collectionId)} · ${parts.title}`,
+        locationLabel: qualifiers.length > 0 ? `${fieldLabel} (${qualifiers.join(', ')})` : fieldLabel,
+        sourceLink: {
+            kind: 'cms-field',
+            collectionId: parts.collectionId,
+            documentId: parts.documentId,
+            fieldPath: entry.path,
+        },
+    };
+}
+function describeGraphSource(context, entry) {
+    const isPage = entry.source.type === 'page';
+    // The canonical graph is layouts-only now (EC-187): a `page` source is no
+    // longer addressable in the graph (page bodies are CMS documents), so only a
+    // layout owner resolves a node; a page source labels by its id.
+    const owner = isPage
+        ? undefined
+        : context.graph?.layouts.find((l) => l.id === entry.source.id);
+    const ownerLabel = `${isPage ? 'Page' : 'Layout'} · ${owner?.name ?? entry.source.id}`;
+    const resolved = owner ? resolveGraphNodePath(owner.root, entry.path) : null;
+    const node = resolved?.node ?? null;
+    const nodeLabel = node ? `${shortComponentId(node.componentId)} (${node.id})` : entry.path;
+    const remainder = resolved && node ? resolved.remainder.join('/') : null;
+    const locationLabel = remainder && remainder !== 'componentId' ? `${nodeLabel} · ${remainder}` : nodeLabel;
+    return {
+        sourceLabel: ownerLabel,
+        locationLabel,
+        // Layout nodes are not addressable in the page-scoped builder; link to the
+        // builder without a node selection in that case.
+        sourceLink: isPage
+            ? { kind: 'builder-node', pageId: entry.source.id, ...(node ? { nodeId: node.id } : {}) }
+            : { kind: 'builder-node' },
+    };
+}
+function describeTarget(context, target) {
+    switch (target.type) {
+        case 'document': {
+            const parts = documentParts(context, target.id);
+            if (!parts)
+                return { targetLabel: target.id, targetLink: null };
+            return {
+                targetLabel: `${collectionLabelOf(parts.collection, parts.collectionId)} · ${parts.title}`,
+                targetLink: {
+                    kind: 'cms-field',
+                    collectionId: parts.collectionId,
+                    documentId: parts.documentId,
+                },
+            };
+        }
+        case 'component':
+            return {
+                targetLabel: context.componentTitle(target.id) ?? shortComponentId(target.id),
+                targetLink: { kind: 'component', componentId: target.id },
+            };
+        case 'asset': {
+            const asset = context.assets.get(target.id);
+            return {
+                targetLabel: asset ? (asset.title ?? asset.filename) : target.id,
+                targetLink: { kind: 'asset', assetId: target.id },
+            };
+        }
+    }
+}
+/** Label + link one merged entry (see {@link buildReferenceEntryViews}). */
+export function buildReferenceEntryView(entry, context) {
+    const sourceParts = entry.source.type === 'document'
+        ? describeDocumentSource(context, entry)
+        : describeGraphSource(context, entry);
+    return {
+        ...entry,
+        kindLabel: REFERENCE_KIND_LABELS[entry.kind],
+        ...sourceParts,
+        ...describeTarget(context, entry.target),
+    };
+}
+/** Merge variants and label every record — the panel's full render model. */
+export function buildReferenceEntryViews(records, context) {
+    return mergeReferenceVariants(records).map((entry) => buildReferenceEntryView(entry, context));
+}
+//# sourceMappingURL=reference-model.js.map

package/dist/lib/references/reference-model.js.map

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

package/dist/lib/references/references-store.d.ts

@@ -0,0 +1,65 @@
+import type { DocumentRef } from '@elytracms/cms-core';
+import type { ReferenceSource, ReferenceTarget } from '@elytracms/persistence';
+import type { StudioOperations } from '../operations';
+import type { ReferenceEntryView } from './reference-model';
+/**
+ * Data layer for the EC-172 references panels. All reads go through
+ * `@elytracms/operations` queries (`references.outbound` / `references.inbound`
+ * plus the labeling queries) — UI code never touches persistence repositories
+ * or index tables. The hook keeps panels live: any succeeded command in a
+ * content-bearing domain re-queries after the EC-155 maintained-on-write
+ * attachment has flushed.
+ */
+export interface ReferencePanelQuery {
+    projectId: string;
+    /** Enables the outbound ("references") section. */
+    source?: ReferenceSource | undefined;
+    /** Enables the inbound ("used by") section. */
+    target?: ReferenceTarget | undefined;
+}
+export interface ReferencePanelData {
+    outbound: ReferenceEntryView[];
+    inbound: ReferenceEntryView[];
+    /**
+     * Per-direction read error (EC-205): a direction whose query returns a
+     * structured non-ok degrades to an empty list plus this message, surfaced as a
+     * visible per-section error — instead of collapsing the whole panel into its
+     * hard-error state. `null` when the direction loaded (or was not requested).
+     */
+    outboundError: string | null;
+    inboundError: string | null;
+}
+export declare function ensureReferenceIndex(studio: StudioOperations, projectId: string): Promise<void>;
+/** Load both directions + labels for one panel (operations queries only). */
+export declare function loadReferencePanelData(query: ReferencePanelQuery): Promise<ReferencePanelData>;
+/**
+ * Load the labelled inbound entry views for a set of target documents in ONE
+ * pass (one index flush, one label-context load) — the pre-flight data of the
+ * EC-173 confirmation dialogs, including the bulk flows. Returns entries in
+ * `targets` order; pair with `buildReferenceImpact` for break/block semantics.
+ */
+export declare function loadInboundReferenceViews(projectId: string, targets: readonly DocumentRef[]): Promise<{
+    ref: DocumentRef;
+    inbound: ReferenceEntryView[];
+}[]>;
+/**
+ * Inbound reference views for ONE asset (EC-202): the "what uses this asset"
+ * pre-flight of the asset-delete dialog, index-accurate (the EC-155 reference
+ * index, not the retired `find-asset-usages` string scan). Mirrors
+ * {@link loadInboundReferenceViews} for a single `{ type: 'asset' }` target —
+ * the source labels resolve the referencing documents/graph-nodes identically.
+ */
+export declare function loadInboundAssetReferenceViews(projectId: string, assetId: string): Promise<ReferenceEntryView[]>;
+export type ReferencePanelStatus = 'loading' | 'ready' | 'error';
+export interface ReferencePanelState {
+    status: ReferencePanelStatus;
+    data: ReferencePanelData | null;
+    errorMessage: string | null;
+    refresh: () => void;
+}
+/**
+ * Live panel state for one entity: loads on mount, exposes explicit
+ * loading/error states, and re-queries whenever a content-bearing command
+ * succeeds anywhere in the studio (the index is maintained on write).
+ */
+export declare function useReferencePanel(query: ReferencePanelQuery): ReferencePanelState;