@bendyline/docblocks 2.6.1 → 2.7.0

package/dist/settings-HrrCikVX.d.ts

@@ -0,0 +1,170 @@
+import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
+
+/**
+ * Workspace-scoped settings persisted in `<workspace root>/.docblocks/workspace.json`.
+ *
+ * The file travels with the folder (git, sync, zip download), so every
+ * surface — the shell, the VS Code extension host, and the CLI — reads the
+ * same exact-shape document through this module. It is a persisted wire
+ * payload: it enters as `unknown`, only the exact v1 shape is accepted, and
+ * a file written by a newer DocBlocks is reported as unsupported rather than
+ * half-applied.
+ */
+
+declare const WORKSPACE_SETTINGS_DIRECTORY = ".docblocks";
+declare const WORKSPACE_SETTINGS_PATH = ".docblocks/workspace.json";
+declare const WORKSPACE_SETTINGS_VERSION = 1;
+declare const DEFAULT_CATALOG_TITLE = "Documents";
+declare const DEFAULT_CATALOG_HTML_PATH = "index.html";
+declare const DEFAULT_CATALOG_JSON_PATH = "catalog.json";
+declare const WORKSPACE_SETTINGS_LIMITS: {
+    readonly maxFileBytes: number;
+    readonly maxTitleCharacters: 256;
+    readonly maxPathCharacters: 1024;
+    readonly maxSchemaCharacters: 2048;
+    readonly maxExcludes: 64;
+    readonly minKeep: 1;
+    readonly maxKeep: 1000;
+};
+/** Theme ids are data: unknown ids render as the standard theme. */
+declare const WORKSPACE_THEME_ID_PATTERN: RegExp;
+declare const CATALOG_SORT_ORDERS: readonly ["title", "path", "date"];
+type CatalogSortOrder = (typeof CATALOG_SORT_ORDERS)[number];
+declare const CATALOG_JSON_CONTENT_MODES: readonly ["metadata", "markdown"];
+type CatalogJsonContent = (typeof CATALOG_JSON_CONTENT_MODES)[number];
+interface WorkspaceDocumentSettings {
+    /** Theme for documents whose frontmatter names none. */
+    readonly defaultTheme?: string;
+}
+interface WorkspaceVersionHistorySettings {
+    /** Absent inherits the app-wide preference. */
+    readonly enabled?: boolean;
+    /** Snapshots kept per document (keep-last-n prune policy). */
+    readonly keep?: number;
+}
+interface WorkspaceCatalogHtmlSettings {
+    readonly enabled?: boolean;
+    readonly path?: string;
+    /** Overrides `documents.defaultTheme` for the catalog page only. */
+    readonly theme?: string;
+}
+interface WorkspaceCatalogJsonSettings {
+    readonly enabled?: boolean;
+    readonly path?: string;
+    readonly content?: CatalogJsonContent;
+}
+interface WorkspaceCatalogSettings {
+    readonly title?: string;
+    readonly sort?: CatalogSortOrder;
+    /** Workspace-relative folder or file prefixes left out of the catalog. */
+    readonly exclude?: readonly string[];
+    readonly html?: WorkspaceCatalogHtmlSettings;
+    readonly json?: WorkspaceCatalogJsonSettings;
+}
+interface WorkspaceSettings {
+    readonly $schema?: string;
+    readonly version: typeof WORKSPACE_SETTINGS_VERSION;
+    readonly documents?: WorkspaceDocumentSettings;
+    readonly versionHistory?: WorkspaceVersionHistorySettings;
+    readonly catalog?: WorkspaceCatalogSettings;
+}
+declare const EMPTY_WORKSPACE_SETTINGS: WorkspaceSettings;
+type WorkspaceSettingsParseResult = {
+    readonly status: 'ok';
+    readonly settings: WorkspaceSettings;
+} | {
+    readonly status: 'invalid' | 'unsupported-version';
+    readonly message: string;
+};
+type CatalogOutputKind = 'html' | 'json';
+/**
+ * Validate a configured catalog output path. Outputs may never land inside
+ * hidden folders, outside-in companions, or the shared player runtime, and
+ * must carry the extension of what they contain.
+ */
+declare function validateCatalogOutputPath(value: unknown, kind: CatalogOutputKind): WorkspacePath;
+/** Try-form for UI validation messages. */
+declare function checkCatalogOutputPath(value: unknown, kind: CatalogOutputKind): {
+    ok: true;
+    path: WorkspacePath;
+} | {
+    ok: false;
+    message: string;
+};
+/** Parse an already-decoded settings value with the exact v1 shape. */
+declare function parseWorkspaceSettings(value: unknown): WorkspaceSettings;
+declare class UnsupportedWorkspaceSettingsVersionError extends Error {
+    readonly version: number;
+    constructor(version: number);
+}
+/** Decode the settings file text. Never throws for malformed content. */
+declare function parseWorkspaceSettingsText(text: string): WorkspaceSettingsParseResult;
+/** Deterministic, git-friendly serialization: fixed key order, two-space indent, final newline. */
+declare function serializeWorkspaceSettings(settings: WorkspaceSettings): string;
+type FieldPatch<T> = {
+    readonly [K in keyof T]?: T[K] | null;
+};
+/**
+ * A field-level change set. `null` removes a field (falling back to the
+ * inherited/default behavior); omitted fields are left untouched. Saving a
+ * patch rather than a whole document lets a conflicting concurrent edit be
+ * merged by re-applying the patch on top of the newer file.
+ */
+interface WorkspaceSettingsPatch {
+    readonly documents?: FieldPatch<WorkspaceDocumentSettings>;
+    readonly versionHistory?: FieldPatch<WorkspaceVersionHistorySettings>;
+    readonly catalog?: FieldPatch<Omit<WorkspaceCatalogSettings, 'html' | 'json'>> & {
+        readonly html?: FieldPatch<WorkspaceCatalogHtmlSettings>;
+        readonly json?: FieldPatch<WorkspaceCatalogJsonSettings>;
+    };
+}
+/** Apply a patch and re-validate the result. Throws a shape error on invalid output. */
+declare function applyWorkspaceSettingsPatch(base: WorkspaceSettings | null, patch: WorkspaceSettingsPatch): WorkspaceSettings;
+/** Field-level difference from `before` to `after`, suitable for {@link applyWorkspaceSettingsPatch}. */
+declare function diffWorkspaceSettings(before: WorkspaceSettings | null, after: WorkspaceSettings): WorkspaceSettingsPatch;
+declare function isEmptyWorkspaceSettingsPatch(patch: WorkspaceSettingsPatch): boolean;
+/** Exact-shape parser for patches received over a wire boundary (VS Code postMessage). */
+declare function parseWorkspaceSettingsPatch(value: unknown): WorkspaceSettingsPatch;
+/** Try-form of {@link applyWorkspaceSettingsPatch} for UI validation. */
+declare function tryApplyWorkspaceSettingsPatch(base: WorkspaceSettings | null, patch: WorkspaceSettingsPatch): {
+    ok: true;
+    settings: WorkspaceSettings;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * True when settings change nothing about how DocBlocks treats the folder: no
+ * default theme, no version-history choice, and no catalog output turned on.
+ * Fields that only configure a disabled output (a catalog title, path, order,
+ * or page theme) are inert. Such settings are never worth creating a
+ * `.docblocks/` folder for.
+ */
+declare function isDefaultWorkspaceSettings(settings: WorkspaceSettings | null | undefined): boolean;
+/** The workspace default theme, or undefined to use the built-in default. */
+declare function resolveWorkspaceDefaultThemeId(settings: WorkspaceSettings | null | undefined): string | undefined;
+/**
+ * The theme a renderer should be told about explicitly. Every Squisq
+ * exporter lets an explicit theme beat the document's own frontmatter, so a
+ * workspace default may only be passed when the document names no theme.
+ */
+declare function resolveFallbackThemeId(frontmatterThemeId: string | undefined, settings: WorkspaceSettings | null | undefined): string | undefined;
+/** `true`/`false` when the workspace decides, `undefined` to inherit. */
+declare function resolveWorkspaceVersioningEnabled(settings: WorkspaceSettings | null | undefined): boolean | undefined;
+interface ResolvedCatalogOutputs {
+    readonly title: string;
+    readonly sort: CatalogSortOrder;
+    readonly exclude: readonly string[];
+    readonly html: {
+        readonly path: WorkspacePath;
+        readonly themeId: string | undefined;
+    } | null;
+    readonly json: {
+        readonly path: WorkspacePath;
+        readonly content: CatalogJsonContent;
+    } | null;
+}
+/** Effective catalog configuration, or null when no output is enabled. */
+declare function resolveCatalogOutputs(settings: WorkspaceSettings | null | undefined): ResolvedCatalogOutputs | null;
+
+export { resolveCatalogOutputs as A, resolveFallbackThemeId as B, type CatalogSortOrder as C, DEFAULT_CATALOG_HTML_PATH as D, EMPTY_WORKSPACE_SETTINGS as E, resolveWorkspaceDefaultThemeId as F, resolveWorkspaceVersioningEnabled as G, serializeWorkspaceSettings as H, tryApplyWorkspaceSettingsPatch as I, validateCatalogOutputPath as J, type ResolvedCatalogOutputs as R, UnsupportedWorkspaceSettingsVersionError as U, type WorkspaceSettings as W, type WorkspaceSettingsPatch as a, CATALOG_JSON_CONTENT_MODES as b, CATALOG_SORT_ORDERS as c, type CatalogJsonContent as d, type CatalogOutputKind as e, DEFAULT_CATALOG_JSON_PATH as f, DEFAULT_CATALOG_TITLE as g, WORKSPACE_SETTINGS_DIRECTORY as h, WORKSPACE_SETTINGS_LIMITS as i, WORKSPACE_SETTINGS_PATH as j, WORKSPACE_SETTINGS_VERSION as k, WORKSPACE_THEME_ID_PATTERN as l, type WorkspaceCatalogHtmlSettings as m, type WorkspaceCatalogJsonSettings as n, type WorkspaceCatalogSettings as o, type WorkspaceDocumentSettings as p, type WorkspaceSettingsParseResult as q, type WorkspaceVersionHistorySettings as r, applyWorkspaceSettingsPatch as s, checkCatalogOutputPath as t, diffWorkspaceSettings as u, isDefaultWorkspaceSettings as v, isEmptyWorkspaceSettingsPatch as w, parseWorkspaceSettings as x, parseWorkspaceSettingsPatch as y, parseWorkspaceSettingsText as z };

package/dist/types-BvDnr3YU.d.ts

@@ -0,0 +1,88 @@
+import { n as FileSystemProviderV2 } from './v2-BVnZZyd4.js';
+
+/**
+ * FileSystemProvider — abstract interface for a virtual filesystem.
+ *
+ * Legacy text-oriented facade retained while consumers migrate to
+ * FileSystemProviderV2. New persistence code must use the provider's `v2`
+ * contract so paths, errors, operation modes, and capabilities are explicit.
+ */
+
+interface FileEntry {
+    kind: 'file';
+    name: string;
+    path: string;
+    /** ISO-8601 timestamp when the provider can supply file metadata while listing. */
+    lastModified?: string;
+}
+interface FolderEntry {
+    kind: 'directory';
+    name: string;
+    path: string;
+}
+type FileSystemEntry = FileEntry | FolderEntry;
+interface FileMeta {
+    name: string;
+    path: string;
+    size: number;
+    lastModified: string;
+}
+type FileCommitResult = {
+    status: 'committed';
+    version: string | null;
+} | {
+    status: 'conflict';
+    content: string | null;
+    version: string | null;
+};
+/**
+ * @deprecated Compatibility facade for external providers and older callers.
+ * Implement new backends with `FileSystemProviderV2`; built-in facades expose
+ * their authoritative implementation through `v2`.
+ */
+interface FileSystemProvider {
+    /** Unique identifier for this provider instance. */
+    readonly id: string;
+    /** Human-readable label (e.g., folder name or "Browser Storage"). */
+    readonly label: string;
+    /** Optional correctness-first implementation exposed during the v1-to-v2 migration. */
+    readonly v2?: FileSystemProviderV2;
+    /** Read the text content of a file. Returns null if the file doesn't exist. */
+    readFile(path: string): Promise<string | null>;
+    /** Write text content to a file, creating it (and parent dirs) if needed. */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Conditionally replace a text file when it still matches the caller's
+     * persisted baseline. Production providers implement this at their
+     * strongest available serialization boundary.
+     */
+    commitFile?(path: string, content: string, expectedContent: string | null): Promise<FileCommitResult>;
+    /**
+     * Legacy recursive removal of a file or directory subtree. Workspace root
+     * deletion is forbidden. Prefer v2 `remove({ recursive })`.
+     */
+    delete(path: string): Promise<void>;
+    /** Rename or move an entry. Rejects missing sources and existing destinations. */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** List immediate children of a directory. */
+    readDirectory(path: string): Promise<FileSystemEntry[]>;
+    /** Check whether a path exists. */
+    exists(path: string): Promise<boolean>;
+    /** Create a directory (and parents if needed). */
+    createDirectory(path: string): Promise<void>;
+    /** Get metadata for a file. Returns null if not found. */
+    stat(path: string): Promise<FileMeta | null>;
+    /** Read raw binary content. Returns null if not found. */
+    readBinary(path: string): Promise<ArrayBuffer | null>;
+    /** Write raw binary content. */
+    writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
+}
+type FileSystemProviderWithV2 = FileSystemProvider & {
+    readonly v2: FileSystemProviderV2;
+};
+/** Discover a provider-owned v2 implementation without coupling consumers to a concrete class. */
+declare function hasFileSystemProviderV2(provider: FileSystemProvider): provider is FileSystemProviderWithV2;
+/** Return the provider-owned v2 implementation when migration support is available. */
+declare function getFileSystemProviderV2(provider: FileSystemProvider): FileSystemProviderV2 | null;
+
+export { type FileCommitResult as F, type FileEntry as a, type FileMeta as b, type FileSystemEntry as c, type FileSystemProvider as d, type FileSystemProviderWithV2 as e, type FolderEntry as f, getFileSystemProviderV2 as g, hasFileSystemProviderV2 as h };

package/dist/{types-Oy9U5FST.d.ts → types-d0yvHUJz.d.ts}

@@ -402,6 +402,12 @@ interface TemplateContentProfile {
     readonly hasDate: boolean;
     readonly hasNumberHighlight: boolean;
     readonly wordCount: number;
+    /**
+     * A structural body node (list, table, quote, fence) has top-level siblings.
+     * Specialized templates consume one structure, so Squisq recommends only the
+     * complete-body `content` template for such a block; this flag is why.
+     */
+    readonly hasCompoundBody: boolean;
     readonly hasAsciiDiagram: boolean;
     readonly hasTimeline: boolean;
     readonly hasTree: boolean;

package/dist/{types-Bb3yccTH.d.ts → v2-BVnZZyd4.d.ts}

@@ -215,89 +215,4 @@ interface FileSystemProviderV2 {
     dispose(): Promise<void>;
 }
 
-/**
- * FileSystemProvider — abstract interface for a virtual filesystem.
- *
- * Legacy text-oriented facade retained while consumers migrate to
- * FileSystemProviderV2. New persistence code must use the provider's `v2`
- * contract so paths, errors, operation modes, and capabilities are explicit.
- */
-
-interface FileEntry {
-    kind: 'file';
-    name: string;
-    path: string;
-    /** ISO-8601 timestamp when the provider can supply file metadata while listing. */
-    lastModified?: string;
-}
-interface FolderEntry {
-    kind: 'directory';
-    name: string;
-    path: string;
-}
-type FileSystemEntry = FileEntry | FolderEntry;
-interface FileMeta {
-    name: string;
-    path: string;
-    size: number;
-    lastModified: string;
-}
-type FileCommitResult = {
-    status: 'committed';
-    version: string | null;
-} | {
-    status: 'conflict';
-    content: string | null;
-    version: string | null;
-};
-/**
- * @deprecated Compatibility facade for external providers and older callers.
- * Implement new backends with `FileSystemProviderV2`; built-in facades expose
- * their authoritative implementation through `v2`.
- */
-interface FileSystemProvider {
-    /** Unique identifier for this provider instance. */
-    readonly id: string;
-    /** Human-readable label (e.g., folder name or "Browser Storage"). */
-    readonly label: string;
-    /** Optional correctness-first implementation exposed during the v1-to-v2 migration. */
-    readonly v2?: FileSystemProviderV2;
-    /** Read the text content of a file. Returns null if the file doesn't exist. */
-    readFile(path: string): Promise<string | null>;
-    /** Write text content to a file, creating it (and parent dirs) if needed. */
-    writeFile(path: string, content: string): Promise<void>;
-    /**
-     * Conditionally replace a text file when it still matches the caller's
-     * persisted baseline. Production providers implement this at their
-     * strongest available serialization boundary.
-     */
-    commitFile?(path: string, content: string, expectedContent: string | null): Promise<FileCommitResult>;
-    /**
-     * Legacy recursive removal of a file or directory subtree. Workspace root
-     * deletion is forbidden. Prefer v2 `remove({ recursive })`.
-     */
-    delete(path: string): Promise<void>;
-    /** Rename or move an entry. Rejects missing sources and existing destinations. */
-    rename(oldPath: string, newPath: string): Promise<void>;
-    /** List immediate children of a directory. */
-    readDirectory(path: string): Promise<FileSystemEntry[]>;
-    /** Check whether a path exists. */
-    exists(path: string): Promise<boolean>;
-    /** Create a directory (and parents if needed). */
-    createDirectory(path: string): Promise<void>;
-    /** Get metadata for a file. Returns null if not found. */
-    stat(path: string): Promise<FileMeta | null>;
-    /** Read raw binary content. Returns null if not found. */
-    readBinary(path: string): Promise<ArrayBuffer | null>;
-    /** Write raw binary content. */
-    writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
-}
-type FileSystemProviderWithV2 = FileSystemProvider & {
-    readonly v2: FileSystemProviderV2;
-};
-/** Discover a provider-owned v2 implementation without coupling consumers to a concrete class. */
-declare function hasFileSystemProviderV2(provider: FileSystemProvider): provider is FileSystemProviderWithV2;
-/** Return the provider-owned v2 implementation when migration support is available. */
-declare function getFileSystemProviderV2(provider: FileSystemProvider): FileSystemProviderV2 | null;
-
-export { tryParseFileSystemVersion as $, type FileSystemVersion as A, type FileSystemWatchErrorListener as B, type FileSystemWatchEvent as C, type FileSystemWatchEventOrigin as D, type FileSystemWatchEventType as E, type FileCommitResult as F, type FileSystemWatchListener as G, type FileSystemWatchOptions as H, type FileSystemWatchSubscription as I, type FileSystemWriteMode as J, type FileSystemWriteOptions as K, type FolderEntry as L, FsError as M, type FsErrorCode as N, type FsErrorContext as O, type FsOperation as P, deserializeFsError as Q, fsErrorFromUnknown as R, type SerializedFsError as S, getFileSystemProviderV2 as T, hasFileSystemProviderV2 as U, isQuotaExceededError as V, isSerializedFsError as W, mapDomExceptionToFsErrorCode as X, mapNodeErrorCodeToFsErrorCode as Y, parseFileSystemVersion as Z, serializeFsError as _, type FileEntry as a, type FileMeta as b, type FileSystemAtomicity as c, type FileSystemCaseSensitivity as d, type FileSystemConditionalWriteStrength as e, type FileSystemCreateDirectoryMode as f, type FileSystemCreateDirectoryOptions as g, type FileSystemDirectorySnapshot as h, type FileSystemDurability as i, type FileSystemEntry as j, type FileSystemEntrySnapshot as k, type FileSystemEntryWatchEvent as l, type FileSystemFileRead as m, type FileSystemFileSnapshot as n, type FileSystemMoveOptions as o, type FileSystemOverflowWatchEvent as p, type FileSystemProvider as q, type FileSystemProviderCapabilities as r, type FileSystemProviderV2 as s, type FileSystemProviderWithV2 as t, type FileSystemRemoveOptions as u, type FileSystemRemoveResult as v, type FileSystemSnapshot as w, type FileSystemSnapshotEntry as x, type FileSystemSnapshotFile as y, type FileSystemSymlinkPolicy as z };
+export { type FileSystemWatchOptions as A, type FileSystemWatchSubscription as B, type FileSystemWriteMode as C, type FileSystemWriteOptions as D, FsError as E, type FileSystemAtomicity as F, type FsErrorCode as G, type FsErrorContext as H, type FsOperation as I, deserializeFsError as J, fsErrorFromUnknown as K, isQuotaExceededError as L, isSerializedFsError as M, mapDomExceptionToFsErrorCode as N, mapNodeErrorCodeToFsErrorCode as O, parseFileSystemVersion as P, serializeFsError as Q, tryParseFileSystemVersion as R, type SerializedFsError as S, type FileSystemCaseSensitivity as a, type FileSystemConditionalWriteStrength as b, type FileSystemCreateDirectoryMode as c, type FileSystemCreateDirectoryOptions as d, type FileSystemDirectorySnapshot as e, type FileSystemDurability as f, type FileSystemEntrySnapshot as g, type FileSystemEntryWatchEvent as h, type FileSystemFileRead as i, type FileSystemFileSnapshot as j, type FileSystemMoveOptions as k, type FileSystemOverflowWatchEvent as l, type FileSystemProviderCapabilities as m, type FileSystemProviderV2 as n, type FileSystemRemoveOptions as o, type FileSystemRemoveResult as p, type FileSystemSnapshot as q, type FileSystemSnapshotEntry as r, type FileSystemSnapshotFile as s, type FileSystemSymlinkPolicy as t, type FileSystemVersion as u, type FileSystemWatchErrorListener as v, type FileSystemWatchEvent as w, type FileSystemWatchEventOrigin as x, type FileSystemWatchEventType as y, type FileSystemWatchListener as z };

package/dist/vscode/index.d.ts

@@ -1,6 +1,10 @@
+import { W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-HrrCikVX.js';
+import '../workspace-path-CWVrcuPL.js';
+
 /**
  * Typed message protocol between the extension host and webview.
  */
+
 /**
  * Bounds for host-persisted proofing state.
  *
@@ -69,6 +73,28 @@ interface VscodeEditorSettings {
     writeCanvasSettings: VscodeWriteCanvasSettings;
     proofingSettings: VscodeProofingSettings;
 }
+declare const VSCODE_WORKSPACE_SETTINGS_STATUSES: readonly ["unavailable", "loading", "missing", "ready", "invalid", "unsupported-version", "error"];
+type VscodeWorkspaceSettingsStatus = (typeof VSCODE_WORKSPACE_SETTINGS_STATUSES)[number];
+declare const VSCODE_CATALOG_STATES: readonly ["idle", "pending", "running", "done", "error"];
+type VscodeCatalogState = (typeof VSCODE_CATALOG_STATES)[number];
+/**
+ * The `.docblocks/workspace.json` of the folder containing this panel's
+ * document, as the extension host sees it. `settings` is null unless the
+ * file is missing (defaults apply) or valid; `writable` is false for
+ * untrusted workspaces, read-only file systems, and files DocBlocks cannot
+ * safely rewrite (invalid or newer).
+ */
+interface VscodeWorkspaceSettingsState {
+    status: VscodeWorkspaceSettingsStatus;
+    settings: WorkspaceSettings | null;
+    writable: boolean;
+    message: string | null;
+    catalog: {
+        state: VscodeCatalogState;
+        message: string | null;
+        documentCount: number | null;
+    };
+}
 /**
  * An opaque, one-shot authority to write one host-owned export target.
  * The label is presentation-only and must never be interpreted as a path.
@@ -118,6 +144,14 @@ type ExtensionToWebviewMessage = {
 } | {
     type: 'editorSettings';
     settings: VscodeEditorSettings;
+} | {
+    type: 'workspaceSettings';
+    state: VscodeWorkspaceSettingsState;
+} | {
+    type: 'workspaceSettingsResult';
+    requestId: number;
+    ok: boolean;
+    message: string | null;
 } | {
     type: 'codeCopied';
     requestId: number;
@@ -270,6 +304,13 @@ type WebviewToExtensionMessage = {
 } | {
     type: 'saveProofIgnores';
     ignoredJson: string;
+} | {
+    type: 'updateWorkspaceSettings';
+    requestId: number;
+    patch: WorkspaceSettingsPatch;
+} | {
+    type: 'refreshWorkspaceOutputs';
+    requestId: number;
 };
 interface MediaEntryMessage {
     name: string;
@@ -289,6 +330,7 @@ declare function parseWebviewToExtensionMessage(value: unknown): WebviewToExtens
  * runtime validation.
  */
 declare function parseExtensionToWebviewMessage(value: unknown): ExtensionToWebviewMessage | null;
+declare function parseVscodeWorkspaceSettingsState(value: unknown): VscodeWorkspaceSettingsState | null;
 declare function isDocBlocksAccentColor(value: unknown): value is DocBlocksAccentColor;
 declare function isDocBlocksWriteCanvasTextSize(value: unknown): value is number;
 declare function isDocBlocksWriteCanvasLineSpacing(value: unknown): value is number;
@@ -306,4 +348,4 @@ declare function isSafeMimeType(value: unknown): value is string;
  */
 declare function hasSubstantiveTextChange(baseline: string, candidate: string): boolean;
 
-export { DEFAULT_VSCODE_PROOFING_SETTINGS, DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS, DOCBLOCKS_ACCENT_COLORS, DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN, type DocBlocksAccentColor, type DocBlocksWriteCanvasFontScheme, type DocumentConflictChoice, type DocumentConflictDetailsMessage, type DocumentSessionMessageStatus, type ExportTargetGrantMessage, type ExtensionToWebviewMessage, type MediaEntryMessage, PROOF_STATE_LIMITS, type VscodeEditorSettings, type VscodeProofingSettings, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, parseExtensionToWebviewMessage, parseWebviewToExtensionMessage };
+export { DEFAULT_VSCODE_PROOFING_SETTINGS, DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS, DOCBLOCKS_ACCENT_COLORS, DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN, type DocBlocksAccentColor, type DocBlocksWriteCanvasFontScheme, type DocumentConflictChoice, type DocumentConflictDetailsMessage, type DocumentSessionMessageStatus, type ExportTargetGrantMessage, type ExtensionToWebviewMessage, type MediaEntryMessage, PROOF_STATE_LIMITS, VSCODE_CATALOG_STATES, VSCODE_WORKSPACE_SETTINGS_STATUSES, type VscodeCatalogState, type VscodeEditorSettings, type VscodeProofingSettings, type VscodeWorkspaceSettingsState, type VscodeWorkspaceSettingsStatus, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, parseExtensionToWebviewMessage, parseVscodeWorkspaceSettingsState, parseWebviewToExtensionMessage };

package/dist/vscode/index.js

@@ -1,7 +1,12 @@
+import {
+  parseWorkspaceSettings,
+  parseWorkspaceSettingsPatch
+} from "../chunk-UK7R3RC7.js";
 import {
   HOST_WIRE_LIMITS,
   isBoundedString
-} from "../chunk-2WDJ27EH.js";
+} from "../chunk-46AGYHDY.js";
+import "../chunk-AYWKIZLD.js";
 
 // src/vscode/messages.ts
 var MAX_REQUEST_ID = 2147483647;
@@ -44,6 +49,16 @@ var DEFAULT_VSCODE_PROOFING_SETTINGS = {
   spelling: true,
   grammar: true
 };
+var VSCODE_WORKSPACE_SETTINGS_STATUSES = [
+  "unavailable",
+  "loading",
+  "missing",
+  "ready",
+  "invalid",
+  "unsupported-version",
+  "error"
+];
+var VSCODE_CATALOG_STATES = ["idle", "pending", "running", "done", "error"];
 function parseWebviewToExtensionMessage(value) {
   if (!isRecord(value) || typeof value.type !== "string") return null;
   switch (value.type) {
@@ -147,6 +162,13 @@ function parseWebviewToExtensionMessage(value) {
       return hasOnlyKeys(value, ["type", "word"]) && hasBoundedString(value, "word", PROOF_STATE_LIMITS.wordCharacters, 1) ? { type: "addProofDictionaryWord", word: value.word } : null;
     case "saveProofIgnores":
       return hasOnlyKeys(value, ["type", "ignoredJson"]) && hasBoundedString(value, "ignoredJson", PROOF_STATE_LIMITS.ignoredJsonCharacters) ? { type: "saveProofIgnores", ignoredJson: value.ignoredJson } : null;
+    case "updateWorkspaceSettings": {
+      if (!hasOnlyKeys(value, ["type", "requestId", "patch"]) || !hasRequestId(value)) return null;
+      const patch = tryParse(() => parseWorkspaceSettingsPatch(value.patch));
+      return patch ? { type: "updateWorkspaceSettings", requestId: value.requestId, patch } : null;
+    }
+    case "refreshWorkspaceOutputs":
+      return hasOnlyKeys(value, ["type", "requestId"]) && hasRequestId(value) ? { type: "refreshWorkspaceOutputs", requestId: value.requestId } : null;
     default:
       return null;
   }
@@ -289,10 +311,51 @@ function parseExtensionToWebviewMessage(value) {
     }
     case "workspaceFileRead":
       return hasOnlyKeys(value, ["type", "requestId", "dataBase64"]) && hasRequestId(value) && hasNullableBoundedString(value, "dataBase64", HOST_WIRE_LIMITS.base64Characters) ? { type: "workspaceFileRead", requestId: value.requestId, dataBase64: value.dataBase64 } : null;
+    case "workspaceSettings": {
+      if (!hasOnlyKeys(value, ["type", "state"])) return null;
+      const state = parseVscodeWorkspaceSettingsState(value.state);
+      return state ? { type: "workspaceSettings", state } : null;
+    }
+    case "workspaceSettingsResult":
+      return hasOnlyKeys(value, ["type", "requestId", "ok", "message"]) && hasRequestId(value) && typeof value.ok === "boolean" && hasNullableBoundedString(value, "message", HOST_WIRE_LIMITS.messageCharacters) ? {
+        type: "workspaceSettingsResult",
+        requestId: value.requestId,
+        ok: value.ok,
+        message: value.message
+      } : null;
     default:
       return null;
   }
 }
+function tryParse(parse) {
+  try {
+    return parse();
+  } catch {
+    return null;
+  }
+}
+function parseVscodeWorkspaceSettingsState(value) {
+  if (!isRecord(value) || !hasOnlyKeys(value, ["status", "settings", "writable", "message", "catalog"]) || !VSCODE_WORKSPACE_SETTINGS_STATUSES.some((status) => status === value.status) || typeof value.writable !== "boolean" || !hasNullableBoundedString(value, "message", HOST_WIRE_LIMITS.messageCharacters)) {
+    return null;
+  }
+  const settings = value.settings === null ? null : tryParse(() => parseWorkspaceSettings(value.settings));
+  if (value.settings !== null && settings === null) return null;
+  const catalog = value.catalog;
+  if (!isRecord(catalog) || !hasOnlyKeys(catalog, ["state", "message", "documentCount"]) || !VSCODE_CATALOG_STATES.some((state) => state === catalog.state) || !hasNullableBoundedString(catalog, "message", HOST_WIRE_LIMITS.messageCharacters) || !isNullableNonNegativeInteger(catalog.documentCount)) {
+    return null;
+  }
+  return {
+    status: value.status,
+    settings,
+    writable: value.writable,
+    message: value.message,
+    catalog: {
+      state: catalog.state,
+      message: catalog.message,
+      documentCount: catalog.documentCount
+    }
+  };
+}
 function parseProofDictionaryWords(value) {
   if (!Array.isArray(value) || value.length > PROOF_STATE_LIMITS.dictionaryWords) return null;
   const words = [];
@@ -477,6 +540,8 @@ export {
   DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX,
   DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN,
   PROOF_STATE_LIMITS,
+  VSCODE_CATALOG_STATES,
+  VSCODE_WORKSPACE_SETTINGS_STATUSES,
   hasSubstantiveTextChange,
   isDocBlocksAccentColor,
   isDocBlocksWriteCanvasFontScheme,
@@ -485,5 +550,6 @@ export {
   isSafeExportFilename,
   isSafeMimeType,
   parseExtensionToWebviewMessage,
+  parseVscodeWorkspaceSettingsState,
   parseWebviewToExtensionMessage
 };

package/dist/workspace/index.d.ts

@@ -1,6 +1,8 @@
-import { q as FileSystemProvider } from '../types-Bb3yccTH.js';
-import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-DBYraXxE.js';
+import { d as FileSystemProvider } from '../types-BvDnr3YU.js';
+import { Y as ElectronWorkspaceInfo, ai as HostEnvironment } from '../capabilities-CdQAc745.js';
+import '../v2-BVnZZyd4.js';
 import '../workspace-path-CWVrcuPL.js';
+import '../filesystem-v2-C8AdSXUN.js';
 
 /**
  * Origin of a transient workspace — records where its contents came from and
@@ -50,16 +52,16 @@ interface WorkspaceDescriptor {
      * Provider kind:
      * - 'indexeddb' — browser-local storage (web only)
      * - 'native' — File System Access API (web Chrome/Edge only)
-     * - 'electron-native' — Electron main-process native filesystem
+     * - 'host-native' — Electron main-process native filesystem
      * - 'transient' — session-only, in-memory (a loose file/`.dbk` opened from
      *   the OS, or a document copied from a shared URL). Never persisted; its
      *   provider lives in an in-memory registry (see workspace-manager). An
      *   `origin` is present only when changes can be saved back externally.
      */
-    type: 'indexeddb' | 'native' | 'electron-native' | 'transient';
+    type: 'indexeddb' | 'native' | 'host-native' | 'transient';
     /** ISO timestamp of last access. */
     lastOpened: string;
-    /** Absolute filesystem path for 'electron-native' workspaces. */
+    /** Absolute filesystem path for 'host-native' workspaces. */
     rootPath?: string;
     /** For 'transient' workspaces: where the contents came from / save back to. */
     origin?: TransientOrigin;
@@ -83,6 +85,8 @@ declare function parsePersistedWorkspaceList(value: unknown): WorkspaceDescripto
  * (since native providers need a DirectoryHandle from user interaction).
  */
 
+/** Id of the browser-local workspace `ensureDefaultWorkspace` creates. */
+declare const DEFAULT_WORKSPACE_ID = "default";
 /** Register a transient workspace and its (already-built) provider. */
 declare function registerTransientWorkspace(descriptor: WorkspaceDescriptor, provider: FileSystemProvider): void;
 /** Look up a transient workspace (descriptor + provider) by id, if any. */
@@ -138,4 +142,4 @@ interface ElectronWorkspaceReconciliation {
  */
 declare function reconcileElectronWorkspaceDescriptors(local: readonly WorkspaceDescriptor[], hostWorkspaces: readonly ElectronWorkspaceInfo[], platform: HostEnvironment['platform'], now: string): ElectronWorkspaceReconciliation;
 
-export { type ElectronWorkspaceReconciliation, type TransientOrigin, type WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace };
+export { DEFAULT_WORKSPACE_ID, type ElectronWorkspaceReconciliation, type TransientOrigin, type WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace };

package/dist/workspace/index.js

@@ -1,4 +1,5 @@
 import {
+  DEFAULT_WORKSPACE_ID,
   ensureDefaultWorkspace,
   getTransientWorkspace,
   getWorkspace,
@@ -10,10 +11,11 @@ import {
   saveWorkspace,
   touchWorkspace,
   unregisterTransientWorkspace
-} from "../chunk-SJBB5OD7.js";
-import "../chunk-OQCPBOQA.js";
+} from "../chunk-QS5WTLUZ.js";
+import "../chunk-DAPFSEKY.js";
 import "../chunk-XAMILHQP.js";
 export {
+  DEFAULT_WORKSPACE_ID,
   ensureDefaultWorkspace,
   getTransientWorkspace,
   getWorkspace,