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

package/README.md

@@ -1,48 +1,49 @@
 # structural-codes-viewer
 
 `structural-codes-viewer` è il package React per consultare il corpus
-`structural-codes`. La stessa directory contiene l'applicazione standalone e
-la route ChatNTC self-hosted, che restano fuori dal tarball del package.
+`structural-codes`. La stessa directory contiene l'applicazione standalone.
 
 ## Boundary
 
 - `structural-codes`: corpus, schema, provenance e helper non React;
-- `structural-codes-viewer`: componenti React, client lazy, generatore
-  artefatti e API ChatNTC condivise;
-- `viewer/app/` e `viewer/server/`: composizione standalone, route e adapter
-  provider non pubblicati nel package.
+- `structural-codes-viewer`: viewer React, ricerca, navigazione, annotazioni,
+  client lazy e generatore di artefatti;
+- `viewer/app/`: composizione standalone non pubblicata nel package.
 
 React e ReactDOM sono peer dependency. Il package non dipende a runtime da
-Next/Vinext, `pdfjs-dist`, BGE-M3, adapter provider o file `.local`.
+Next/Vinext o `pdfjs-dist`.
 
 ## Viewer React
 
 ```tsx
-import { NormativeViewer } from "structural-codes-viewer";
+import { NormativeViewer, type AuxiliaryPanelContext } from "structural-codes-viewer";
 import "structural-codes-viewer/styles.css";
 
+function Panel({ context }: { context: AuxiliaryPanelContext }) {
+  return <aside><button onClick={context.close}>Chiudi</button></aside>;
+}
+
 export function Normativa() {
-  return <NormativeViewer defaultMode="combined" dataBaseUrl="/data/codes" />;
+  return <NormativeViewer
+    defaultMode="combined"
+    dataBaseUrl="/data/codes"
+    auxiliaryPanel={(context) => <Panel context={context} />}
+    auxiliaryPanelModes={["ntc", "circ", "combined"]}
+  />;
 }
 ```
 
-Props principali:
-
-- `defaultMode`: `combined`, `ntc` o `circ`;
-- `dataBaseUrl`: artefatti lazy, default `/data/codes`;
-- `assetsBaseUrl`: figure, default `/assets`;
-- `auxiliaryPanel`: pannello opzionale o render prop;
-- `auxiliaryPanelDefaultVisible`, `auxiliaryPanelKeepMounted` e modalità
-  consentite del pannello.
-
-La vista combinata mantiene le NTC come struttura principale e inserisce la
-Circolare solo tramite relazioni esplicite. Ricerca, chunk, relazioni, figure e
-prefetch sono lazy; il package shared non importa PDF o route standalone.
+`NormativeViewer` espone `dataBaseUrl`, `assetsBaseUrl`, `auxiliaryPanel`,
+`AuxiliaryPanelContext`, controlli di visibilità del pannello e `annotationStore`.
+Il pannello generico consente ai consumer di montare i propri componenti.
+Navigazione, ricerca, annotazioni, note e segnalibri sono indipendenti dalla
+composizione standalone. Sono pubblici anche `./annotations`, `./corpus-data`,
+`./generate-artifacts` e `./styles.css`.
 
 ## Artefatti
 
 ```bash
-npm --prefix viewer run sync:corpus
+npm run sync:corpus
 ```
 
 Il comando genera sotto `viewer/public/data/codes/` manifest, indici documento,
@@ -59,88 +60,20 @@ npx structural-codes-viewer --source structural-codes \
 Il package viewer non include il corpus completo: il generatore legge il
 package `structural-codes` installato nel consumer.
 
-## Export ChatNTC
-
-```ts
-import {
-  CHATNTC_DEFAULT_RETRIEVAL,
-  retrieveChatNTCEvidence,
-  validateChatNTCResponse,
-} from "structural-codes-viewer/chatntc";
-import { createViewerArtifactRepository } from
-  "structural-codes-viewer/chatntc/viewer-artifacts";
-import { ChatNTCPanel, type ChatTransport } from
-  "structural-codes-viewer/chatntc-ui";
-import { IndexedDbChatHistoryStore, type ChatHistoryStore } from
-  "structural-codes-viewer/chatntc-history";
-```
-
-Questi export sono shared/browser-safe. Route HTTP, provider secrets,
-`LocalChatTransport`, `LocalAIConfiguration` e impostazioni standalone non
-sono API del package.
-
-## Standalone senza ChatNTC
+## Standalone
 
 ```bash
 npm ci
-npm run sync:corpus
-npm run dev
-```
-
-Il viewer funziona senza provider e senza ChatNTC. Il PDF ufficiale è un
-ausilio locale/debug e non entra nel build pubblico o nel package.
-
-## ChatNTC self-hosted
-
-Dal root della repository:
-
-```bash
 npm run dev
 ```
 
-Il launcher abilita ChatNTC e vincola il server a `127.0.0.1`. In alternativa,
-copiando `viewer/.env.example` in `viewer/.env.local`, impostare:
-
-```dotenv
-CHATNTC_ENABLED=true
-CHATNTC_PROVIDER=deepseek
-CHATNTC_DEEPSEEK_API_KEY=
-CHATNTC_SEMANTIC_MODE=off
-```
-
-La chiave può restare vuota se l'utente usa la UI BYOK. Le chiavi environment
-rimangono server-side; quelle UI rimangono in memoria e viaggiano in un header
-stessa origine, mai nel body o nella history.
-
-Pipeline standard:
-
-```text
-query → lexical retrieval → structural expansion → Evidence Package
-      → LLM → Citation Validator → risposta verificata
-```
-
-Dettagli: [overview](../docs/chatntc-core.md),
-[self-hosting](../docs/chatntc-server.md),
-[BYOK](../docs/chatntc-byok.md) e
-[history](../docs/chatntc-history.md).
-
-## Semantic retrieval sperimentale
-
-`CHATNTC_SEMANTIC_MODE=off|shadow|on`; il default è `off`.
-
-- `off`: percorso lessicale standard, nessun indice o embedding;
-- `shadow`: calcolo semantic osservazionale, output lessicale invariato;
-- `on`: ranking fuso RRF con fallback lessicale.
-
-Gli adapter BGE-M3 HTTP e Ollama, i generatori indice e i benchmark sono
-strumenti opt-in. BGE-M3 non è una dipendenza obbligatoria del viewer o di
-ChatNTC. Vedere la
-[documentazione semantic](../docs/chatntc-semantic-index.md).
+Il PDF ufficiale è un ausilio locale di debug e non entra nel build pubblico o
+nel package.
 
 ## Sviluppo e verifica
 
 ```bash
-npm ci
+npm run typecheck
 npm run lint
 npm test
 npm run check
@@ -148,11 +81,11 @@ npm run pack:verify
 npm run test:consumer
 ```
 
