@zephytiju/prism-quick-files 0.1.0

package/dist/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;KACtF,CAAC;CACH;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,iBAAiB,CAUtF"}

package/dist/clients.js

@@ -0,0 +1,13 @@
+import { createFileEntryClient } from "@zephytiju/lattice-common-interfaces";
+/** Builds the interface clients bound to the host Lattice transport. */
+export function createQuickFilesClients(transport) {
+    const files = createFileEntryClient(transport);
+    return {
+        files: {
+            list: async (request) => {
+                const result = await files.list(request ?? {});
+                return result;
+            },
+        },
+    };
+}

package/dist/dragState.d.ts

@@ -0,0 +1,20 @@
+import type { QuickFileDragState, QuickFileEntry } from "./types.js";
+/** Component-scoped Prism channel carrying the bounded drag/insert state (D6). */
+export declare const DRAG_STATE_CHANNEL = "quick-files.drag-state";
+/**
+ * Builds the bounded drag/insert state for an entry (D6 reference case): file
+ * metadata only — NEVER a component reference. Mime falls back to the kind's
+ * default, the snapshot reference to the entry id.
+ */
+export declare function buildQuickFileDragState(entry: QuickFileEntry): QuickFileDragState;
+/**
+ * Drag-state publication wiring for the panel: returns the setter-only
+ * publisher for {@link DRAG_STATE_CHANNEL} and installs the panel-side half
+ * of "ESC or dragging outside any target cancels" — ESC clears any in-flight
+ * drag/insert session.
+ *
+ * Setter-only publication means the panel never re-renders from channel
+ * state — it is a pure publisher (receivers own the interpretation).
+ */
+export declare function useQuickFileDragStatePublish(): (next: QuickFileDragState | null) => void;
+//# sourceMappingURL=dragState.d.ts.map

package/dist/dragState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragState.d.ts","sourceRoot":"","sources":["../src/dragState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAgB3D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAUjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,8CAgB3C"}

package/dist/dragState.js

