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

package/package-dist/crossReferences.js

@@ -0,0 +1,198 @@
+const unitPattern = /(^|[^\p{L}\p{N}])(§\s*C?\.?\d+(?:\.\d+)+|C\.?\d+(?:\.\d+)+|\d+(?:\.\d+){2,})/giu;
+const assetPatterns = [
+    { kind: "table", pattern: /\b(?:Tab\.\s*|Tab(?:ella|elle)?\s+)((?:C(?:\.)?)?\d+(?:\.\d+)*(?:\.[IVXLCDM]+[a-z]?(?:\.[a-z]+)?)?)/giu },
+    { kind: "table", pattern: /\b((?:C(?:\.)?)?\d+(?:\.\d+)*\.[IVXLCDM]+[a-z]?(?:\.[a-z]+)?)/giu },
+    { kind: "figure", pattern: /\b(?:Fig\.\s*|Fig\s+|Figura\s+)((?:C(?:\.)?)?\d+(?:\.\d+)+)/giu },
+    { kind: "formula", pattern: /\b(?:formula|equazione|relazione)\s+(?:n\.?\s*)?\[?((?:C(?:\.)?)?\d+(?:\.\d+)+)\]?/giu },
+    { kind: "formula", pattern: /\[((?:C(?:\.)?)?\d+(?:\.\d+)+)\]/giu },
+];
+function normalizedNumber(value) {
+    return value.replace(/^C\.?/iu, "").replace(/[.\s]+$/gu, "").replace(/(^|\.)([ivxlcdm]+)(?=\.|$)/gu, (match, prefix, part) => prefix + (part.length > 1 || part === part.toUpperCase() ? part.toUpperCase() : part));
+}
+function documentHint(value) {
+    return /^C/iu.test(value.trim().replace(/^§\s*/iu, "")) ? "circ2019" : null;
+}
+function overlaps(left, right) {
+    return left.start < right.end && right.start < left.end;
+}
+export function findCrossReferences(value) {
+    const source = String(value !== null && value !== void 0 ? value : "");
+    const candidates = [];
+    const combinedTablePattern = /\b(?:Tab\.\s*|Tab(?:ella|elle)?\s+)?((?:C(?:\.)?)?\d+(?:\.\d+)*\.[IVXLCDM]+)([a-z])-\s*([a-z])\b/giu;
+    for (const match of source.matchAll(combinedTablePattern)) {
+        const suffix = match[3];
+        const end = match.index + match[0].length;
+        const start = end - suffix.length;
+        candidates.push({
+            start,
+            end,
+            text: suffix,
+            kind: "table",
+            number: `${match[1]}${suffix}`,
+            documentHint: documentHint(match[1]),
+        });
+    }
+    for (const { kind, pattern } of assetPatterns) {
+        pattern.lastIndex = 0;
+        for (const match of source.matchAll(pattern)) {
+            candidates.push({
+                start: match.index,
+                end: match.index + match[0].length,
+                text: match[0],
+                kind,
+                number: normalizedNumber(match[1]),
+                documentHint: documentHint(match[1]),
+            });
+        }
+    }
+    unitPattern.lastIndex = 0;
+    for (const match of source.matchAll(unitPattern)) {
+        const prefixLength = match[1].length;
+        const raw = match[2];
+        candidates.push({
+            start: match.index + prefixLength,
+            end: match.index + prefixLength + raw.length,
+            text: raw,
+            kind: "unit",
+            number: normalizedNumber(raw.replace(/^§\s*/iu, "")),
+            documentHint: documentHint(raw),
+        });
+    }
+    const accepted = [];
+    for (const candidate of candidates.sort((left, right) => left.start - right.start || (left.kind === "unit" ? 1 : -1) || right.end - left.end)) {
+        if (!accepted.some((current) => overlaps(current, candidate)))
+            accepted.push(candidate);
+    }
+    return accepted.sort((left, right) => left.start - right.start);
+}
+function compactText(unit, maximum = 110) {
+    const value = unit.blocks
+        .filter((block) => block.blockId !== unit.titleBlockId)
+        .flatMap((block) => { var _a; return ((_a = block.text) === null || _a === void 0 ? void 0 : _a.normalized) ? [block.text.normalized] : []; })
+        .join(" ")
+        .replace(/\s+/gu, " ")
+        .trim();
+    return value.length > maximum ? `${value.slice(0, maximum - 1).trimEnd()}…` : value;
+}
+function assetKindFor(collection) {
+    return collection === "formulas" ? "formula" : collection === "tables" ? "table" : "figure";
+}
+function preferredDocument(reference, sourceDocument) {
+    if (reference.documentHint)
+        return reference.documentHint;
+    return sourceDocument === "circ2019" ? "ntc2018" : sourceDocument;
+}
+function targetKey(targetType, targetId) {
+    return `${targetType}:${targetId}`;
+}
+export function buildCrossReferenceIndexPayload({ units, assetCollections }) {
+    var _a;
+    const unitTargets = units.map((unit) => ({
+        id: unit.id,
+        document: unit.document,
+        numbering: unit.numbering.official,
+        title: unit.title,
+        snippet: compactText(unit),
+    }));
+    const unitById = new Map(unitTargets.map((unit) => [unit.id, unit]));
+    const unitByDocumentAndNumber = new Map(unitTargets.map((unit) => [`${unit.document}:${normalizedNumber(unit.numbering)}`, unit]));
+    const ownerByAssetId = new Map();
+    for (const unit of units) {
+        for (const block of unit.blocks) {
+            if (block.assetId && !ownerByAssetId.has(block.assetId))
+                ownerByAssetId.set(block.assetId, { unit, blockId: block.blockId });
+        }
+    }
+    const assets = [];
+    for (const [collection, records] of Object.entries(assetCollections)) {
+        const kind = assetKindFor(collection);
+        for (const asset of records) {
+            if (!asset.officialNumber)
+                continue;
+            const owner = ownerByAssetId.get(asset.id);
+            if (!owner)
+                continue;
+            assets.push(Object.assign(Object.assign({ id: asset.id, kind, unitId: owner.unit.id, blockId: owner.blockId, officialNumber: asset.officialNumber }, (kind === "table" && asset.caption ? { title: asset.caption, snippet: asset.caption } : {})), (kind === "figure" ? { title: asset.caption, snippet: asset.alt } : {})));
+        }
+    }
+    const assetByDocumentKindAndNumber = new Map(assets.map((asset) => {
+        const owner = unitById.get(asset.unitId);
+        return [`${owner.document}:${asset.kind}:${normalizedNumber(asset.officialNumber)}`, asset];
+    }));
+    const backlinks = [];
+    const seen = new Set();
+    const referencedAssetIds = new Set();
+    for (const source of units) {
+        for (const block of source.blocks) {
+            if (!((_a = block.text) === null || _a === void 0 ? void 0 : _a.normalized) || block.blockId === source.titleBlockId)
+                continue;
+            for (const reference of findCrossReferences(block.text.normalized)) {
+                const preferred = preferredDocument(reference, source.document);
+                const documents = preferred === source.document ? [preferred] : [preferred, source.document];
+                let target = null;
+                let targetType = reference.kind;
+                for (const document of documents) {
+                    target = reference.kind === "unit"
+                        ? unitByDocumentAndNumber.get(`${document}:${reference.number}`)
+                        : assetByDocumentKindAndNumber.get(`${document}:${reference.kind}:${reference.number}`);
+                    if (target)
+                        break;
+                }
+                if (!target || (targetType === "unit" && target.id === source.id))
+                    continue;
+                if (targetType !== "unit") {
+                    referencedAssetIds.add(target.id);
+                    continue;
+                }
+                const key = `${targetKey(targetType, target.id)}:${source.id}:${block.blockId}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                backlinks.push({
+                    targetType,
+                    targetId: target.id,
+                    sourceUnitId: source.id,
+                    sourceBlockId: block.blockId,
+                });
+            }
+        }
+    }
+    // Exact canonical resolution needs every numbered asset, even without a
+    // backlink. Keep descriptive preview fields only for assets referenced by
+    // corpus prose so the lazy viewer index remains compact.
+    const indexedAssets = assets.map((asset) => referencedAssetIds.has(asset.id) ? asset : ({
+        id: asset.id, kind: asset.kind, unitId: asset.unitId, blockId: asset.blockId, officialNumber: asset.officialNumber,
+    }));
+    return { formatVersion: 1, units: unitTargets, assets: indexedAssets, backlinks };
+}
+export function createCrossReferenceLookup(index) {
+    var _a;
+    const unitById = new Map(index.units.map((unit) => [unit.id, unit]));
+    const unitByDocumentAndNumber = new Map(index.units.map((unit) => [`${unit.document}:${normalizedNumber(unit.numbering)}`, unit]));
+    const assetById = new Map(index.assets.map((asset) => [asset.id, asset]));
+    const assetByDocumentKindAndNumber = new Map(index.assets.map((asset) => {
+        const unit = unitById.get(asset.unitId);
+        return [`${unit.document}:${asset.kind}:${normalizedNumber(asset.officialNumber)}`, asset];
+    }));
+    const backlinksByTarget = new Map();
+    for (const backlink of index.backlinks) {
+        const key = targetKey(backlink.targetType, backlink.targetId);
+        const group = (_a = backlinksByTarget.get(key)) !== null && _a !== void 0 ? _a : [];
+        group.push(backlink);
+        backlinksByTarget.set(key, group);
+    }
+    return { unitById, unitByDocumentAndNumber, assetById, assetByDocumentKindAndNumber, backlinksByTarget };
+}
+export function resolveCrossReference(lookup, reference, sourceDocument) {
+    const preferred = preferredDocument(reference, sourceDocument);
+    const documents = preferred === sourceDocument ? [preferred] : [preferred, sourceDocument];
+    for (const document of documents) {
+        const target = reference.kind === "unit"
+            ? lookup.unitByDocumentAndNumber.get(`${document}:${reference.number}`)
+            : lookup.assetByDocumentKindAndNumber.get(`${document}:${reference.kind}:${reference.number}`);
+        if (target)
+            return reference.kind === "unit" ? { targetType: "unit", unit: target } : { targetType: reference.kind, unit: lookup.unitById.get(target.unitId), asset: target };
+    }
+    return null;
+}
+//# sourceMappingURL=crossReferences.js.map

package/package-dist/crossReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossReferences.js","sourceRoot":"","sources":["../shared/crossReferences.js"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,iFAAiF,CAAC;AACtG,MAAM,aAAa,GAAG;IACpB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wGAAwG,EAAE;IACpI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kEAAkE,EAAE;IAC9F,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gEAAgE,EAAE;IAC7F,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,uFAAuF,EAAE;IACrH,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,qCAAqC,EAAE;CACpE,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAK;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACvN,CAAC;AAED,SAAS,YAAY,CAAC,KAAK;IACzB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,SAAS,QAAQ,CAAC,IAAI,EAAE,KAAK;IAC3B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAK;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,oBAAoB,GAAG,qGAAqG,CAAC;IACnI,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1C,MAAM,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QAClC,UAAU,CAAC,IAAI,CAAC;YACd,KAAK;YACL,GAAG;YACH,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE;YAC9B,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;QAC9C,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAClC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACd,IAAI;gBACJ,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAClC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACrC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC;YACd,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,YAAY;YACjC,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,GAAG,CAAC,MAAM;YAC5C,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACpD,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9I,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM;SACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,YAAY,CAAC;SACtD,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,WAAC,OAAA,CAAA,MAAA,KAAK,CAAC,IAAI,0CAAE,UAAU,EAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA,EAAA,CAAC;SACzE,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,IAAI,EAAE,CAAC;IACV,OAAO,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,UAAU;IAC9B,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9F,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAS,EAAE,cAAc;IAClD,IAAI,SAAS,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC,YAAY,CAAC;IAC1D,OAAO,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;AACpE,CAAC;AAED,SAAS,SAAS,CAAC,UAAU,EAAE,QAAQ;IACrC,OAAO,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE;;IACzE,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ;QAClC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC,CAAC;IACJ,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACnI,MAAM,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/H,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,cAAc;gBAAE,SAAS;YACpC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,CAAC,IAAI,+BACT,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,IAAI,EACJ,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EACrB,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,cAAc,EAAE,KAAK,CAAC,cAAc,IACjC,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC3F,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1E,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC,CAAC;IACJ,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAE,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,CAAA,MAAA,KAAK,CAAC,IAAI,0CAAE,UAAU,CAAA,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,YAAY;gBAAE,SAAS;YAC/E,KAAK,MAAM,SAAS,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnE,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChE,MAAM,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7F,IAAI,MAAM,GAAG,IAAI,CAAC;gBAClB,IAAI,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;gBAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,MAAM,GAAG,SAAS,CAAC,IAAI,KAAK,MAAM;wBAChC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;wBAChE,CAAC,CAAC,4BAA4B,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC1F,IAAI,MAAM;wBAAE,MAAM;gBACpB,CAAC;gBACD,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAC5E,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;oBAC1B,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAClC,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChF,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,SAAS,CAAC,IAAI,CAAC;oBACb,UAAU;oBACV,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,YAAY,EAAE,MAAM,CAAC,EAAE;oBACvB,aAAa,EAAE,KAAK,CAAC,OAAO;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,wEAAwE;IACxE,0EAA0E;IAC1E,yDAAyD;IACzD,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtF,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc;KACnH,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAK;;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACnI,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC,CAAC;IACJ,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAC;IACpC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAA,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,SAAS,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc;IACrE,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,SAAS,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC3F,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,KAAK,MAAM;YACtC,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACvE,CAAC,CAAC,MAAM,CAAC,4BAA4B,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,MAAM;YAAE,OAAO,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package-dist/generate-artifacts.mjs

@@ -3,6 +3,8 @@ import { createHash } from "node:crypto";
 import { copyFile, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { buildSearchIndexPayload } from "./searchEngine.js";
+import { buildCrossReferenceIndexPayload } from "./crossReferences.js";
 
 const documentOrder = ["ntc2018", "circ2019"];
 const maxInitialChunkBytes = 1_500_000;
@@ -61,8 +63,39 @@ function assignChunkKeys(units) {
 }
 function publicUnit(document, unit) { return { ...unit, document }; }
 function unitSummary(document, unit, chunkPath) {
-  const openIssues = unit.workflow.openIssues ?? [];
-  return { id: unit.id, document, kind: unit.kind, numbering: unit.numbering, title: unit.title, hierarchy: unit.hierarchy, validity: unit.validity, workflowStatus: unit.workflow.status, openIssueCount: openIssues.length, blockingIssueCount: openIssues.filter(({ severity }) => severity === "blocking").length, chunkPath };
+  return { id: unit.id, document, kind: unit.kind, numbering: unit.numbering, title: unit.title, hierarchy: unit.hierarchy, validity: unit.validity, reviewStatus: unit.review.status, chunkPath };
+}
+
+function compactSearchText(parts) {
+  const seen = new Set();
+  return parts.flatMap((part) => {
+    const text = String(part ?? "").replace(/\s+/gu, " ").trim();
+    const key = text.normalize("NFKC").toLocaleLowerCase("it");
+    if (!text || seen.has(key)) return [];
+    seen.add(key);
+    return [text];
+  }).join(" ");
+}
+
+function searchableAssetText(kind, asset) {
+  const label = kind === "formula" ? "Formula" : kind === "table" ? "Tabella" : "Figura";
+  const identity = asset.officialNumber ? `${label} ${asset.officialNumber}` : label;
+  if (kind === "formula") return identity;
+  if (kind === "figure") return compactSearchText([identity, asset.caption, asset.alt]);
+  const cells = [...asset.headers, ...asset.rows, ...(asset.footerRows ?? [])].flat().map((cell) => cell.text);
+  return compactSearchText([identity, asset.caption, ...cells, ...asset.notes]);
+}
+
+function searchSegments(unit, assetById) {
+  return unit.blocks.flatMap((block) => {
+    const segments = [];
+    if (block.text?.normalized && block.blockId !== unit.titleBlockId) segments.push({ blockId: block.blockId, text: block.text.normalized });
+    if (block.assetId) {
+      const found = assetById.get(block.assetId);
+      if (found) segments.push({ blockId: block.blockId, assetId: block.assetId, assetKind: found.kind, officialNumber: found.asset.officialNumber, text: searchableAssetText(found.kind, found.asset) });
+    }
+    return segments;
+  });
 }
 
 export async function generateArtifacts({ sourcePackage = "structural-codes", outputDirectory = join(process.cwd(), "public", "data", "codes"), assetOutputDirectory = join(process.cwd(), "public", "assets") } = {}) {
@@ -74,16 +107,16 @@ export async function generateArtifacts({ sourcePackage = "structural-codes", ou
   const assetManifestDirectory = join(sourceRoot, "corpus", "assets");
   const sourceRegistryFile = join(sourceRoot, "sources", "registry", "sources.v2.json");
   const packageFile = join(sourceRoot, "package.json");
-  const legacyOutput = join(dirname(outputDirectory), "corpus.json");
   const figureOutput = assetOutputDirectory;
   const [corpusManifest, sourceRegistry, packageManifest] = await Promise.all([json(corpusManifestFile), json(sourceRegistryFile), json(packageFile)]);
   const assetManifestFiles = (await readdir(assetManifestDirectory, { recursive: true })).filter((file) => file.endsWith(".json")).sort((left, right) => left.localeCompare(right, "it", { numeric: true }));
   const assetManifests = await Promise.all(assetManifestFiles.map((file) => json(join(assetManifestDirectory, file))));
   const assetCollections = { formulas: assetManifests.flatMap(({ formulas }) => formulas), tables: assetManifests.flatMap(({ tables }) => tables), figures: assetManifests.flatMap(({ figures }) => figures) };
   const assetsById = Object.fromEntries(Object.entries(assetCollections).map(([kind, assets]) => [kind, new Map(assets.map((asset) => [asset.id, asset]))]));
+  const searchableAssetById = new Map(Object.entries(assetCollections).flatMap(([collection, assets]) => assets.map((asset) => [asset.id, { kind: collection === "formulas" ? "formula" : collection === "tables" ? "table" : "figure", asset }])));
   const unitsByDocument = Object.fromEntries(await Promise.all(documentOrder.map(async (document) => [document, await loadUnits(corpusRoot, document)])));
   const allUnits = documentOrder.flatMap((document) => unitsByDocument[document].map((unit) => publicUnit(document, unit)));
-  await Promise.all([rm(outputDirectory, { recursive: true, force: true }), rm(legacyOutput, { force: true }), rm(figureOutput, { recursive: true, force: true })]);
+  await Promise.all([rm(outputDirectory, { recursive: true, force: true }), rm(figureOutput, { recursive: true, force: true })]);
   const chunkPathByUnit = new Map();
   const documentIndexes = {};
   const chunkInventory = [];
@@ -119,8 +152,9 @@ export async function generateArtifacts({ sourcePackage = "structural-codes", ou
   const relationsWritten = await writeJson(join(outputDirectory, "relations.json"), { formatVersion: 2, sourceOfTruth: "explicit-corpus-relations", inferredRelationsIncluded: false, relations });
   const ntcByNumber = new Map(unitsByDocument.ntc2018.map((unit) => [unit.numbering.official, unit]));
   const diagnostics = unitsByDocument.circ2019.flatMap((unit) => { const candidate = ntcByNumber.get(unit.numbering.official.replace(/^C/iu, "")); if (!candidate || unit.relations.some((relation) => relation.targetUnitId === candidate.id)) return []; return [{ kind: "suggested-relation", status: "diagnostic-only-not-canonical", reason: "same-numbering", sourceUnitId: unit.id, targetUnitId: candidate.id, sourceChunkPath: chunkPathByUnit.get(unit.id), targetChunkPath: chunkPathByUnit.get(candidate.id) }]; });
-  const diagnosticsWritten = await writeJson(join(outputDirectory, "relation-diagnostics.json"), { formatVersion: 2, warning: "Suggerimenti diagnostici non revisionati: non sono usati dalla vista combinata.", suggestions: diagnostics });
-  const searchWritten = await writeJson(join(outputDirectory, "search-index.json"), { formatVersion: 2, normalization: "NFKC lowercase it-IT at query time", units: allUnits.map((unit) => ({ id: unit.id, document: unit.document, numbering: unit.numbering.official, title: unit.title, chunkPath: chunkPathByUnit.get(unit.id), text: unit.blocks.flatMap((block) => block.text?.normalized ? [block.text.normalized] : []).join(" ") })) });
+  const diagnosticsWritten = await writeJson(join(outputDirectory, "relation-diagnostics.json"), { formatVersion: 2, warning: "Suggerimenti diagnostici non confermati: non sono usati dalla vista combinata.", suggestions: diagnostics });
+  const searchWritten = await writeJson(join(outputDirectory, "search-index.json"), buildSearchIndexPayload(allUnits.map((unit) => ({ id: unit.id, document: unit.document, numbering: unit.numbering.official, title: unit.title, titleBlockId: unit.titleBlockId, chunkPath: chunkPathByUnit.get(unit.id), segments: searchSegments(unit, searchableAssetById) }))));
+  const crossReferenceWritten = await writeJson(join(outputDirectory, "cross-reference-index.json"), buildCrossReferenceIndexPayload({ units: allUnits, assetCollections }));
   const manifestationBySourceId = new Map(sourceRegistry.works.flatMap((work) => work.manifestations.map((manifestation) => [manifestation.sourceId, { manifestation, work }])));
   for (const document of documentOrder) {
     const manifestDocument = corpusManifest.documents[document];
@@ -128,15 +162,16 @@ export async function generateArtifacts({ sourcePackage = "structural-codes", ou
     if (!source) throw new Error(`sourceId non risolto: ${manifestDocument.sourceId}`);
     Object.assign(documentIndexes[document], { sourceId: manifestDocument.sourceId, sourceUrl: source.manifestation.officialUrl, publicationUrl: source.work.publication.eliUri, localSourcePath: source.manifestation.localFile, sourceSha256: source.manifestation.sha256, pages: manifestDocument.pages, blocks: unitsByDocument[document].reduce((total, unit) => total + unit.blocks.filter((block) => block.text).length, 0) });
   }
-  const reviewedStatuses = new Set(["source-checked", "double-reviewed", "published", "superseded"]);
   const corpusFingerprintSha256 = sha256(JSON.stringify({ corpusManifest, unitsByDocument, assetManifests }));
-  const artifactFingerprintSha256 = sha256(JSON.stringify({ chunkInventory, indexes: documentIndexes, relations: relationsWritten.sha256, diagnostics: diagnosticsWritten.sha256, search: searchWritten.sha256 }));
-  const manifest = { formatVersion: 2, generatedAt: corpusManifest.asOf, structuralCodesVersion: packageManifest.version, schemaVersion: allUnits[0]?.schemaVersion ?? null, assetSchemaVersion: assetManifests[0]?.schemaVersion ?? null, status: corpusManifest.status, disclaimer: corpusManifest.disclaimer, corpusFingerprintSha256, generatedArtifactFingerprintSha256: artifactFingerprintSha256, stats: { units: allUnits.length, blocks: allUnits.reduce((total, unit) => total + unit.blocks.filter((block) => block.text).length, 0), explicitRelations: relations.length, proposedRelations: relations.filter((relation) => relation.review.status === "proposed").length, suggestedRelationDiagnostics: diagnostics.length, reviewedUnits: allUnits.filter((unit) => reviewedStatuses.has(unit.workflow.status)).length, assetUnits: allUnits.filter((unit) => unit.assets.formulaIds.length > 0 || unit.assets.tableIds.length > 0 || unit.assets.figureIds.length > 0).length, formulas: assetCollections.formulas.length, tables: assetCollections.tables.length, figures: assetCollections.figures.length, chunks: chunkInventory.length }, documents: documentIndexes, relationsPath: "/data/codes/relations.json", relationDiagnosticsPath: "/data/codes/relation-diagnostics.json", searchIndexPath: "/data/codes/search-index.json", chunks: chunkInventory };
+  const artifactFingerprintSha256 = sha256(JSON.stringify({ chunkInventory, indexes: documentIndexes, relations: relationsWritten.sha256, diagnostics: diagnosticsWritten.sha256, search: searchWritten.sha256, crossReferences: crossReferenceWritten.sha256 }));
+  const manifest = { formatVersion: 2, generatedAt: corpusManifest.asOf, structuralCodesVersion: packageManifest.version, schemaVersion: allUnits[0]?.schemaVersion ?? null, assetSchemaVersion: assetManifests[0]?.schemaVersion ?? null, status: corpusManifest.status, disclaimer: corpusManifest.disclaimer, corpusFingerprintSha256, generatedArtifactFingerprintSha256: artifactFingerprintSha256, stats: { units: allUnits.length, blocks: allUnits.reduce((total, unit) => total + unit.blocks.filter((block) => block.text).length, 0), explicitRelations: relations.length, proposedRelations: relations.filter((relation) => relation.review.status === "proposed").length, suggestedRelationDiagnostics: diagnostics.length, assetUnits: allUnits.filter((unit) => unit.assets.formulaIds.length > 0 || unit.assets.tableIds.length > 0 || unit.assets.figureIds.length > 0).length, formulas: assetCollections.formulas.length, tables: assetCollections.tables.length, figures: assetCollections.figures.length, chunks: chunkInventory.length }, documents: documentIndexes, relationsPath: "/data/codes/relations.json", relationDiagnosticsPath: "/data/codes/relation-diagnostics.json", searchIndexPath: "/data/codes/search-index.json", crossReferenceIndexPath: "/data/codes/cross-reference-index.json", chunks: chunkInventory };
   const manifestWritten = await writeJson(join(outputDirectory, "manifest.json"), manifest);
   let copiedFigureBytes = 0;
-  for (const figure of assetCollections.figures) {
-    const source = join(sourceRoot, "corpus", "assets", figure.imagePath);
-    const destination = join(figureOutput, figure.imagePath);
+  const tableCellImages = assetCollections.tables.flatMap((table) => [...table.headers, ...table.rows].flat().flatMap((cell) => cell.image ? [cell.image] : []));
+  const imagesByPath = new Map([...assetCollections.figures, ...tableCellImages].map((entry) => [entry.imagePath, entry]));
+  for (const image of imagesByPath.values()) {
+    const source = join(sourceRoot, "corpus", "assets", image.imagePath);
+    const destination = join(figureOutput, image.imagePath);
     await mkdir(dirname(destination), { recursive: true });
     await copyFile(source, destination);
     copiedFigureBytes += (await stat(source)).size;

package/package-dist/globalScrubber.d.ts

@@ -0,0 +1,10 @@
+export function buildGlobalScrubberEntries(entries: any, maximumLevel?: number): any;
+export function globalScrubberEntryAtRatio(entries: any, ratio: any): any;
+export function globalScrubberRatioForId(entries: any, id: any, fallbackRatio?: number): any;
+export function resolveGlobalScrubberActiveId(entries: any, activeId: any, activeBaseNumber: any): any;
+export function globalScrubberKeyboardIndex(currentIndex: any, key: any, entryCount: any): number;
+export function createGlobalScrubberDragSession(entries: any, onCommit: any): {
+    preview(ratio: any): any;
+    commit(): any;
+    cancel(): void;
+};

package/package-dist/globalScrubber.js

@@ -0,0 +1,85 @@
+function clampRatio(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+export function buildGlobalScrubberEntries(entries, maximumLevel = Number.POSITIVE_INFINITY) {
+    const visibleEntries = Number.isFinite(maximumLevel) ? entries.filter((entry) => entry.level <= maximumLevel) : entries;
+    const lastIndex = Math.max(0, visibleEntries.length - 1);
+    return visibleEntries.map((entry, index) => (Object.assign(Object.assign({}, entry), { index, ratio: lastIndex === 0 ? 0 : index / lastIndex })));
+}
+export function globalScrubberEntryAtRatio(entries, ratio) {
+    var _a;
+    if (entries.length === 0)
+        return null;
+    const index = Math.round(clampRatio(ratio) * (entries.length - 1));
+    return (_a = entries[index]) !== null && _a !== void 0 ? _a : null;
+}
+export function globalScrubberRatioForId(entries, id, fallbackRatio = 0) {
+    var _a;
+    if (entries.length < 2)
+        return 0;
+    const entry = entries.find((candidate) => candidate.id === id);
+    return (_a = entry === null || entry === void 0 ? void 0 : entry.ratio) !== null && _a !== void 0 ? _a : clampRatio(fallbackRatio);
+}
+export function resolveGlobalScrubberActiveId(entries, activeId, activeBaseNumber) {
+    var _a;
+    if (activeId && entries.some((entry) => entry.id === activeId))
+        return activeId;
+    if (!activeBaseNumber)
+        return null;
+    const exactEntry = entries.find((entry) => entry.baseNumber === activeBaseNumber);
+    if (exactEntry)
+        return exactEntry.id;
+    let closestAncestor = null;
+    for (const entry of entries) {
+        if (!activeBaseNumber.startsWith(`${entry.baseNumber}.`))
+            continue;
+        if (!closestAncestor || entry.baseNumber.length > closestAncestor.baseNumber.length)
+            closestAncestor = entry;
+    }
+    return (_a = closestAncestor === null || closestAncestor === void 0 ? void 0 : closestAncestor.id) !== null && _a !== void 0 ? _a : null;
+}
+export function globalScrubberKeyboardIndex(currentIndex, key, entryCount) {
+    if (entryCount <= 0)
+        return -1;
+    const lastIndex = entryCount - 1;
+    const safeIndex = Math.max(0, Math.min(lastIndex, currentIndex));
+    const pageStep = Math.max(1, Math.round(entryCount * 0.1));
+    if (key === "Home")
+        return 0;
+    if (key === "End")
+        return lastIndex;
+    if (key === "ArrowUp")
+        return Math.max(0, safeIndex - 1);
+    if (key === "ArrowDown")
+        return Math.min(lastIndex, safeIndex + 1);
+    if (key === "PageUp")
+        return Math.max(0, safeIndex - pageStep);
+    if (key === "PageDown")
+        return Math.min(lastIndex, safeIndex + pageStep);
+    return safeIndex;
+}
+export function createGlobalScrubberDragSession(entries, onCommit) {
+    let current = null;
+    let finished = false;
+    return {
+        preview(ratio) {
+            if (!finished)
+                current = globalScrubberEntryAtRatio(entries, ratio);
+            return current;
+        },
+        commit() {
+            if (finished)
+                return null;
+            finished = true;
+            if (current)
+                onCommit(current);
+            return current;
+        },
+        cancel() {
+            finished = true;
+        },
+    };
+}
+//# sourceMappingURL=globalScrubber.js.map

package/package-dist/globalScrubber.js.map

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

package/package-dist/permalinks.d.ts

@@ -0,0 +1,22 @@
+import type { ViewerMode } from "./corpusData";
+export type ViewerTarget = {
+    kind: "unit";
+    unitId: string;
+} | {
+    kind: "block";
+    unitId: string;
+    blockId: string;
+} | {
+    kind: "asset";
+    unitId: string;
+    assetId: string;
+    assetKind?: "formula" | "table" | "figure";
+};
+export declare function targetFromUrl(url: URL): ViewerTarget | null;
+export declare function urlForViewerTarget(currentUrl: string | URL, mode: ViewerMode, defaultMode: ViewerMode, target: ViewerTarget): URL;
+export declare function citationForTarget({ documentLabel, unitNumber, targetLabel, permalink }: {
+    documentLabel: string;
+    unitNumber: string;
+    targetLabel?: string | null;
+    permalink: string;
+}): string;

package/package-dist/permalinks.js

@@ -0,0 +1,36 @@
+export function targetFromUrl(url) {
+    const unitId = url.searchParams.get("unit");
+    if (!unitId)
+        return null;
+    const assetId = url.searchParams.get("asset");
+    if (assetId) {
+        const kind = url.searchParams.get("assetKind");
+        const assetKind = kind === "formula" || kind === "table" || kind === "figure" ? kind : undefined;
+        return { kind: "asset", unitId, assetId, assetKind };
+    }
+    const blockId = url.searchParams.get("block");
+    return blockId ? { kind: "block", unitId, blockId } : { kind: "unit", unitId };
+}
+export function urlForViewerTarget(currentUrl, mode, defaultMode, target) {
+    const url = new URL(currentUrl);
+    if (mode === defaultMode)
+        url.searchParams.delete("mode");
+    else
+        url.searchParams.set("mode", mode);
+    url.searchParams.set("unit", target.unitId);
+    url.searchParams.delete("block");
+    url.searchParams.delete("asset");
+    url.searchParams.delete("assetKind");
+    if (target.kind === "block")
+        url.searchParams.set("block", target.blockId);
+    if (target.kind === "asset") {
+        url.searchParams.set("asset", target.assetId);
+        if (target.assetKind)
+            url.searchParams.set("assetKind", target.assetKind);
+    }
+    return url;
+}
+export function citationForTarget({ documentLabel, unitNumber, targetLabel, permalink }) {
+    return `${documentLabel}, § ${unitNumber}${targetLabel ? `, ${targetLabel}` : ""} — ${permalink}`;
+}
+//# sourceMappingURL=permalinks.js.map

package/package-dist/permalinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permalinks.js","sourceRoot":"","sources":["../shared/permalinks.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAwB,EAAE,IAAgB,EAAE,WAAuB,EAAE,MAAoB;IAC1H,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,WAAW;QAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;QACrD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAiG;IACpL,OAAO,GAAG,aAAa,OAAO,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,SAAS,EAAE,CAAC;AACpG,CAAC"}

package/package-dist/searchClient.d.ts

@@ -0,0 +1,22 @@
+import { type CorpusManifest, type DocumentLookup, type SearchResult, type ViewerMode } from "./corpusData";
+type SearchStatus = "idle" | "loading" | "ready" | "error";
+export declare function resolveExactSearch(query: string, mode: ViewerMode, lookup: DocumentLookup | null, circLookup: DocumentLookup | null): SearchResult[] | null;
+export declare function useViewerSearch({ query, mode, manifest, dataBaseUrl, lookup, circLookup, maxResults, debounceMs }: {
+    query: string;
+    mode: ViewerMode;
+    manifest: CorpusManifest | null;
+    dataBaseUrl: string;
+    lookup: DocumentLookup | null;
+    circLookup: DocumentLookup | null;
+    maxResults: number;
+    debounceMs?: number;
+}): {
+    queryReady: boolean;
+    results: SearchResult[];
+    status: SearchStatus;
+    source: "exact" | "worker";
+    durationMs: number | null;
+    errorMessage: string | undefined;
+    indexRequested: boolean;
+};
+export {};