-`check` costruisce app e libreria ed esegue test viewer, ChatNTC, history,
-semantic e boundary. `pack:verify` mostra il contenuto effettivo del tarball.
-`test:consumer` crea tarball reali di entrambi i package, li installa in una
-nuova app Next e verifica viewer, export ChatNTC runtime e tipi pubblici.
+`check` costruisce app e libreria ed esegue i test del viewer e del boundary.
+`pack:verify` mostra il contenuto del tarball. `test:consumer` crea tarball
+reali dei due package, li installa in una nuova app Next e verifica l'API
+pubblica del viewer, inclusa l'integrazione tramite `auxiliaryPanel`.
 
-Il tarball deve contenere soltanto `package-dist/`, README, licenza, notice e
-manifest. Sono vietati `app/`, `server/`, test, PDF, corpus completo, `.env`,
-cache, indici semantic e output standalone.
+Il tarball contiene soltanto `package-dist/`, README, licenza, notice e
+manifest. Restano fuori `app/`, test, PDF, corpus completo, `.env` e output
+standalone.

package/package-dist/styles.css

@@ -33,9 +33,6 @@ body:has(> .scv-root) { overflow: hidden; }
   --scv-paper: #f6f7fb;
   --scv-panel: #ffffff;
   --scv-line: #d9deea;
-  --scv-chat-surface: #f1f3f6;
-  --scv-chat-input: #ffffff;
-  --scv-chat-row-hover: #eef0f4;
   --scv-danger: #c92f3b;
   --scv-circular: #f0f3fb;
   --scv-amber: #9a671e;
@@ -345,7 +342,7 @@ body:has(> .scv-root) { overflow: hidden; }
 .scv-root .formula-asset { padding: 4px 8px 3px; }
 .scv-root .formula-row { display: flex; align-items: center; gap: 14px; }
 .scv-root .formula-scroll, .scv-root .table-scroll { max-width: 100%; overflow-x: auto; }
-.scv-root .formula-scroll, .scv-root .table-scroll, .scv-chat-markdown .katex-display, .scv-chat-markdown pre { overscroll-behavior-inline: contain; scrollbar-width: thin; }
+.scv-root .formula-scroll, .scv-root .table-scroll { overscroll-behavior-inline: contain; scrollbar-width: thin; }
 .scv-root .formula-scroll { flex: 1 1 auto; min-width: 0; padding: 2px 0 4px; font-size: calc(var(--scv-base-font-size) * 0.9846); }
 .scv-root .formula-scroll .katex-display { margin: .5em 0; }
 .scv-root .formula-number { flex: 0 0 auto; margin-left: auto; color: var(--scv-primary-dark); font-family: "Tinos", serif; font-size: var(--scv-font-size-12); font-variant-numeric: lining-nums; white-space: nowrap; }
@@ -578,9 +575,6 @@ body:has(> .scv-root) { overflow: hidden; }
   --scv-paper: #10141e;
   --scv-panel: #1b2130;
   --scv-line: #354057;
-  --scv-chat-surface: #151a25;
-  --scv-chat-input: #242c3c;
-  --scv-chat-row-hover: #2a3242;
   --scv-danger: #ff707a;
   --scv-circular: #20283b;
   --scv-amber: #f0c976;
@@ -651,10 +645,6 @@ body:has(> .scv-root) { overflow: hidden; }
 
 @keyframes scv-spin { to { transform: rotate(360deg); } }
 @keyframes scv-shimmer { to { background-position: -200% 0; } }
-@keyframes scv-chat-answer-enter {
-  from { opacity: 0; transform: translateY(6px); clip-path: inset(0 0 10% 0); }
-  to { opacity: 1; transform: translateY(0); clip-path: inset(0); }
-}
 
 .scv-tool-content[hidden] { display: none; }
 .scv-tools-toggle { position: absolute; z-index: 7; right: 64px; bottom: 18px; min-height: 42px; max-width: calc(100% - 80px); padding: 9px 13px; color: var(--scv-primary-dark); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 8px; box-shadow: 0 3px 12px rgb(0 0 0 / 12%); cursor: pointer; }
@@ -662,7 +652,7 @@ body:has(> .scv-root) { overflow: hidden; }
 .scv-tools-dock { display: grid; grid-template-rows: auto minmax(0, 1fr); height: 100%; color: var(--scv-ink); background: var(--scv-panel); }
 .scv-tools-header { display: flex; justify-content: space-between; align-items: center; gap: 8px; padding: 7px; border-bottom: 1px solid var(--scv-line); }
 .scv-tools-header [role="tablist"] { display: flex; gap: 4px; }
-.scv-tools-header button, .scv-chat button { min-height: 38px; padding: 7px 10px; color: var(--scv-primary-dark); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 6px; font-size: 13px; cursor: pointer; }
+.scv-tools-header button { min-height: 38px; padding: 7px 10px; color: var(--scv-primary-dark); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 6px; font-size: 13px; cursor: pointer; }
 .scv-tools-header button { height: 42px; min-height: 42px; }
 .scv-tools-header [aria-selected="true"] { color: var(--scv-panel); background: var(--scv-primary); border-color: var(--scv-primary); }
 .scv-tools-header [aria-selected="true"]:hover { background: var(--scv-primary-dark); border-color: var(--scv-primary-dark); }