@@ -0,0 +1,56 @@
+import { useEffect } from "react";
+import { usePrismStateSetter } from "@zephytiju/prism-react";
+/** Component-scoped Prism channel carrying the bounded drag/insert state (D6). */
+export const DRAG_STATE_CHANNEL = "quick-files.drag-state";
+/**
+ * Default kind → bounded mime mapping for the drag state (hosts override per
+ * entry through the route's superset projection).
+ */
+const DEFAULT_MIME_BY_KIND = {
+    "world-view": "application/x-geovision-view",
+    dossier: "application/x-dossier",
+    "evidence-pack": "application/x-evidence-pack",
+    board: "application/x-fluxboard",
+    folder: "inode/directory",
+};
+const GENERIC_MIME = "application/octet-stream";
+/**
+ * Builds the bounded drag/insert state for an entry (D6 reference case): file
+ * metadata only — NEVER a component reference. Mime falls back to the kind's
+ * default, the snapshot reference to the entry id.
+ */
+export function buildQuickFileDragState(entry) {
+    const mime = entry.mime ?? DEFAULT_MIME_BY_KIND[entry.kind] ?? GENERIC_MIME;
+    return {
+        entryId: entry.id,
+        kind: entry.kind,
+        name: entry.name,
+        mime,
+        snapshotRef: entry.snapshotRef ?? entry.id,
+        sourcePanel: "quick-files",
+    };
+}
+/**
+ * Drag-state publication wiring for the panel: returns the setter-only
+ * publisher for {@link DRAG_STATE_CHANNEL} and installs the panel-side half
+ * of "ESC or dragging outside any target cancels" — ESC clears any in-flight
+ * drag/insert session.
+ *
+ * Setter-only publication means the panel never re-renders from channel
+ * state — it is a pure publisher (receivers own the interpretation).
+ */
+export function useQuickFileDragStatePublish() {
+    const publishDragState = usePrismStateSetter(DRAG_STATE_CHANNEL);
+    useEffect(() => {
+        const onKeyDown = (event) => {
+            if (event.key === "Escape") {
+                publishDragState(null);
+            }
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return () => {
+            window.removeEventListener("keydown", onKeyDown);
+        };
+    }, [publishDragState]);
+    return publishDragState;
+}

package/dist/icons.d.ts

@@ -0,0 +1,35 @@
+/**
+ * File-kind icons of the Quick File Insert panel — faithful vector copies of
+ * the authoritative v9 HTML prototype's `.fic` glyph set (world view globe,
+ * dossier/evidence document, board, folder). Icons inherit their color from
+ * `currentColor`, so each kind's hue resolves to a SEMANTIC theme token
+ * supplied by the host's MantineProvider (never a hardcoded color).
+ */
+import type React from "react";
+import type { QuickFileGlyph } from "./types.js";
+/** World view — globe with meridians (prototype `.ic-world`). */
+export declare function WorldIcon(): React.ReactElement;
+/** Dossier doc / evidence pack — outlined document page (prototype `.ic-doc`). */
+export declare function DocIcon(): React.ReactElement;
+/** Workflow board — connected kanban squares (prototype's WF row glyph). */
+export declare function BoardWorkflowIcon(): React.ReactElement;
+/** Audit board — append-only chain squares (prototype's AC row glyph). */
+export declare function BoardAuditIcon(): React.ReactElement;
+/** Folder — pinned common-assets folder (prototype `.ic-folder`). */
+export declare function FolderIcon(): React.ReactElement;
+/** Search magnifier of the panel's search box (prototype ⌕ glyph). */
+export declare function SearchGlyph(): React.ReactElement;
+/** Renders the glyph for a kind (boards honor the entry's glyph override). */
+export declare function FileKindIcon({ glyph, }: {
+    readonly glyph: QuickFileGlyph;
+}): React.ReactElement;
+/** Default kind → glyph resolution (boards default to the workflow glyph). */
+export declare const DEFAULT_KIND_GLYPHS: Readonly<Record<string, QuickFileGlyph>>;
+/**
+ * Default kind → semantic color token mapping, mirroring the v9 prototype's
+ * icon hues onto theme tokens: purple world views → `signal`, mint docs →
+ * `ok`, amber boards → `warn`, blue folders → `accent`. Hosts override
+ * through the `kindTokens` configuration key.
+ */
+export declare const DEFAULT_KIND_TOKENS: Readonly<Record<string, string>>;
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,iEAAiE;AACjE,wBAAgB,SAAS,IAAI,KAAK,CAAC,YAAY,CAkB9C;AAED,kFAAkF;AAClF,wBAAgB,OAAO,IAAI,KAAK,CAAC,YAAY,CAc5C;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI,KAAK,CAAC,YAAY,CAoBtD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,KAAK,CAAC,YAAY,CAoBnD;AAED,qEAAqE;AACrE,wBAAgB,UAAU,IAAI,KAAK,CAAC,YAAY,CAmB/C;AAED,sEAAsE;AACtE,wBAAgB,WAAW,IAAI,KAAK,CAAC,YAAY,CAOhD;AAUD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,EAC3B,KAAK,GACN,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,GAAG,KAAK,CAAC,YAAY,CAGrB;AAED,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAMxE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhE,CAAC"}

package/dist/icons.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** World view — globe with meridians (prototype `.ic-world`). */
+export function WorldIcon() {
+    return (_jsxs("svg", { width: "26", height: "26", viewBox: "0 0 30 30", fill: "none", "aria-hidden": "true", style: { flexShrink: 0 }, children: [_jsx("circle", { cx: "15", cy: "15", r: "12", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "M3 15h24M15 3c4 4 4 20 0 24M15 3c-4 4-4 20 0 24", stroke: "currentColor", strokeWidth: "1.6" })] }));
+}
+/** Dossier doc / evidence pack — outlined document page (prototype `.ic-doc`). */
+export function DocIcon() {
+    return (_jsxs("svg", { width: "24", height: "27", viewBox: "0 0 28 32", fill: "none", "aria-hidden": "true", style: { flexShrink: 0 }, children: [_jsx("path", { d: "M4 2h13l7 7v21H4z", stroke: "currentColor", strokeWidth: "2", strokeLinejoin: "round" }), _jsx("path", { d: "M17 2v7h7M8 14h10M8 19h10M8 24h6", stroke: "currentColor", strokeWidth: "1.6" })] }));
+}
+/** Workflow board — connected kanban squares (prototype's WF row glyph). */
+export function BoardWorkflowIcon() {
+    return (_jsxs("svg", { width: "26", height: "26", viewBox: "0 0 30 30", fill: "none", "aria-hidden": "true", style: { flexShrink: 0 }, children: [_jsx("rect", { x: "2", y: "2", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("rect", { x: "19", y: "11", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("rect", { x: "2", y: "19", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "M11 6.5h5.5A2.5 2.5 0 0 1 19 9v2M19 20.5h-5.5A2.5 2.5 0 0 1 11 18v-5", stroke: "currentColor", strokeWidth: "2" })] }));
+}
+/** Audit board — append-only chain squares (prototype's AC row glyph). */
+export function BoardAuditIcon() {
+    return (_jsxs("svg", { width: "26", height: "26", viewBox: "0 0 30 30", fill: "none", "aria-hidden": "true", style: { flexShrink: 0 }, children: [_jsx("rect", { x: "2", y: "2", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("rect", { x: "19", y: "2", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("rect", { x: "10", y: "19", width: "9", height: "9", rx: "1.5", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "M11 11v3a2 2 0 0 0 2 2h3M15 7h4M7 11v8", stroke: "currentColor", strokeWidth: "2" })] }));
+}
+/** Folder — pinned common-assets folder (prototype `.ic-folder`). */
+export function FolderIcon() {
+    return (_jsxs("svg", { width: "26", height: "26", viewBox: "0 0 30 30", fill: "none", "aria-hidden": "true", style: { flexShrink: 0 }, children: [_jsx("path", { d: "M2 5h9l3 3h14v18H2z", stroke: "currentColor", strokeWidth: "2", strokeLinejoin: "round" }), _jsx("path", { d: "M2 12h26", stroke: "currentColor", strokeWidth: "2" })] }));
+}
+/** Search magnifier of the panel's search box (prototype ⌕ glyph). */
+export function SearchGlyph() {
+    return (_jsxs("svg", { width: "16", height: "16", viewBox: "0 0 20 20", fill: "none", "aria-hidden": "true", children: [_jsx("circle", { cx: "8.5", cy: "8.5", r: "5.6", stroke: "currentColor", strokeWidth: "1.6" }), _jsx("path", { d: "M12.6 12.6l4.4 4.4", stroke: "currentColor", strokeWidth: "1.6", strokeLinecap: "round" })] }));
+}
+const GLYPHS = {
+    world: WorldIcon,
+    doc: DocIcon,
+    "board-workflow": BoardWorkflowIcon,
+    "board-audit": BoardAuditIcon,
+    folder: FolderIcon,
+};
+/** Renders the glyph for a kind (boards honor the entry's glyph override). */
+export function FileKindIcon({ glyph, }) {
+    const Component = GLYPHS[glyph] ?? DocIcon;
+    return _jsx(Component, {});
+}
+/** Default kind → glyph resolution (boards default to the workflow glyph). */
+export const DEFAULT_KIND_GLYPHS = {
+    "world-view": "world",
+    dossier: "doc",
+    "evidence-pack": "doc",
+    board: "board-workflow",
+    folder: "folder",
+};
+/**
+ * Default kind → semantic color token mapping, mirroring the v9 prototype's
+ * icon hues onto theme tokens: purple world views → `signal`, mint docs →
+ * `ok`, amber boards → `warn`, blue folders → `accent`. Hosts override
+ * through the `kindTokens` configuration key.
+ */
+export const DEFAULT_KIND_TOKENS = {
+    "world-view": "signal",
+    dossier: "ok",
+    "evidence-pack": "ok",
+    board: "warn",
+    folder: "accent",
+};

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { QuickFiles } from "./QuickFiles.js";
+export type { QuickFilesProps } from "./QuickFiles.js";
+export { createQuickFilesClients } from "./clients.js";
+export type { QuickFilesClients } from "./clients.js";
+export { FileRow } from "./FileRow.js";
+export type { FileRowProps } from "./FileRow.js";
+export { BoardAuditIcon, BoardWorkflowIcon, DEFAULT_KIND_GLYPHS, DEFAULT_KIND_TOKENS, DocIcon, FileKindIcon, FolderIcon, SearchGlyph, WorldIcon, } from "./icons.js";
+export { en, zhCN, locales, stringsForLocale, formatMessage } from "./locales/index.js";
+export type { QuickFilesLocale, QuickFilesStrings } from "./locales/index.js";
+export type { QuickFileDragState, QuickFileEntry, QuickFileEntryListResult, QuickFileGlyph, QuickFileKind, QuickFileListRequest, QuickFilesStatus, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { QuickFiles } from "./QuickFiles.js";
+export { createQuickFilesClients } from "./clients.js";
+export { FileRow } from "./FileRow.js";
+export { BoardAuditIcon, BoardWorkflowIcon, DEFAULT_KIND_GLYPHS, DEFAULT_KIND_TOKENS, DocIcon, FileKindIcon, FolderIcon, SearchGlyph, WorldIcon, } from "./icons.js";
+export { en, zhCN, locales, stringsForLocale, formatMessage } from "./locales/index.js";

package/dist/locales/en.json

@@ -0,0 +1,20 @@
+{
+  "quick-files": {
+    "panelTitle": "QUICK FILE INSERT",
+    "panelSubtitle": "WORLD VIEWS, DOSSIERS, BOARDS, EVIDENCE",
+    "trailingMetaCount": "{count} FILES",
+    "searchPlaceholder": "Search recent files and world views",
+    "searchLabel": "Search files",
+    "sectionHint": "FILES ARE THE SHORTCUT",
+    "sectionRecent": "RECENT / COMMON FILES",
+    "infoCardTitle": "DROP-IN FILE MODEL",
+    "infoCardBody": "World views are versioned spatial metadata files. Insert one here to reload its saved selection, time, layers, camera, and scenario inside the dossier. Component types remain in each block's + menu.",
+    "insertLabel": "Insert {name}",
+    "dragLabel": "Drag {name} to insert",
+    "emptyTitle": "No files yet",
+    "emptyHint": "Files from VAULT appear here once opened or pinned.",
+    "noMatches": "No files match the search.",
+    "errorTitle": "File listing failed",
+    "retry": "Retry"
+  }
+}

package/dist/locales/index.d.ts

@@ -0,0 +1,72 @@
+import enBundle from "./en.json";
+/**
+ * Locales the quick-files micro-UI bundles. Every component-fixed UI string
+ * is resolved from these bundles (statically imported, resolveJsonModule); the
+ * component never hardcodes copy. Configuration-provided strings (title,
+ * subtitle, trailing meta, …) stay composition-authored — Prism has no
+ * composed title node, so the panel's title header renders from component
+ * configuration keys with locale defaults.
+ */
+export type QuickFilesLocale = "en" | "zh-CN";
+/**
+ * The per-locale string table — the keys of the en bundle. Declared widened
+ * (string values) so the zh-CN bundle is checked for exact key parity at
+ * compile time while keeping literal JSON types out of the public surface.
+ */
+export type QuickFilesStrings = {
+    readonly [K in keyof typeof enBundle["quick-files"]]: string;
+};
+/** Parsed en locale bundle (namespaced under the component id "quick-files"). */
+export declare const en: {
+    "quick-files": {
+        panelTitle: string;
+        panelSubtitle: string;
+        trailingMetaCount: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        sectionHint: string;
+        sectionRecent: string;
+        infoCardTitle: string;
+        infoCardBody: string;
+        insertLabel: string;
+        dragLabel: string;
+        emptyTitle: string;
+        emptyHint: string;
+        noMatches: string;
+        errorTitle: string;
+        retry: string;
+    };
+};
+/** Parsed zh-CN locale bundle (namespaced under the component id "quick-files"). */
+export declare const zhCN: {
+    "quick-files": {
+        panelTitle: string;
+        panelSubtitle: string;
+        trailingMetaCount: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        sectionHint: string;
+        sectionRecent: string;
+        infoCardTitle: string;
+        infoCardBody: string;
+        insertLabel: string;
+        dragLabel: string;
+        emptyTitle: string;
+        emptyHint: string;
+        noMatches: string;
+        errorTitle: string;
+        retry: string;
+    };
+};
+/** All bundled locale bundles keyed by locale id — for downstream deep-merge. */
+export declare const locales: Record<QuickFilesLocale, {
+    readonly "quick-files": QuickFilesStrings;
+}>;
+/** Resolves the string table for a locale. */
+export declare function stringsForLocale(locale: QuickFilesLocale): QuickFilesStrings;
+/**
+ * Simple `{placeholder}` interpolation (e.g. `"{count} FILES"` + count).
+ * Placeholder-for-value substitution only — no ICU, no regexes.
+ */
+export declare function formatMessage(template: string, values: Readonly<Record<string, string | number>>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/locales/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAC;AAGjC;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,CAAC,IAAI,MAAM,OAAO,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM;CAC7D,CAAC;AAOF,iFAAiF;AACjF,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAE3B,oFAAoF;AACpF,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;CAAa,CAAC;AAE/B,iFAAiF;AACjF,eAAO,MAAM,OAAO;4BAZ8C,iBAAiB;EAYrD,CAAC;AAE/B,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAE5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAChD,MAAM,CAMR"}

package/dist/locales/index.js

@@ -0,0 +1,27 @@
+import enBundle from "./en.json";
+import zhCNBundle from "./zh-CN.json";
+const bundles = {
+    en: enBundle,
+    "zh-CN": zhCNBundle,
+};
+/** Parsed en locale bundle (namespaced under the component id "quick-files"). */
+export const en = enBundle;
+/** Parsed zh-CN locale bundle (namespaced under the component id "quick-files"). */
+export const zhCN = zhCNBundle;
+/** All bundled locale bundles keyed by locale id — for downstream deep-merge. */
+export const locales = bundles;
+/** Resolves the string table for a locale. */
+export function stringsForLocale(locale) {
+    return bundles[locale]["quick-files"];
+}
+/**
+ * Simple `{placeholder}` interpolation (e.g. `"{count} FILES"` + count).
+ * Placeholder-for-value substitution only — no ICU, no regexes.
+ */
+export function formatMessage(template, values) {
+    let result = template;
+    for (const [key, value] of Object.entries(values)) {
+        result = result.replaceAll(`{${key}}`, String(value));
+    }
+    return result;
+}

package/dist/locales/zh-CN.json

@@ -0,0 +1,20 @@
+{
+  "quick-files": {
+    "panelTitle": "快速插入文件",
+    "panelSubtitle": "世界视图 · 卷宗 · 看板 · 证据",
+    "trailingMetaCount": "{count} 个文件",
+    "searchPlaceholder": "搜索最近的文件与世界视图",
+    "searchLabel": "搜索文件",
+    "sectionHint": "文件即捷径",
+    "sectionRecent": "最近 / 常用文件",
+    "infoCardTitle": "置入文件模型",
+    "infoCardBody": "世界视图是带版本的空间元数据文件。在此插入即可在卷宗内恢复其保存的选择、时间、图层、相机与情景。组件类型仍保留在每个区块的 + 菜单中。",
+    "insertLabel": "插入 {name}",
+    "dragLabel": "拖动 {name} 以插入",
+    "emptyTitle": "暂无文件",
+    "emptyHint": "来自 VAULT 的文件在打开或固定后会显示在此。",
+    "noMatches": "没有符合搜索条件的文件。",
+    "errorTitle": "文件列表加载失败",
+    "retry": "重试"
+  }
+}

package/dist/tokens.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared semantic token constants of the quick-files micro-UI.
+ *
+ * No palette is hardcoded anywhere in the component: every constant below
+ * resolves to a SEMANTIC theme token (text / muted / card / card-dark /
+ * input / border / line / accent …) supplied by the host's MantineProvider.
+ * The sub-components import these instead of redeclaring them, keeping the
+ * component's entire token surface in one auditable place.
+ */
+export declare const MONO = "var(--mantine-font-family-monospace)";
+export declare const TEXT = "var(--mantine-color-text-filled)";
+export declare const MUTED = "var(--mantine-color-muted-filled)";
+export declare const INPUT_BG = "var(--mantine-color-card-dark-filled)";
+export declare const CARD_BG = "var(--mantine-color-card-filled)";
+export declare const CARD_DARK_BG = "var(--mantine-color-card-dark-filled)";
+export declare const BORDER = "var(--mantine-color-border-filled)";
+export declare const LINE = "var(--mantine-color-line-filled)";
+export declare const ACCENT = "var(--mantine-color-accent-filled)";
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,IAAI,qCAAqC,CAAC;AACvD,eAAO,MAAM,KAAK,sCAAsC,CAAC;AACzD,eAAO,MAAM,QAAQ,0CAA0C,CAAC;AAChE,eAAO,MAAM,OAAO,qCAAqC,CAAC;AAC1D,eAAO,MAAM,YAAY,0CAA0C,CAAC;AACpE,eAAO,MAAM,MAAM,uCAAuC,CAAC;AAC3D,eAAO,MAAM,IAAI,qCAAqC,CAAC;AACvD,eAAO,MAAM,MAAM,uCAAuC,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,18 @@
+/**
+ * Shared semantic token constants of the quick-files micro-UI.
+ *
+ * No palette is hardcoded anywhere in the component: every constant below
+ * resolves to a SEMANTIC theme token (text / muted / card / card-dark /
+ * input / border / line / accent …) supplied by the host's MantineProvider.
+ * The sub-components import these instead of redeclaring them, keeping the
+ * component's entire token surface in one auditable place.
+ */
+export const MONO = "var(--mantine-font-family-monospace)";
+export const TEXT = "var(--mantine-color-text-filled)";
+export const MUTED = "var(--mantine-color-muted-filled)";
+export const INPUT_BG = "var(--mantine-color-card-dark-filled)";
+export const CARD_BG = "var(--mantine-color-card-filled)";
+export const CARD_DARK_BG = "var(--mantine-color-card-dark-filled)";
+export const BORDER = "var(--mantine-color-border-filled)";
+export const LINE = "var(--mantine-color-line-filled)";
+export const ACCENT = "var(--mantine-color-accent-filled)";

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Bounded types of the quick-files micro-UI (component id "quick-files") —
+ * the Dossier Quick File Insert side-panel axiom component.
+ *
+ * Every value that crosses a Prism channel or a Lattice route here is an
+ * identifier or a bounded projection (design record D4/D6/D8): wiring carries
+ * identifiers and bounded values, never domain object graphs — each receiver
+ * (editor viewport, evidence pack, another panel) fetches its own domain data
+ * and interprets the published drag state in its own way.
+ */
+import type { FileEntryListRequest, FileEntrySummary } from "@zephytiju/lattice-common-interfaces";
+/**
+ * File kinds the panel categorizes (matching the panel's title subtitle:
+ * WORLD VIEWS, DOSSIERS, BOARDS, EVIDENCE — plus pinned folders). The value
+ * is the IFileEntry `kind` string; unknown kinds still render (generic file
+ * row) and fall back to the generic inline-link interpretation downstream.
+ */
+export type QuickFileKind = "world-view" | "dossier" | "board" | "evidence-pack" | "folder";
+/**
+ * Icon glyph rendered for a row — the prototype's `.fic` set. Boards carry
+ * two glyphs (workflow kanban, append-only audit chain); entries pick via the
+ * optional `glyph` field, other kinds resolve by `kind`.
+ */
+export type QuickFileGlyph = "world" | "doc" | "board-workflow" | "board-audit" | "folder";
+/**
+ * Bounded file row projection of an IFileEntry list entry. Extends the
+ * generated bundle's `FileEntrySummary` shape (id/name/kind/sizeBytes) with
+ * the bounded fields the panel renders and the drag state needs (mime,
+ * snapshotRef, mono meta line, pinning, recency) — richer hosts return the
+ * structural superset on the same route.
+ */
+export interface QuickFileEntry extends FileEntrySummary {
+    /** Bounded mime type carried by the drag state (defaults by kind). */
+    readonly mime?: string;
+    /** Bounded snapshot reference for drop-in restore (defaults to the entry id). */
+    readonly snapshotRef?: string;
+    /** Mono meta line rendered verbatim (e.g. "GEOVISION FILE • SPATIAL METADATA"). */
+    readonly meta?: string;
+    /** Pinned rows sort first within the recent/common section. */
+    readonly pinned?: boolean;
+    /** Icon glyph override (boards pick workflow vs audit chain). */
+    readonly glyph?: QuickFileGlyph;
+    /** ISO instant of the last open, driving the recency-window filter. */
+    readonly lastOpenedAt?: string;
+}
+/** Result projection of the `interfaces/IFileEntry/list` query for the panel. */
+export interface QuickFileEntryListResult {
+    readonly entries: readonly QuickFileEntry[];
+    readonly nextCursor?: string;
+}
+/**
+ * THE bounded drag/insert state (D6 reference case): everything a receiver
+ * needs to materialize the file its own way, and nothing more — file metadata
+ * only, NEVER a component reference. A world-view receiver restores the
+ * IGeoView snapshot via snapshotRef; an evidence table renders the pack; a
+ * dossier appends a paragraph with an inline link (D10); anything unknown
+ * falls back to a generic inline file link.
+ */
+export interface QuickFileDragState {
+    /** The IFileEntry id of the dragged/inserted file. */
+    readonly entryId: string;
+    /** The file's kind (world-view, evidence-pack, dossier, board, folder, …). */
+    readonly kind: string;
+    /** The file's display name. */
+    readonly name: string;
+    /** The file's bounded mime type. */
+    readonly mime: string;
+    /** Bounded reference addressing the file's saved snapshot for drop-in restore. */
+    readonly snapshotRef: string;
+    /** The publishing panel's component id — always "quick-files". */
+    readonly sourcePanel: "quick-files";
+}
+/**
+ * Lifecycle of the most recent IFileEntry list fetch — local state only; the
+ * panel publishes nothing about its own loading (the single publication is
+ * the bounded drag/insert state).
+ */
+export type QuickFilesStatus = {
+    readonly phase: "busy";
+} | {
+    readonly phase: "error";
+    readonly message: string;
+} | {
+    readonly phase: "ready";
+};
+/** The interface-declared list request kept for client typing (scope/cursor). */
+export type QuickFileListRequest = FileEntryListRequest;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAEnG;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE5F;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,gBAAgB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhC,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/useQuickFilesEntries.d.ts

@@ -0,0 +1,16 @@
+import type { QuickFilesClients } from "./clients.js";
+import type { QuickFileEntry, QuickFilesStatus } from "./types.js";
+/**
+ * Owns the panel's IFileEntry list lifecycle: the mount-time list query
+ * through the generated Lattice client, a monotonic sequence guard so a
+ * superseded response never lands, and the busy/error/ready status driving
+ * the rows region. `reload` re-runs the query (the error state's Retry
+ * action); lifecycle state stays local — the panel publishes nothing about
+ * its own loading.
+ */
+export declare function useQuickFilesEntries(clients: QuickFilesClients): {
+    readonly entries: readonly QuickFileEntry[] | null;
+    readonly status: QuickFilesStatus;
+    readonly reload: () => Promise<void>;
+};
+//# sourceMappingURL=useQuickFilesEntries.d.ts.map

package/dist/useQuickFilesEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuickFilesEntries.d.ts","sourceRoot":"","sources":["../src/useQuickFilesEntries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAChE,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC,CAiCA"}

package/dist/useQuickFilesEntries.js

@@ -0,0 +1,40 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Owns the panel's IFileEntry list lifecycle: the mount-time list query
+ * through the generated Lattice client, a monotonic sequence guard so a
+ * superseded response never lands, and the busy/error/ready status driving
+ * the rows region. `reload` re-runs the query (the error state's Retry
+ * action); lifecycle state stays local — the panel publishes nothing about
+ * its own loading.
+ */
+export function useQuickFilesEntries(clients) {
+    const [entries, setEntries] = useState(null);
+    const [status, setStatus] = useState({ phase: "busy" });
+    const fetchSeqRef = useRef(0);
+    const loadFiles = useCallback(async () => {
+        const seq = fetchSeqRef.current + 1;
+        fetchSeqRef.current = seq;
+        setStatus({ phase: "busy" });
+        try {
+            const result = await clients.files.list();
+            if (fetchSeqRef.current !== seq) {
+                return; // a newer fetch superseded this one
+            }
+            setEntries(result.entries);
+            setStatus({ phase: "ready" });
+        }
+        catch (error) {
+            if (fetchSeqRef.current !== seq) {
+                return;
+            }
+            setStatus({
+                phase: "error",
+                message: error instanceof Error ? error.message : "Lattice file listing failed",
+            });
+        }
+    }, [clients]);
+    useEffect(() => {
+        void loadFiles();
+    }, [loadFiles]);
+    return { entries, status, reload: loadFiles };
+}

package/dist/visibleRows.d.ts

@@ -0,0 +1,12 @@
+import type { QuickFileEntry } from "./types.js";
+/** Mono size formatter for the row meta fallback (B / KB / MB). */
+export declare function formatBytes(sizeBytes: number): string;
+/**
+ * Applies the panel's row visibility and ordering rules to the fetched
+ * entries: search-text match (name + meta + kind), the categoryFilters
+ * configuration key, and the recencyWindowMs configuration key (entries
+ * without a timestamp are kept) — then pinned-first, most-recently-opened,
+ * name ordering.
+ */
+export declare function selectVisibleRows(entries: readonly QuickFileEntry[], search: string, categoryFilters: readonly string[] | undefined, recencyWindowMs: number | undefined): readonly QuickFileEntry[];
+//# sourceMappingURL=visibleRows.d.ts.map

package/dist/visibleRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibleRows.d.ts","sourceRoot":"","sources":["../src/visibleRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC9C,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,SAAS,cAAc,EAAE,CAoC3B"}