structural-codes-viewer 0.1.0-alpha.1 → 0.1.0-alpha.3

package/package-dist/annotations/types.d.ts

@@ -0,0 +1,52 @@
+import type { DocumentId } from "../corpusData.js";
+import type { ViewerTarget } from "../permalinks.js";
+export declare const ANNOTATION_SCHEMA_VERSION: 1;
+export type AnnotationType = "bookmark" | "note";
+export interface UserAnnotation {
+    id: string;
+    schemaVersion: typeof ANNOTATION_SCHEMA_VERSION;
+    type: AnnotationType;
+    target: ViewerTarget;
+    documentId: DocumentId;
+    numbering: string;
+    title: string;
+    label?: string;
+    text?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateAnnotationInput {
+    type: AnnotationType;
+    target: ViewerTarget;
+    documentId: DocumentId;
+    numbering: string;
+    title: string;
+    label?: string;
+    text?: string;
+}
+export interface UpdateAnnotationPatch {
+    label?: string;
+    text?: string;
+}
+export interface AnnotationExport {
+    schemaVersion: typeof ANNOTATION_SCHEMA_VERSION;
+    exportedAt: string;
+    annotations: UserAnnotation[];
+}
+export interface AnnotationImportResult {
+    imported: number;
+    ignored: number;
+}
+export interface AnnotationStore {
+    listAnnotations(): Promise<UserAnnotation[]>;
+    createAnnotation(input: CreateAnnotationInput): Promise<UserAnnotation>;
+    updateAnnotation(id: string, patch: UpdateAnnotationPatch): Promise<UserAnnotation>;
+    deleteAnnotation(id: string): Promise<void>;
+    importAnnotations(value: unknown): Promise<AnnotationImportResult>;
+    exportAnnotations(): Promise<AnnotationExport>;
+}
+export type AnnotationErrorCode = "UNAVAILABLE" | "BLOCKED" | "UPGRADE_FAILED" | "CORRUPT" | "WRITE_FAILED" | "CONFLICT" | "INVALID_DATA";
+export declare class AnnotationStoreError extends Error {
+    readonly code: AnnotationErrorCode;
+    constructor(code: AnnotationErrorCode);
+}

package/package-dist/annotations/types.js

@@ -0,0 +1,18 @@
+export const ANNOTATION_SCHEMA_VERSION = 1;
+export class AnnotationStoreError extends Error {
+    constructor(code) {
+        const messages = {
+            UNAVAILABLE: "Le annotazioni locali non sono disponibili in questo browser.",
+            BLOCKED: "Chiudi le altre schede del viewer e riprova per aggiornare le annotazioni.",
+            UPGRADE_FAILED: "Aggiornamento dell’archivio annotazioni non riuscito. I dati esistenti non sono stati cancellati.",
+            CORRUPT: "L’archivio annotazioni contiene dati non leggibili. I dati sono stati conservati.",
+            WRITE_FAILED: "Salvataggio locale non riuscito. Mantieni aperta questa pagina e riprova.",
+            CONFLICT: "L’annotazione non esiste più o collide con un segnalibro esistente.",
+            INVALID_DATA: "I dati dell’annotazione non rispettano il formato supportato.",
+        };
+        super(messages[code]);
+        this.code = code;
+        this.name = "AnnotationStoreError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/package-dist/annotations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../shared/annotations/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AAsDpD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAqB,IAAyB;QAC5C,MAAM,QAAQ,GAAwC;YACpD,WAAW,EAAE,+DAA+D;YAC5E,OAAO,EAAE,4EAA4E;YACrF,cAAc,EAAE,mGAAmG;YACnH,OAAO,EAAE,mFAAmF;YAC5F,YAAY,EAAE,2EAA2E;YACzF,QAAQ,EAAE,qEAAqE;YAC/E,YAAY,EAAE,+DAA+D;SAC9E,CAAC;QACF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAVH,SAAI,GAAJ,IAAI,CAAqB;QAW5C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/package-dist/chunkNavigation.d.ts

@@ -0,0 +1,12 @@
+export function navigationChunkWindow(lookup: any, targetPath: any): {
+    previous: any;
+    target: any;
+    next: any;
+};
+export function navigationChunkPaths(lookup: any, targetPath: any): any[];
+export function isChunkNearRenderedWindow(lookup: any, targetPath: any, renderedPaths: any): boolean;
+export function primarySummaryForVisibleUnit(lookup: any, unitId: any, primaryAnchorByFallbackId: any): any;
+export function progressiveChunkTargetsForVisibleUnit(lookup: any, unitId: any, primaryAnchorByFallbackId: any): {
+    previous: any;
+    next: any;
+};

package/package-dist/chunkNavigation.js

@@ -0,0 +1,44 @@
+export function navigationChunkWindow(lookup, targetPath) {
+    var _a, _b;
+    const position = lookup === null || lookup === void 0 ? void 0 : lookup.chunkIndexByPath.get(targetPath);
+    if (position === undefined)
+        return { previous: null, target: targetPath, next: null };
+    return {
+        previous: (_a = lookup.chunkPaths[position - 1]) !== null && _a !== void 0 ? _a : null,
+        target: targetPath,
+        next: (_b = lookup.chunkPaths[position + 1]) !== null && _b !== void 0 ? _b : null,
+    };
+}
+export function navigationChunkPaths(lookup, targetPath) {
+    const window = navigationChunkWindow(lookup, targetPath);
+    return [window.previous, window.target, window.next].filter(Boolean);
+}
+export function isChunkNearRenderedWindow(lookup, targetPath, renderedPaths) {
+    const position = lookup === null || lookup === void 0 ? void 0 : lookup.chunkIndexByPath.get(targetPath);
+    if (position === undefined)
+        return false;
+    return [position - 1, position, position + 1].some((candidate) => {
+        const path = lookup.chunkPaths[candidate];
+        return Boolean(path && renderedPaths.has(path));
+    });
+}
+export function primarySummaryForVisibleUnit(lookup, unitId, primaryAnchorByFallbackId) {
+    var _a, _b;
+    return (_b = (_a = lookup === null || lookup === void 0 ? void 0 : lookup.unitById.get(unitId)) !== null && _a !== void 0 ? _a : primaryAnchorByFallbackId === null || primaryAnchorByFallbackId === void 0 ? void 0 : primaryAnchorByFallbackId.get(unitId)) !== null && _b !== void 0 ? _b : null;
+}
+export function progressiveChunkTargetsForVisibleUnit(lookup, unitId, primaryAnchorByFallbackId) {
+    var _a;
+    const summary = primarySummaryForVisibleUnit(lookup, unitId, primaryAnchorByFallbackId);
+    if (!lookup || !summary)
+        return { previous: null, next: null };
+    const chunkUnits = (_a = lookup.unitsByChunkPath.get(summary.chunkPath)) !== null && _a !== void 0 ? _a : [];
+    const position = chunkUnits.findIndex((unit) => unit.id === summary.id);
+    if (position < 0)
+        return { previous: null, next: null };
+    const adjacent = navigationChunkWindow(lookup, summary.chunkPath);
+    return {
+        previous: position <= 1 ? adjacent.previous : null,
+        next: position >= chunkUnits.length - 2 ? adjacent.next : null,
+    };
+}
+//# sourceMappingURL=chunkNavigation.js.map

package/package-dist/chunkNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkNavigation.js","sourceRoot":"","sources":["../shared/chunkNavigation.js"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,MAAM,EAAE,UAAU;;IACtD,MAAM,QAAQ,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACtF,OAAO;QACL,QAAQ,EAAE,MAAA,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,mCAAI,IAAI;QACjD,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,MAAA,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,mCAAI,IAAI;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAM,EAAE,UAAU;IACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa;IACzE,MAAM,QAAQ,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,yBAAyB;;IACpF,OAAO,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,yBAAyB,aAAzB,yBAAyB,uBAAzB,yBAAyB,CAAE,GAAG,CAAC,MAAM,CAAC,mCAAI,IAAI,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,yBAAyB;;IAC7F,MAAM,OAAO,GAAG,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACxF,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/D,MAAM,UAAU,GAAG,MAAA,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,mCAAI,EAAE,CAAC;IACxE,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE,OAAO;QACL,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAClD,IAAI,EAAE,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;KAC/D,CAAC;AACJ,CAAC"}

package/package-dist/corpusData.d.ts

@@ -1,15 +1,47 @@
 export type DocumentId = "ntc2018" | "circ2019";
 export type ViewerMode = "ntc" | "circ" | "combined";
+export type InlineSegment = {
+    kind: "text";
+    value: string;
+} | {
+    kind: "em";
+    value: string;
+} | {
+    kind: "underline";
+    value: string;
+} | {
+    kind: "em-underline";
+    value: string;
+} | {
+    kind: "strong";
+    value: string;
+} | {
+    kind: "strong-em";
+    value: string;
+} | {
+    kind: "strong-underline";
+    value: string;
+} | {
+    kind: "math";
+    value: string;
+    latex: string;
+};
+export interface TextParagraph {
+    normalized: string;
+    inline?: InlineSegment[];
+    listMarker?: "numbered" | "bullet" | "dash";
+    listLevel?: number;
+}
 export interface Evidence {
     sourceId: string;
     pdfPage: number;
     printedPage: string | null;
-    region: {
+    region?: {
         x: number;
         y: number;
         width: number;
         height: number;
-    };
+    } | null;
     transformations?: Array<{
         operation: string;
         note: string;
@@ -21,72 +53,100 @@ export interface CorpusBlock {
     blockId: string;
     kind: string;
     origin: string;
+    listMarker?: "bullet" | "dash" | "none";
+    listLevel?: number;
+    indentLevel?: number;
     text?: {
         raw: string;
         normalized: string;
         normalizationVersion: string;
-        inline?: Array<{
-            kind: "text";
-            value: string;
-        } | {
-            kind: "math";
-            value: string;
-            latex: string;
-        }>;
+        inline?: InlineSegment[];
+        paragraphs?: TextParagraph[];
     };
     assetId?: string;
     evidence?: Evidence;
 }
 export interface FormulaAsset {
     id: string;
+    unitId?: string;
     officialNumber: string | null;
     pdfPage: number;
     latex: string;
 }
+export interface TableCellImage {
+    imagePath: string;
+    alt: string;
+    sha256: string;
+    region: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
 export interface TableCell {
     text: string;
     latex?: string;
+    inline?: InlineSegment[];
+    image?: TableCellImage;
     colSpan?: number;
     rowSpan?: number;
+    strong?: boolean;
+    align?: "left" | "center" | "right";
+    noWrap?: boolean;
+    header?: boolean;
+    verticalText?: boolean;
+    shade?: "gray";
+    spacer?: boolean;
+    subrowIndent?: boolean;
+    subrowLabel?: boolean;
 }
 export interface TableAsset {
     id: string;
+    unitId?: string;
+    columnCount?: number;
+    columnWidths?: number[];
+    footerColumnCount?: number;
+    footerColumnWidths?: number[];
     officialNumber: string | null;
     pdfPage: number;
     caption: string | null;
+    hideLabel?: boolean;
+    captionInline?: InlineSegment[];
     headers: TableCell[][];
     rows: TableCell[][];
+    footerRows?: TableCell[][];
     notes: string[];
+    notesInline?: InlineSegment[][];
 }
 export interface FigureAsset {
     id: string;
+    unitId?: string;
+    sha256?: string;
     officialNumber: string;
     pdfPage: number;
-    caption: string;
+    caption: string | null;
+    captionInline?: InlineSegment[];
     alt: string;
     imagePath: string;
     region?: {
         width: number;
         height: number;
     };
+    displayScale?: number;
 }
 export interface AssetBundle {
     formulas: Record<string, FormulaAsset>;
     tables: Record<string, TableAsset>;
     figures: Record<string, FigureAsset>;
 }
-export interface OpenIssue {
-    issueId: string;
-    type: string;
-    severity: "blocking" | "warning" | "info";
-    note: string;
-}
 export interface Relation {
     relationId: string;
     type: string;
     targetUnitId: string;
     basis: string;
     rationale: string;
+    evidenceBlockIds?: string[];
     review: {
         status: string;
     };
@@ -100,6 +160,7 @@ export interface CorpusUnit {
         sortKey: string;
     };
     title: string;
+    titleBlockId?: string;
     hierarchy: {
         parentId: string | null;
         ancestorIds: string[];
@@ -113,9 +174,8 @@ export interface CorpusUnit {
     };
     blocks: CorpusBlock[];
     relations: Relation[];
-    workflow: {
-        status: string;
-        openIssues: OpenIssue[];
+    review: {
+        status: "draft" | "verified";
     };
 }
 export interface UnitSummary {
@@ -129,9 +189,7 @@ export interface UnitSummary {
     title: string;
     hierarchy: CorpusUnit["hierarchy"];
     validity: CorpusUnit["validity"];
-    workflowStatus: string;
-    openIssueCount: number;
-    blockingIssueCount: number;
+    reviewStatus: "draft" | "verified";
     chunkPath: string;
 }
 export interface DocumentMetadata {
@@ -166,7 +224,6 @@ export interface CorpusManifest {
         explicitRelations: number;
         proposedRelations: number;
         suggestedRelationDiagnostics: number;
-        reviewedUnits: number;
         assetUnits: number;
         formulas: number;
         tables: number;
@@ -177,6 +234,7 @@ export interface CorpusManifest {
     relationsPath: string;
     relationDiagnosticsPath: string;
     searchIndexPath: string;
+    crossReferenceIndexPath: string;
     chunks: Array<{
         path: string;
         document: DocumentId;
@@ -215,21 +273,106 @@ export interface RelationsIndex {
     inferredRelationsIncluded: false;
     relations: RelationEdge[];
 }
+export type SearchMatchKind = "number-exact" | "asset-exact" | "title" | "number-keyword" | "phrase" | "proximity" | "text" | "partial";
+export type SearchAssetKind = "formula" | "table" | "figure";
+export interface SearchSegment {
+    blockId: string;
+    assetId?: string;
+    assetKind?: SearchAssetKind;
+    officialNumber?: string;
+    text: string;
+}
+export interface SearchUnit {
+    id: string;
+    document: DocumentId;
+    numbering: string;
+    title: string;
+    titleNormalized: string;
+    titleBlockId?: string;
+    chunkPath: string;
+    segments: SearchSegment[];
+    textLength: number;
+    assetTextLength: number;
+}
 export interface SearchIndex {
-    formatVersion: 2;
-    units: Array<{
-        id: string;
-        document: DocumentId;
-        numbering: string;
-        title: string;
-        chunkPath: string;
-        text: string;
-    }>;
+    formatVersion: 4;
+    normalization: string;
+    units: SearchUnit[];
+    references: Record<string, [number, number]>;
+    assetReferences: Record<string, Array<[number, number]>>;
+    postings: Record<string, string>;
+}
+export interface SearchResult {
+    id: string;
+    document: DocumentId;
+    numbering: string;
+    title: string;
+    chunkPath: string;
+    snippet: string;
+    highlights: Array<[number, number]>;
+    score: number;
+    matchKind: SearchMatchKind;
+    blockId?: string;
+    assetId?: string;
+    assetKind?: SearchAssetKind;
+}
+export interface NormativeReference {
+    numbering: string;
+    documentHint: "circ2019" | null;
+}
+export type CrossReferenceKind = "unit" | "formula" | "table" | "figure";
+export interface CrossReferenceUnit {
+    id: string;
+    document: DocumentId;
+    numbering: string;
+    title: string;
+    snippet: string;
+}
+export interface CrossReferenceAsset {
+    id: string;
+    kind: Exclude<CrossReferenceKind, "unit">;
+    unitId: string;
+    blockId: string;
+    officialNumber: string;
+    title?: string | null;
+    snippet?: string | null;
+}
+export interface TextualBacklink {
+    targetType: CrossReferenceKind;
+    targetId: string;
+    sourceUnitId: string;
+    sourceBlockId: string;
+}
+export interface CrossReferenceIndex {
+    formatVersion: 1;
+    units: CrossReferenceUnit[];
+    assets: CrossReferenceAsset[];
+    backlinks: TextualBacklink[];
+}
+export interface DocumentLookup {
+    unitById: Map<string, UnitSummary>;
+    unitByNumbering: Map<string, UnitSummary>;
+    unitsByChunkPath: Map<string, UnitSummary[]>;
+    chunkPaths: string[];
+    chunkIndexByPath: Map<string, number>;
 }
 export declare function resolveDataPath(path: string, dataBaseUrl?: string): string;
+export declare function createDocumentLookup(index: DocumentIndex): DocumentLookup;
+export declare function parseNormativeReference(value: string): NormativeReference | null;
+export declare function initialUnitForIndex(index: DocumentIndex, requestedUnitId: string | null): UnitSummary;
+export declare function adjacentChunkPaths(lookup: DocumentLookup, chunkPath: string): {
+    previous: null;
+    next: null;
+} | {
+    previous: string;
+    next: string;
+};
+/** Read-only instrumentation used by diagnostics and tests. */
+export declare function cachedJsonPaths(): string[];
 export declare function documentForMode(mode: ViewerMode): DocumentId;
 export declare function loadManifest(dataBaseUrl?: string): Promise<CorpusManifest>;
 export declare function loadDocumentIndex(manifest: CorpusManifest, document: DocumentId, dataBaseUrl?: string): Promise<DocumentIndex>;
 export declare function loadChunk(path: string, dataBaseUrl?: string): Promise<CorpusChunk>;
 export declare function loadRelations(manifest: CorpusManifest, dataBaseUrl?: string): Promise<RelationsIndex>;
 export declare function loadSearchIndex(manifest: CorpusManifest, dataBaseUrl?: string): Promise<SearchIndex>;
+export declare function loadCrossReferenceIndex(manifest: CorpusManifest, dataBaseUrl?: string): Promise<CrossReferenceIndex>;

package/package-dist/corpusData.js

@@ -16,9 +16,58 @@ async function fetchJson(path) {
             return response.json();
         });
         jsonCache.set(path, pending);
+        pending.catch(() => {
+            if (jsonCache.get(path) === pending)
+                jsonCache.delete(path);
+        });
     }
     return pending;
 }
+export function createDocumentLookup(index) {
+    var _a;
+    const unitById = new Map();
+    const unitByNumbering = new Map();
+    const unitsByChunkPath = new Map();
+    for (const unit of index.units) {
+        unitById.set(unit.id, unit);
+        unitByNumbering.set(unit.numbering.official.replace(/^C/iu, ""), unit);
+        const chunkUnits = (_a = unitsByChunkPath.get(unit.chunkPath)) !== null && _a !== void 0 ? _a : [];
+        chunkUnits.push(unit);
+        unitsByChunkPath.set(unit.chunkPath, chunkUnits);
+    }
+    const chunkPaths = [...unitsByChunkPath.keys()];
+    return {
+        unitById,
+        unitByNumbering,
+        unitsByChunkPath,
+        chunkPaths,
+        chunkIndexByPath: new Map(chunkPaths.map((path, position) => [path, position])),
+    };
+}
+export function parseNormativeReference(value) {
+    const match = value.normalize("NFKC").trim().match(/^§?\s*(c)?\s*(\d+(?:\.\d+)*)\.?$/iu);
+    if (!match)
+        return null;
+    return { numbering: match[2], documentHint: match[1] ? "circ2019" : null };
+}
+export function initialUnitForIndex(index, requestedUnitId) {
+    var _a, _b, _c;
+    return (_c = (_b = (_a = index.units.find((unit) => unit.id === requestedUnitId)) !== null && _a !== void 0 ? _a : index.units.find((unit) => unit.hierarchy.ancestorIds.length === 0)) !== null && _b !== void 0 ? _b : index.units[0]) !== null && _c !== void 0 ? _c : null;
+}
+export function adjacentChunkPaths(lookup, chunkPath) {
+    var _a, _b;
+    const position = lookup.chunkIndexByPath.get(chunkPath);
+    if (position === undefined)
+        return { previous: null, next: null };
+    return {
+        previous: (_a = lookup.chunkPaths[position - 1]) !== null && _a !== void 0 ? _a : null,
+        next: (_b = lookup.chunkPaths[position + 1]) !== null && _b !== void 0 ? _b : null,
+    };
+}
+/** Read-only instrumentation used by diagnostics and tests. */
+export function cachedJsonPaths() {
+    return [...jsonCache.keys()];
+}
 export function documentForMode(mode) {
     return mode === "circ" ? "circ2019" : "ntc2018";
 }
@@ -37,4 +86,7 @@ export function loadRelations(manifest, dataBaseUrl = "/data/codes") {
 export function loadSearchIndex(manifest, dataBaseUrl = "/data/codes") {
     return fetchJson(resolveDataPath(manifest.searchIndexPath, dataBaseUrl));
 }
+export function loadCrossReferenceIndex(manifest, dataBaseUrl = "/data/codes") {
+    return fetchJson(resolveDataPath(manifest.crossReferenceIndexPath, dataBaseUrl));
+}
 //# sourceMappingURL=corpusData.js.map

package/package-dist/corpusData.js.map

@@ -1 +1 @@
-{"version":3,"file":"corpusData.js","sourceRoot":"","sources":["../shared/corpusData.ts"],"names":[],"mappings":"AA2JA,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEtD,SAAS,QAAQ,CAAC,WAAmB;IACnC,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,WAAW,GAAG,aAAa;IACvE,IAAI,WAAW,KAAK,aAAa,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,SAAS,CAAI,IAAY;IACtC,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC5C,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,WAAW,GAAG,aAAa;IACtD,OAAO,SAAS,CAAiB,eAAe,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC,CAAC;AAC9F,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,QAAwB,EAAE,QAAoB,EAAE,WAAW,GAAG,aAAa;IAC3G,OAAO,SAAS,CAAgB,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AACxG,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,WAAW,GAAG,aAAa;IACjE,OAAO,SAAS,CAAc,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AACpE,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,QAAwB,EAAE,WAAW,GAAG,aAAa;IACjF,OAAO,SAAS,CAAiB,eAAe,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AACzF,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,QAAwB,EAAE,WAAW,GAAG,aAAa;IACnF,OAAO,SAAS,CAAc,eAAe,CAAC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"corpusData.js","sourceRoot":"","sources":["../shared/corpusData.ts"],"names":[],"mappings":"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"}

package/package-dist/crossReferences.d.ts

@@ -0,0 +1,46 @@
+export function findCrossReferences(value: any): {
+    start: number;
+    end: number;
+    text: string;
+    kind: string;
+    number: any;
+    documentHint: string | null;
+}[];
+export function buildCrossReferenceIndexPayload({ units, assetCollections }: {
+    units: any;
+    assetCollections: any;
+}): {
+    formatVersion: number;
+    units: any;
+    assets: {
+        title?: any;
+        snippet?: any;
+        id: any;
+        kind: string;
+        unitId: any;
+        blockId: any;
+        officialNumber: any;
+    }[];
+    backlinks: {
+        targetType: string;
+        targetId: any;
+        sourceUnitId: any;
+        sourceBlockId: any;
+    }[];
+};
+export function createCrossReferenceLookup(index: any): {
+    unitById: Map<any, any>;
+    unitByDocumentAndNumber: Map<any, any>;
+    assetById: Map<any, any>;
+    assetByDocumentKindAndNumber: Map<any, any>;
+    backlinksByTarget: Map<any, any>;
+};
+export function resolveCrossReference(lookup: any, reference: any, sourceDocument: any): {
+    targetType: string;
+    unit: any;
+    asset?: undefined;
+} | {
+    targetType: any;
+    unit: any;
+    asset: any;
+} | null;