@@ -670,143 +660,7 @@ body:has(> .scv-root) { overflow: hidden; }
 .scv-tools-header button.scv-tools-close:hover { color: var(--scv-panel); background: var(--scv-primary); border-color: var(--scv-primary); }
 .scv-tools-close-icon { width: 19px; height: 19px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-width: 1.8; }
 .scv-tools-header { position: relative; flex-wrap: wrap; }
-.scv-ai-settings { font-size: 12px; }
-.scv-ai-settings summary { padding: 7px; cursor: pointer; color: var(--scv-primary-dark); }
-.scv-ai-form { position: absolute; z-index: 12; left: 6px; right: 6px; top: 100%; display: grid; gap: 7px; padding: 14px; max-height: 65vh; overflow: auto; color: var(--scv-ink); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 8px; box-shadow: 0 8px 24px rgb(0 0 0 / 18%); }
-.scv-ai-form input, .scv-ai-form select { min-width: 0; width: 100%; padding: 8px; color: var(--scv-ink); text-align: left; background: var(--scv-paper); border: 1px solid var(--scv-line); border-radius: 5px; font: inherit; }
-.scv-ai-form p, .scv-ai-form small { margin: 0; color: var(--scv-ink-soft); line-height: 1.5; }
-.scv-ai-selection-badge { width: fit-content; max-width: 100%; padding: 5px 9px; overflow-wrap: anywhere; color: var(--scv-ink-soft); line-height: 1.35; background: color-mix(in srgb, var(--scv-paper) 82%, var(--scv-panel)); border: 1px solid var(--scv-line); border-radius: 999px; }
-.scv-ai-field { display: grid; grid-template-columns: 58px minmax(0, 1fr); gap: 10px; align-items: center; min-width: 0; }
-.scv-ai-field label { min-width: 0; color: var(--scv-ink-soft); font-weight: 600; white-space: nowrap; }
-.scv-ai-actions { display: flex; flex-wrap: wrap; gap: 6px; }
-.scv-ai-actions button { display: inline-flex; min-height: 38px; align-items: center; gap: 7px; padding: 7px 10px; color: var(--scv-primary-dark); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 6px; font: inherit; font-size: 13px; cursor: pointer; transition: color 150ms ease, background-color 150ms ease, border-color 150ms ease; }
-.scv-ai-actions button:hover:not(:disabled) { background: var(--scv-primary-soft); border-color: var(--scv-primary); }
-.scv-ai-action-icon { flex: none; width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.8; }
-.scv-ai-form [role="alert"] { color: var(--scv-amber); }
-.scv-ai-settings-embedded .scv-ai-form { position: static; max-height: none; padding: 0; overflow: visible; border: 0; border-radius: 0; box-shadow: none; }
 .scv-tool-content { min-width: 0; min-height: 0; overflow: hidden; }
-.scv-chat { display: grid; min-width: 0; grid-template-rows: minmax(100px, 1fr) auto; height: 100%; background: var(--scv-chat-surface); font-size: 14px; line-height: 1.58; }
-.scv-chat.scv-chat-has-actions { grid-template-rows: auto minmax(100px, 1fr) auto; }
-.scv-chat-actions { display: flex; align-items: center; gap: 6px; padding: 8px 12px; border-bottom: 1px solid var(--scv-line); }
-.scv-chat-actions button, .scv-chat-history-actions button { display: inline-flex; min-height: 42px; align-items: center; gap: 6px; padding: 0 8px; white-space: nowrap; border-color: transparent; background: transparent; }
-.scv-chat-actions button:hover, .scv-chat-history-actions button:hover { background: var(--scv-primary-soft); }
-.scv-chat-control-icon { flex: none; width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.7; }
-.scv-chat-messages { min-width: 0; min-height: 0; padding: 18px 16px 22px; overflow: auto; overflow-wrap: anywhere; overflow-anchor: none; scrollbar-color: var(--scv-line) transparent; scrollbar-width: thin; }
-.scv-chat-empty { margin: 0; padding: 28px 4px; color: var(--scv-ink-soft); font-size: 13px; text-align: center; }
-.scv-chat-turn { min-width: 0; max-width: 100%; scroll-margin-top: 8px; }
-.scv-chat-turn + .scv-chat-turn { margin-top: 28px; }
-.scv-chat-question { width: fit-content; max-width: min(88%, 64ch); margin-left: auto; padding: 9px 12px; overflow-anchor: auto; border: 1px solid color-mix(in srgb, var(--scv-primary) 45%, var(--scv-line)); border-radius: 14px 14px 4px; background: var(--scv-primary-soft); }
-.scv-chat-question small { display: block; margin-bottom: 3px; color: var(--scv-primary-dark); font-size: 10px; }
-.scv-chat-question p { margin: 0; white-space: pre-wrap; }
-.scv-chat-answer { min-width: 0; max-width: 100%; padding: 18px 1px 2px; }
-.scv-chat-answer-enter { animation: scv-chat-answer-enter 380ms cubic-bezier(.2, .72, .24, 1) both; }
-.scv-chat-classification { display: inline-block; padding: 3px 8px; font-size: 11px; border: 1px solid var(--scv-line); border-radius: 20px; color: var(--scv-ink-soft); }
-.scv-chat-classification[data-classification="interpretation"], .scv-chat-classification[data-classification="no-direct-reference"] { color: var(--scv-amber); background: var(--scv-amber-soft); border-color: transparent; }
-.scv-chat-markdown { width: 100%; max-width: 100%; margin-top: 13px; color: var(--scv-ink); font-size: 14px; line-height: 1.68; overflow-wrap: anywhere; }
-.scv-chat-markdown-loader { min-height: 1.68em; }
-.scv-chat-markdown > :first-child { margin-top: 0; }
-.scv-chat-markdown > :last-child { margin-bottom: 0; }
-.scv-chat-markdown p { margin: .72em 0; }
-.scv-chat-markdown p, .scv-chat-markdown li { text-align: justify; text-justify: inter-word; }
-.scv-chat-markdown p > strong:first-child { display: block; margin-bottom: .2em; text-align: start; text-justify: auto; }
-.scv-chat-markdown h2, .scv-chat-markdown h3, .scv-chat-markdown h4 { display: block; width: 100%; margin: 1.35em 0 .45em; clear: both; color: var(--scv-ink); font-family: inherit; font-weight: 650; line-height: 1.28; letter-spacing: -.015em; text-align: start; text-justify: auto; }
-.scv-chat-markdown h2 { font-size: 1.25em; }
-.scv-chat-markdown h3 { font-size: 1.12em; }
-.scv-chat-markdown h4 { font-size: 1.02em; }
-.scv-chat-markdown strong { font-weight: 680; }
-.scv-chat-markdown ul, .scv-chat-markdown ol { margin: .65em 0 .85em; padding-left: 1.45em; }
-.scv-chat-markdown li { margin: .24em 0; padding-left: .1em; }
-.scv-chat-markdown li::marker { color: var(--scv-primary); }
-.scv-chat-markdown blockquote { margin: .9em 0; padding: .05em 0 .05em .9em; color: var(--scv-ink-soft); border-left: 3px solid var(--scv-line); }
-.scv-chat-markdown blockquote p, .scv-chat-markdown blockquote li { text-align: start; text-justify: auto; }
-.scv-chat-markdown blockquote > :first-child { margin-top: .2em; }
-.scv-chat-markdown blockquote > :last-child { margin-bottom: .2em; }
-.scv-chat-markdown hr { height: 1px; margin: 1.25em 0; background: var(--scv-line); border: 0; }
-.scv-chat-markdown a { color: var(--scv-primary-dark); text-decoration-thickness: 1px; text-underline-offset: 3px; }
-.scv-chat-markdown a:hover { text-decoration-thickness: 2px; }
-.scv-chat-markdown code { padding: .12em .34em; color: var(--scv-ink); font-family: ui-monospace, SFMono-Regular, Consolas, monospace; font-size: .9em; background: color-mix(in srgb, var(--scv-primary-soft) 58%, var(--scv-panel)); border: 1px solid var(--scv-line); border-radius: 4px; }
-.scv-chat-markdown pre { max-width: 100%; margin: .9em 0; padding: 11px 12px; overflow-x: auto; color: var(--scv-ink); text-align: start; text-justify: auto; background: var(--scv-paper); border: 1px solid var(--scv-line); border-radius: 7px; overscroll-behavior-inline: contain; }
-.scv-chat-markdown pre code { padding: 0; font-size: 12px; line-height: 1.55; white-space: pre; background: transparent; border: 0; }
-.scv-chat-markdown table { display: block; width: max-content; min-width: 100%; max-width: 100%; overflow-x: auto; border-collapse: collapse; text-align: start; scrollbar-width: thin; }
-.scv-chat-markdown th, .scv-chat-markdown td { padding: 6px 8px; border: 1px solid var(--scv-line); }
-.scv-chat-markdown th { color: var(--scv-panel); background: var(--scv-primary-dark); }
-.scv-chat-markdown .katex { font-size: 1.04em; text-align: initial; text-justify: auto; }
-.scv-chat-markdown .katex-display { display: block; width: 100%; max-width: 100%; margin: 1.05em 0; padding: .5em 0 .68em; overflow-x: auto; overflow-y: hidden; font-size: 1.18em; text-align: center; scrollbar-width: thin; overscroll-behavior-inline: contain; }
-.scv-chat-markdown .katex-display > .katex { display: inline-block; width: max-content; min-width: max-content; text-align: initial; }
-.scv-chat-citations { margin-top: 18px; padding-top: 11px; font-size: 12px; border-top: 1px solid color-mix(in srgb, var(--scv-line) 72%, transparent); }
-.scv-chat-citations strong { color: var(--scv-ink-soft); font-size: 11px; font-weight: 600; letter-spacing: .025em; }
-.scv-chat-citations ul { display: flex; flex-wrap: wrap; gap: 6px; margin: 8px 0 4px; padding: 0; list-style: none; }
-.scv-chat-citations li { min-width: 0; max-width: 100%; }
-.scv-chat-citations a { display: block; max-width: 100%; padding: 4px 8px; overflow-wrap: anywhere; color: var(--scv-primary-dark); line-height: 1.35; text-decoration: none; background: var(--scv-primary-soft); border: 1px solid transparent; border-radius: 999px; transition: color .16s ease, background-color .16s ease, border-color .16s ease; }
-.scv-chat-citations a:hover { background: var(--scv-panel); border-color: var(--scv-primary); }
-.scv-chat-loading { min-height: 154px; padding: 17px 1px 9px; color: var(--scv-ink-soft); }
-.scv-chat-loading-label { display: block; margin-bottom: 13px; font-size: 11px; }
-.scv-chat-loading-lines { display: grid; gap: 9px; width: min(100%, 62ch); }
-.scv-chat-loading-lines i { display: block; height: 10px; background: linear-gradient(100deg, color-mix(in srgb, var(--scv-line) 72%, transparent) 25%, color-mix(in srgb, var(--scv-primary-soft) 88%, var(--scv-panel)) 45%, color-mix(in srgb, var(--scv-line) 72%, transparent) 65%); background-size: 220% 100%; border-radius: 999px; animation: scv-shimmer 1.8s ease-in-out infinite; }
-.scv-chat-loading-lines i:nth-child(2) { width: 94%; }
-.scv-chat-loading-lines i:nth-child(3) { width: 87%; }
-.scv-chat-loading-lines i:nth-child(4) { width: 58%; }
-.scv-chat-meta { color: var(--scv-ink-soft); font-size: 12px; }
-.scv-chat-error { padding: 10px; color: var(--scv-amber); background: var(--scv-amber-soft); border-radius: 6px; }
-.scv-chat-warnings { margin-top: 12px; font-size: 12px; color: var(--scv-ink-soft); }
-.scv-chat-warnings summary { cursor: pointer; color: var(--scv-amber); }
-.scv-chat-warnings ul { padding-left: 18px; }
-.scv-chat-composer { flex: none; padding: 10px 16px max(10px, env(safe-area-inset-bottom)); border-top: 1px solid var(--scv-line); background: var(--scv-chat-surface); }
-.scv-chat-composer-bar { position: relative; display: flex; min-width: 0; align-items: flex-end; border: 1px solid var(--scv-line); border-radius: 16px; background: var(--scv-chat-input); transition: border-color 150ms ease, box-shadow 150ms ease; }
-.scv-chat-composer-bar:focus-within { border-color: var(--scv-primary); box-shadow: 0 0 0 3px color-mix(in srgb, var(--scv-primary) 16%, transparent); }
-.scv-chat textarea { display: block; width: 100%; min-height: 44px; max-height: min(33dvh, 240px); resize: none; padding: 10px 52px 10px 13px; overflow: hidden; border: 0; outline: 0; border-radius: inherit; color: var(--scv-ink); background: transparent; font: inherit; line-height: 22px; transition: height 150ms ease; scrollbar-color: var(--scv-line) transparent; scrollbar-width: thin; }
-.scv-chat textarea::placeholder { color: var(--scv-ink-soft); opacity: .9; }
-.scv-chat button.scv-chat-action-button { position: absolute; right: 4px; bottom: 3px; display: grid; width: 38px; min-width: 38px; min-height: 38px; padding: 0; place-items: center; color: var(--scv-panel); background: var(--scv-primary-dark); border: 0; border-radius: 12px; }
-.scv-chat button.scv-chat-action-button:hover:not(:disabled) { filter: brightness(1.08); }
-.scv-chat-action-button svg { width: 20px; height: 20px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 2; }
-.scv-chat-stop-icon { width: 10px; height: 10px; background: currentColor; border-radius: 2px; }
-.scv-chat-disclaimer { margin: 7px auto 0; color: var(--scv-ink-soft); font-size: 10px; line-height: 1.35; text-align: center; }
-.scv-chat button:disabled, .scv-tools-toggle:disabled { opacity: .5; cursor: default; }
-.scv-chat-live { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
-.scv-chat-history-shell { display: flex; flex-direction: column; height: 100%; min-height: 0; color: var(--scv-ink); background: var(--scv-panel); font-size: 12px; }
-.scv-chat-history-actions { display: flex; min-width: 0; align-items: center; gap: 4px; padding: 7px 10px; overflow-x: auto; border-bottom: 1px solid var(--scv-line); scrollbar-width: thin; }
-.scv-chat-history-actions button { flex: none; font-size: 11px; }
-.scv-chat-history-actions button[aria-expanded="true"] { color: var(--scv-panel); background: var(--scv-primary); border-color: var(--scv-primary); }
-.scv-chat-history-actions button[aria-expanded="true"]:hover { background: var(--scv-primary-dark); border-color: var(--scv-primary-dark); }
-.scv-chat-history-actions > span { min-width: 0; margin-left: auto; overflow: hidden; color: var(--scv-ink-soft); font-size: 10px; text-overflow: ellipsis; white-space: nowrap; }
-.scv-chat-history-title { display: flex; min-height: 45px; align-items: center; justify-content: space-between; gap: 8px; padding: 8px 14px; background: var(--scv-chat-surface); border-bottom: 1px solid var(--scv-line); }
-.scv-chat-history-title strong { min-width: 0; overflow: hidden; font-size: 14px; font-weight: 600; text-overflow: ellipsis; white-space: nowrap; }
-.scv-chat-history-shell button { padding: 5px 8px; color: var(--scv-primary-dark); background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 5px; font: inherit; cursor: pointer; }
-.scv-chat-history-shell button:disabled { opacity: .5; cursor: default; }
-.scv-chat-history-content { flex: 1; min-height: 0; background: var(--scv-chat-surface); }
-.scv-chat-history-accordion { display: grid; flex: none; grid-template-rows: 0fr; visibility: hidden; opacity: 0; border-bottom: 0 solid var(--scv-line); transition: grid-template-rows 160ms ease, opacity 130ms ease, visibility 0s linear 160ms, border-width 160ms ease; }
-.scv-chat-history-accordion[data-expanded="true"] { grid-template-rows: 1fr; visibility: visible; opacity: 1; border-bottom-width: 1px; transition-delay: 0s; }
-.scv-chat-history-list { min-height: 0; max-height: min(30dvh, 230px); overflow: auto; padding: 0 12px; scrollbar-color: var(--scv-line) transparent; scrollbar-width: thin; transition: padding 160ms ease; }
-.scv-chat-history-accordion[data-expanded="true"] .scv-chat-history-list { padding-block: 8px; }
-.scv-chat-settings-accordion { display: grid; flex: none; grid-template-rows: 0fr; visibility: hidden; opacity: 0; border-bottom: 0 solid var(--scv-line); transition: grid-template-rows 160ms ease, opacity 130ms ease, visibility 0s linear 160ms, border-width 160ms ease; }
-.scv-chat-settings-accordion[data-expanded="true"] { grid-template-rows: 1fr; visibility: visible; opacity: 1; border-bottom-width: 1px; transition-delay: 0s; }
-.scv-chat-settings-content { min-height: 0; max-height: min(55dvh, 480px); padding: 0 12px; overflow: auto; scrollbar-color: var(--scv-line) transparent; scrollbar-width: thin; transition: padding 160ms ease; }
-.scv-chat-settings-accordion[data-expanded="true"] .scv-chat-settings-content { padding-block: 10px; }
-.scv-chat-history-list ul { margin: 0; padding: 0; list-style: none; }
-.scv-chat-history-list li { display: flex; gap: 5px; margin-bottom: 5px; border-radius: 6px; transition: background-color 140ms ease; }
-.scv-chat-history-list li:hover { background: var(--scv-chat-row-hover); }
-.scv-chat-history-list li > button { background: transparent; border-color: transparent; }
-.scv-chat-history-list li > button:first-child { display: flex; flex: 1; min-width: 0; justify-content: space-between; align-items: center; gap: 8px; text-align: left; }
-.scv-chat-history-list li span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.scv-chat-history-list time { flex-shrink: 0; font-size: 10px; color: var(--scv-ink-soft); }
-.scv-chat-history-list [aria-current="true"] { background: var(--scv-primary-soft); border-color: var(--scv-primary); }
-.scv-chat-history-list li:hover > button:first-child { background: transparent; border-color: transparent; }
-.scv-chat-history-shell button.scv-chat-history-delete { display: grid; flex: none; width: 32px; min-width: 32px; min-height: 32px; padding: 0; place-items: center; color: var(--scv-ink-soft); background: transparent; border-color: transparent; }
-.scv-chat-history-delete:hover:not(:disabled) { color: var(--scv-danger); background: transparent; border-color: transparent; }
-.scv-chat-delete-icon { width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.75; }
-.scv-chat-history-title form { width: 100%; }
-.scv-chat-history-title input { width: 100%; min-width: 0; padding: 5px 7px; color: var(--scv-ink); background: var(--scv-chat-input); border: 1px solid var(--scv-primary); border-radius: 5px; font: inherit; font-size: 14px; font-weight: 600; }
-.scv-chat-history-shell button.scv-chat-rename-button { display: grid; flex: none; width: 32px; min-height: 32px; padding: 0; place-items: center; color: var(--scv-ink-soft); background: transparent; border-color: transparent; }
-.scv-chat-rename-button svg { width: 17px; height: 17px; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.8; }
-.scv-chat-rename-button:hover:not(:disabled) { color: var(--scv-primary-dark); background: var(--scv-primary-soft); }
-.scv-chat-history-error { padding: 8px 12px; max-height: 180px; overflow: auto; color: var(--scv-amber); background: var(--scv-amber-soft); }
-.scv-chat-history-error p, .scv-chat-history-confirm p { margin: 0 0 6px; }
-.scv-chat-history-confirm { margin-top: 8px; padding: 8px; background: var(--scv-amber-soft); border-radius: 5px; }
-.scv-chat-corpus-warning { padding: 7px 9px; color: var(--scv-amber); background: var(--scv-amber-soft); border-radius: 5px; font-size: 12px; }
-.scv-chat-reference-warning { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-top: 10px; padding: 7px 9px; color: var(--scv-ink-soft); background: var(--scv-paper); border: 1px solid var(--scv-line); border-radius: 5px; font-size: 12px; }
-.scv-chat-reference-warning button { flex: none; border: 0; padding: 0 2px; color: inherit; background: transparent; font: inherit; font-size: 16px; line-height: 1; cursor: pointer; }
-.scv-chat-provenance { overflow-wrap: anywhere; }
-.scv-chat-provenance dd { margin: 0 0 6px; }
 
 /* Mobile first: the text keeps its width while the side panes slide over it. */
 .scv-search-toolbar { --scv-toolbar-button-size: 44px; grid-template-columns: auto minmax(0, 1fr) 44px 44px; }
@@ -824,8 +678,8 @@ body:has(> .scv-root) { overflow: hidden; }
 .scv-text-pane { height: 100%; min-height: 0; }
 .scv-root .scv-mobile-index-toggle, .scv-tools-toggle { position: absolute; z-index: 9; top: max(8px, env(safe-area-inset-top)); display: grid; width: 44px; min-width: 44px; height: 44px; min-height: 44px; place-items: center; padding: 0; color: var(--scv-primary-dark); font-weight: 800; background: var(--scv-panel); border: 1px solid var(--scv-line); border-radius: 6px; box-shadow: 0 3px 12px rgb(0 0 0 / 12%); cursor: pointer; }
 .scv-root .scv-mobile-index-toggle { left: 8px; }
-.scv-mobile-context { position: absolute; z-index: 8; top: max(8px, env(safe-area-inset-top)); right: 60px; left: 60px; display: grid; height: 44px; grid-template-columns: 5.5ch minmax(0, 1fr); align-items: center; gap: .3em; min-width: 0; padding: 0 9px; color: var(--scv-ink); font-size: 13px; background: color-mix(in srgb, var(--scv-panel) 78%, transparent); border: 1px solid var(--scv-line); border-radius: 6px; backdrop-filter: blur(8px); pointer-events: none; }
-.scv-mobile-context strong { overflow: hidden; text-overflow: ellipsis; text-align: left; white-space: nowrap; font-variant-numeric: tabular-nums; }
+.scv-mobile-context { position: absolute; z-index: 8; top: max(8px, env(safe-area-inset-top)); right: 60px; left: 60px; display: grid; height: 44px; grid-template-columns: 5.5ch minmax(0, 1fr); align-items: center; gap: .3em; min-width: 0; padding: 0 9px; color: var(--scv-ink); font-size: 13px; background: color-mix(in srgb, var(--scv-panel) 78%, transparent); border: 1px solid var(--scv-line); border-radius: 6px; backdrop-filter: blur(8px); pointer-events: none; }
+.scv-mobile-context strong { overflow: hidden; text-overflow: ellipsis; text-align: left; white-space: nowrap; font-variant-numeric: tabular-nums; }
 .scv-mobile-context span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .scv-mobile-index-toggle svg { width: 22px; height: 22px; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; }
 .scv-tools-toggle { right: 8px; bottom: auto; max-width: none; font-size: 14px; }
@@ -842,27 +696,11 @@ body:has(> .scv-root) { overflow: hidden; }
 .scv-scroll-overlay span { display: none; }
 .scv-root .scv-copy-asset { width: 36px; height: 36px; opacity: 1; transform: none; }
 .scv-root .figure-asset.scv-copyable-asset { padding-top: 46px; }
-.scv-tools-header button, .scv-chat button, .scv-chat-history-shell button { min-height: 44px; }
+.scv-tools-header button { min-height: 44px; }
 .scv-tools-header button.scv-tools-close { width: 44px; min-width: 44px; height: 44px; min-height: 44px; }
 .scv-tools-header { flex-wrap: nowrap; overflow-x: auto; padding: 6px 8px; }
-.scv-tools-header [role="tablist"] { flex: none; }
-.scv-chat-history-actions { gap: 4px; padding-inline: 6px; overflow-x: hidden; }
-.scv-chat-history-actions button { flex: 1 1 0; min-width: 0; padding-inline: 6px; }
-.scv-chat button.scv-chat-action-button, .scv-chat-history-shell button.scv-chat-rename-button { width: 44px; min-width: 44px; min-height: 44px; }
-.scv-chat button.scv-chat-action-button { right: 3px; bottom: 3px; }
-.scv-chat textarea { min-height: 50px; padding-right: 54px; }
-.scv-chat-composer { padding-bottom: max(10px, env(safe-area-inset-bottom)); }
-.scv-chat-history-title { padding-block: 4px; }
-.scv-block p, .scv-root .scv-note-content > p, .scv-root .scv-note-list-item, .scv-root .table-notes > p, .scv-label-list-content > .leading-label-description, .scv-label-list-content > .leading-math-description { text-align: left; }
-.scv-chat-messages { padding: 14px 12px 18px; }
-.scv-chat-question { padding: 9px 10px; }
-.scv-chat-answer { padding-top: 14px; }
-.scv-chat-markdown { width: 100%; font-size: 13.5px; line-height: 1.65; }
-.scv-chat-markdown h2 { font-size: 1.18em; }
-.scv-chat-markdown h3 { font-size: 1.09em; }
-.scv-chat-markdown .katex-display { margin: .9em 0; }
-.scv-chat-composer { padding: 10px 12px 12px; }
-.scv-chat-loading { min-height: 146px; }
+.scv-tools-header [role="tablist"] { flex: none; }
+.scv-block p, .scv-root .scv-note-content > p, .scv-root .scv-note-list-item, .scv-root .table-notes > p, .scv-label-list-content > .leading-label-description, .scv-label-list-content > .leading-math-description { text-align: left; }
 
 @media (max-width: 767.98px) {
   .scv-annotation-menu { top: auto !important; right: 8px; bottom: max(8px, env(safe-area-inset-bottom)); left: 8px !important; min-width: 0; padding: 8px; border-radius: 12px; }
@@ -921,7 +759,4 @@ body:has(> .scv-root) { overflow: hidden; }
 
 @media (prefers-reduced-motion: reduce) {
   .scv-root *, .scv-root *::before, .scv-root *::after { scroll-behavior: auto !important; animation-duration: .01ms !important; animation-iteration-count: 1 !important; transition-duration: .01ms !important; }
-  .scv-chat-answer-enter { animation: none; }
-  .scv-chat-loading-lines i { animation: none; background-position: 0 0; }
-  .scv-chat textarea, .scv-chat-history-accordion, .scv-chat-history-list, .scv-chat-settings-accordion, .scv-chat-settings-content { transition: none; }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "structural-codes-viewer",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Reference React UI and deterministic artifact client for the structural-codes corpus.",
   "license": "LGPL-2.1-or-later",
   "homepage": "https://github.com/claudiopagani/structural-codes#readme",
@@ -28,27 +28,7 @@
       "import": "./package-dist/corpusData.js",
       "default": "./package-dist/corpusData.js"
     },
-    "./chatntc": {
-      "types": "./package-dist/chatntc/index.d.ts",
-      "import": "./package-dist/chatntc/index.js",
-      "default": "./package-dist/chatntc/index.js"
-    },
-    "./chatntc/viewer-artifacts": {
-      "types": "./package-dist/chatntc/viewerArtifacts.d.ts",
-      "import": "./package-dist/chatntc/viewerArtifacts.js",
-      "default": "./package-dist/chatntc/viewerArtifacts.js"
-    },
     "./package.json": "./package.json",
-    "./chatntc-ui": {
-      "types": "./package-dist/chatntc-ui/index.d.ts",
-      "import": "./package-dist/chatntc-ui/index.js",
-      "default": "./package-dist/chatntc-ui/index.js"
-    },
-    "./chatntc-history": {
-      "types": "./package-dist/chatntc-history/index.d.ts",
-      "import": "./package-dist/chatntc-history/index.js",
-      "default": "./package-dist/chatntc-history/index.js"
-    },
     "./annotations": {
       "types": "./package-dist/annotations/index.d.ts",
       "import": "./package-dist/annotations/index.js",
@@ -66,29 +46,13 @@
     "test:consumer": "node scripts/test-consumer.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "dev": "npm run sync:corpus && vinext dev",
-    "dev:chatntc": "npm run sync:corpus && node scripts/dev-chatntc.mjs",
     "build": "npm run sync:corpus && vinext build",
     "start": "vinext start",
     "performance:baseline": "npm run build && node scripts/performance-baseline.mjs",
     "performance:search": "npm run sync:corpus && node scripts/search-performance.mjs",
-    "test:chatntc": "npm run build:library && npm run sync:corpus && node --test tests/chatntc-core.test.mjs tests/chatntc-artifacts.test.mjs",
-    "build:chatntc-test": "tsc -p tsconfig.chatntc-test.json",
-    "test:chatntc-server": "npm run sync:corpus && npm run build:chatntc-test && node --conditions=react-server --test tests/chatntc-server.test.mjs tests/chatntc-semantic-retrieval.test.mjs tests/chatntc-semantic-runtime.test.mjs tests/chatntc-rank-fusion.test.mjs",
-    "build:chatntc-retrieval-benchmark": "tsc -p tsconfig.retrieval-benchmark.json",
-    "chatntc:retrieval:benchmark": "npm run sync:corpus && npm run build:chatntc-retrieval-benchmark && node --conditions=react-server .local/chatntc-retrieval-benchmark-tool/scripts/benchmark-chatntc-retrieval.js",
-    "test:chatntc-retrieval-benchmark": "npm run build:chatntc-test && node --conditions=react-server --test tests/chatntc-retrieval-benchmark.test.mjs",
-    "build:chatntc-semantic-tool": "tsc -p tsconfig.semantic-tool.json",
-    "chatntc:semantic:tokenizer:setup": "npm run build:chatntc-semantic-tool && node .local/chatntc-semantic-tool/scripts/setup-bge-m3-tokenizer.js",
-    "chatntc:semantic:audit-lengths": "npm run sync:corpus && npm run build:chatntc-semantic-tool && node .local/chatntc-semantic-tool/scripts/audit-chatntc-semantic-lengths.js",
-    "chatntc:semantic:audit-chunks": "npm run sync:corpus && npm run build:chatntc-semantic-tool && node .local/chatntc-semantic-tool/scripts/audit-chatntc-semantic-chunks.js",
-    "chatntc:semantic:index": "npm run sync:corpus && npm run build:chatntc-semantic-tool && node .local/chatntc-semantic-tool/scripts/generate-chatntc-semantic-index.js",
-    "chatntc:semantic:validate": "npm run sync:corpus && npm run build:chatntc-semantic-tool && node .local/chatntc-semantic-tool/scripts/generate-chatntc-semantic-index.js --validate-only",
-    "test:chatntc-semantic": "npm run sync:corpus && npm run build:chatntc-semantic-tool && node --test tests/chatntc-semantic.test.mjs tests/chatntc-bge-m3-http-embedding.test.mjs",
-    "test": "npm run build:library && npm run build && node --test tests/rendered-html.test.mjs tests/comparison-viewer.test.mjs tests/performance-phase-one.test.mjs tests/global-scrubber.test.mjs tests/search-phase-two.test.mjs tests/cross-reference-phase-three.test.mjs tests/lazy-navigation-consolidation.test.mjs tests/package-boundary.test.mjs tests/ntc-latex-corpus.test.mjs tests/chatntc-core.test.mjs tests/chatntc-artifacts.test.mjs tests/chatntc-route.test.mjs tests/chatntc-history.test.mjs tests/annotations.test.mjs && npm run test:chatntc-semantic && npm run build:chatntc-test && node --conditions=react-server --test tests/chatntc-server.test.mjs tests/chatntc-semantic-retrieval.test.mjs tests/chatntc-semantic-runtime.test.mjs tests/chatntc-rank-fusion.test.mjs tests/chatntc-retrieval-benchmark.test.mjs && npm run test:chatntc-ui",
+    "test": "npm run build:library && npm run build && node --test tests/*.test.mjs",
     "lint": "eslint . --ignore-pattern dist --ignore-pattern package-dist --ignore-pattern .next --max-warnings 0",
-    "check": "npm run lint && npm test",
-    "test:chatntc-ui": "npm run sync:corpus && node scripts/build-chatntc-ui-test.mjs && node --test tests/chatntc-ui.test.mjs",
-    "test:chatntc-history": "npm run build:library && node --test tests/chatntc-history.test.mjs",
+    "check": "npm run typecheck && npm run lint && npm test",
     "test:annotations": "npm run build:library && node --test tests/annotations.test.mjs"
   },
   "peerDependencies": {
@@ -97,14 +61,9 @@
   },
   "dependencies": {
     "@fontsource/tinos": "^5.3.0",
-    "katex": "^0.16.22",
-    "react-markdown": "^10.1.0",
-    "rehype-katex": "^7.0.1",
-    "remark-gfm": "^4.0.1",
-    "remark-math": "^6.0.0"
+    "katex": "^0.16.22"
   },
   "devDependencies": {
-    "@huggingface/tokenizers": "^0.2.0",
     "structural-codes": "file:..",
     "next": "16.3.6",
     "pdfjs-dist": "6.2.108",
@@ -120,7 +79,6 @@
     "fake-indexeddb": "6.2.5",
     "jsdom": "26.1.0",
     "react-server-dom-webpack": "19.2.8",
-    "server-only": "0.0.1",
     "typescript": "5.9.3",
     "vinext": "1.0.0-beta.8",
     "vite": "8.1.5"

package/package-dist/chatntc/canonicalization.d.ts

@@ -1,15 +0,0 @@
-import type { ChatNTCCanonicalizationResult, ChatNTCEvidencePackage, ChatNTCProviderOutput, ChatNTCRepository, ChatNTCVerifiedReference } from "./types.js";
-interface TextualReference {
-    text: string;
-    path: string;
-}
-/** Internal observation used by the server pipeline; it is not part of the public response. */
-export interface ChatNTCResolvedTextualReference extends TextualReference {
-    target: ChatNTCVerifiedReference;
-}
-/**
- * Converts a small provider response into the rich public response. Explicit references in
- * prose and in references[] are resolved against the repository; provider metadata is never trusted.
- */
-export declare function canonicalizeChatNTCResponse(output: ChatNTCProviderOutput, evidence: ChatNTCEvidencePackage, repository: ChatNTCRepository, observeResolvedReference?: (reference: ChatNTCResolvedTextualReference) => void): Promise<ChatNTCCanonicalizationResult>;
-export {};