@bendyline/docblocks 2.7.7 → 2.7.9

package/THIRD_PARTY_NOTICES.txt

@@ -14,8 +14,8 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.13.3 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-graph | 2.13.0 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.13.8 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-graph | 2.13.1 | MIT | https://github.com/bendyline/squisq |
 | @types/debug | 4.1.12 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/hast | 3.0.4 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/katex | 0.16.8 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
@@ -133,7 +133,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 Package-local license, copying, and notice files are reproduced below. Where a published package omits its repository license, the reviewed aggregate or README identified in `Source files` supplies the retained material.
 
 ==============================================================================
-Components: @bendyline/squisq-graph@2.13.0, @bendyline/squisq@2.13.3
+Components: @bendyline/squisq-graph@2.13.1, @bendyline/squisq@2.13.8
 Source files: node_modules/@bendyline/squisq-graph/LICENSE, node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -159,7 +159,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-graph@2.13.0
+Components: @bendyline/squisq-graph@2.13.1
 Source files: node_modules/@bendyline/squisq-graph/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-graph
@@ -177,7 +177,7 @@ This package has no third-party runtime dependencies. The layout engine and its
 worker entry are Squisq-authored (MIT).
 
 ==============================================================================
-Components: @bendyline/squisq-graph@2.13.0
+Components: @bendyline/squisq-graph@2.13.1
 Source files: node_modules/@bendyline/squisq-graph/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-graph
@@ -189,7 +189,7 @@ repository license, the pinned upstream copy is vendored and identified below.
 COMPONENTS
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.3
+Components: @bendyline/squisq@2.13.8
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -220,7 +220,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.3
+Components: @bendyline/squisq@2.13.8
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{capabilities-D4Z1xYZV.d.ts → capabilities-CH66e2pR.d.ts}

@@ -1,6 +1,177 @@
 import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-DLteNrK0.js';
 import { D as DocBlocksHostFsV2API } from './filesystem-v2-CXdAPR27.js';
 
+/**
+ * On-device image generation.
+ *
+ * Renders run on the provider's local image engine. They take seconds on a
+ * fast graphics card and minutes for the largest models, so a request streams
+ * phased progress and can be cancelled; cancelling stops the engine, and the
+ * next render reloads its weights. Image models are listed apart from chat
+ * models and never appear in a chat model picker.
+ */
+/** Shapes a person can ask for. The provider picks pixels inside the model's range. */
+declare const AI_IMAGE_ASPECTS: readonly ["1:1", "4:3", "3:4", "16:9", "9:16"];
+type AiImageAspect = (typeof AI_IMAGE_ASPECTS)[number];
+type AiImageUnavailableReason = 
+/** AI is off, or the provider is not connected. */
+'not-connected'
+/** The provider has no image engine that can run on this computer. */
+ | 'no-engine'
+/** The graphics driver lacks what the engine needs (Vulkan on Windows). */
+ | 'graphics-driver'
+/** This build of the app cannot run image generation. */
+ | 'platform';
+/**
+ * Whether image generation can be offered now.
+ *
+ * `needs-approval` means the provider serves images but this app has not been
+ * allowed to use them; ask with `requestAccess()` from an explicit gesture.
+ * While that request waits, the state is `awaiting-approval` with the code the
+ * person types into the provider. Chat keeps working throughout.
+ */
+type AiImageAccess = {
+    readonly kind: 'ready';
+} | {
+    readonly kind: 'needs-approval';
+} | {
+    readonly kind: 'awaiting-approval';
+    readonly verificationCode: string | null;
+} | {
+    readonly kind: 'provider-outdated';
+} | {
+    readonly kind: 'unavailable';
+    readonly reason: AiImageUnavailableReason;
+    readonly message: string;
+};
+declare const AI_IMAGE_FIT_VERDICTS: readonly ["fits", "tight", "over-limit", "may-not-run", "wont-run"];
+interface AiImageModelFit {
+    /** `wont-run` models refuse to install on this computer. */
+    readonly verdict: (typeof AI_IMAGE_FIT_VERDICTS)[number];
+    /** One sentence a person can act on; empty for a plain fit. */
+    readonly reason: string;
+}
+interface AiImageModel {
+    /** Opaque to the renderer. */
+    readonly id: string;
+    readonly label: string;
+    readonly description: string | null;
+    readonly state: 'installed' | 'download-required' | 'downloading';
+    readonly downloadBytes: number | null;
+    /** Installed in a store the provider reads but this app does not own; not removable here. */
+    readonly shared: boolean;
+    readonly license: string | null;
+    /** False when the license forbids commercial use; null when the provider does not say. */
+    readonly commercialUse: boolean | null;
+    /** Draws legible text, which design graphics depend on. */
+    readonly rendersText: boolean;
+    /** How the model reads prompts. */
+    readonly promptStyle: 'sentences' | 'tags' | null;
+    /** `workstation` marks a model for a machine with a great deal of memory. */
+    readonly hardwareTier: 'low' | 'mid' | 'high' | 'workstation' | null;
+    readonly minRamGb: number | null;
+    readonly fit: AiImageModelFit | null;
+}
+interface AiImagePreferences {
+    /** The model "Generate image" uses; null lets the provider choose an installed one. */
+    readonly model: string | null;
+    /** The model Illustrate's design graphics use; null offers none. */
+    readonly designModel: string | null;
+    readonly aspect: AiImageAspect;
+}
+type AiImagePreferencesPatch = Partial<AiImagePreferences>;
+interface AiImageRequest {
+    readonly prompt: string;
+    readonly negativePrompt?: string;
+    /** An id from `models()`; the preferred model when absent. */
+    readonly model?: string;
+    readonly aspect?: AiImageAspect;
+    readonly seed?: number;
+}
+interface AiImageResult {
+    readonly mimeType: 'image/png';
+    readonly data: ArrayBuffer;
+    readonly width: number;
+    readonly height: number;
+    readonly seed: number;
+    readonly model: string;
+    readonly durationMs: number;
+}
+/**
+ * `loading-model` covers the first render after the engine starts, which
+ * loads the weights; `decoding` turns the result into pixels in tiles.
+ */
+type AiImagePhase = 'queued' | 'loading-model' | 'sampling' | 'decoding';
+interface AiImageProgress {
+    readonly phase: AiImagePhase;
+    /** Units done in this phase; 0 while queued or when the engine reports none. */
+    readonly step: number;
+    readonly totalSteps: number;
+    readonly secondsPerStep: number | null;
+}
+type AiImageEvent = {
+    readonly kind: 'progress';
+    readonly progress: AiImageProgress;
+} | {
+    readonly kind: 'done';
+    readonly image: AiImageResult;
+} | {
+    readonly kind: 'error';
+    readonly error: AiError;
+};
+interface AiImageHandle {
+    readonly done: Promise<AiResult<AiImageResult>>;
+    /** Stop the render. The engine stops, so the next render reloads its weights. */
+    cancel(): void;
+}
+type AiImageInstallEvent = {
+    readonly kind: 'progress';
+    readonly progress: AiProgress;
+} | {
+    readonly kind: 'done';
+    readonly model: AiImageModel;
+} | {
+    readonly kind: 'error';
+    readonly error: AiError;
+};
+interface AiImageInstallHandle {
+    readonly done: Promise<AiResult<AiImageModel>>;
+    /** Stop the download. Starting it again resumes. */
+    cancel(): void;
+}
+interface AiImagesAPI {
+    access(): Promise<AiImageAccess>;
+    onAccess(listener: (access: AiImageAccess) => void): () => void;
+    /** Ask the provider to allow image generation. Only from an explicit gesture. */
+    requestAccess(): Promise<AiResult<AiImageAccess>>;
+    models(): Promise<AiResult<readonly AiImageModel[]>>;
+    /** Start a model download from an explicit gesture. */
+    installModel(id: string, onProgress?: (progress: AiProgress) => void): AiImageInstallHandle;
+    removeModel(id: string): Promise<AiResult<null>>;
+    getPreferences(): Promise<AiImagePreferences>;
+    setPreferences(patch: AiImagePreferencesPatch): Promise<AiImagePreferences>;
+    generate(request: AiImageRequest, onEvent: (event: AiImageEvent) => void): AiImageHandle;
+}
+declare const AI_IMAGE_WIRE_LIMITS: Readonly<{
+    promptCharacters: 4000;
+    /** A PNG at the largest size a model renders. */
+    imageBytes: number;
+    models: 256;
+    pixels: 16384;
+    verificationCodeCharacters: 16;
+}>;
+declare function isAiImageModelId(value: unknown): value is string;
+declare function isAiImageAspect(value: unknown): value is AiImageAspect;
+declare function parseAiImageAccess(value: unknown): AiImageAccess | null;
+declare function parseAiImageModel(value: unknown): AiImageModel | null;
+declare function parseAiImageModelList(value: unknown): AiImageModel[] | null;
+declare function parseAiImagePreferences(value: unknown): AiImagePreferences | null;
+declare function parseAiImagePreferencesPatch(value: unknown): AiImagePreferencesPatch | null;
+declare function parseAiImageRequest(value: unknown): AiImageRequest | null;
+declare function parseAiImageResult(value: unknown): AiImageResult | null;
+declare function parseAiImageEvent(value: unknown): AiImageEvent | null;
+declare function parseAiImageInstallEvent(value: unknown): AiImageInstallEvent | null;
+
 /** Provider-neutral catalog management. IDs never authorize filesystem access. */
 interface AiKnowledgeCatalog {
     readonly id: string;
@@ -378,17 +549,6 @@ interface AiSearchResult {
     readonly hits: readonly AiSearchHit[];
     readonly truncated: boolean;
 }
-interface AiImageRequest {
-    readonly prompt: string;
-    readonly width?: number;
-    readonly height?: number;
-}
-interface AiImageResult {
-    readonly mimeType: 'image/png';
-    readonly data: ArrayBuffer;
-    readonly width: number;
-    readonly height: number;
-}
 interface AiTranscribeRequest {
     readonly audio: ArrayBuffer;
     readonly mimeType: string;
@@ -421,6 +581,8 @@ interface AiSpeechAudio {
 interface DocBlocksHostAiAPI {
     /** Optional catalog browsing, downloads, and retrieval model setup. */
     readonly knowledge?: AiKnowledgeAPI;
+    /** Optional on-device image generation and its models. */
+    readonly images?: AiImagesAPI;
     /** Whether the host's user-installed companion provider is present. */
     providerInstalled(): Promise<boolean>;
     status(): Promise<AiStatus>;
@@ -452,7 +614,6 @@ interface DocBlocksHostAiAPI {
     chat(request: AiChatRequest, onEvent: (event: AiChatEvent) => void): AiChatHandle;
     ensureWorkspace?(workspaceId: string, onProgress?: (progress: AiProgress) => void): AiEnsureWorkspaceHandle;
     search?(workspaceId: string, query: AiSearchQuery): Promise<AiResult<AiSearchResult>>;
-    generateImage?(request: AiImageRequest): Promise<AiResult<AiImageResult>>;
     /** @deprecated Speech lives on `DocBlocksHostAPI.speech`; no host implements this. */
     transcribe?(request: AiTranscribeRequest): Promise<AiResult<AiTranscript>>;
     /** @deprecated Speech lives on `DocBlocksHostAPI.speech`; no host implements this. */
@@ -813,12 +974,25 @@ interface SpeechTranscribeRequest {
      */
     readonly prompt?: string;
     readonly language?: string;
+    /**
+     * Return timed `segments` with word times (Whisper's verbose output), for
+     * timing a narration from its audio. Dictation leaves it off.
+     */
+    readonly timestamps?: boolean;
+}
+/** A recognized word. Seconds from the start of the take. */
+interface SpeechWord {
+    readonly start: number;
+    readonly end: number;
+    readonly text: string;
 }
 interface SpeechSegment {
     /** Seconds from the start of the take. */
     readonly start: number;
     readonly end: number;
     readonly text: string;
+    /** Present when the request asked for `timestamps`. */
+    readonly words?: readonly SpeechWord[];
 }
 interface SpeechTranscript {
     /** Trimmed; empty when the take held no speech. */
@@ -1378,4 +1552,4 @@ declare function parseHostEnvironment(value: unknown): HostEnvironment | null;
  */
 declare function deriveHostCapabilities(host: unknown): HostCapabilities;
 
-export { type DocBlocksHostMenuAPI as $, type AiChatCompletion as A, type AiModelInstallHandle as B, type AiPreferences as C, type AiPreferencesPatch as D, type AiProgress as E, type AiProviderInfo as F, type AiResponseFormat as G, type AiResult as H, type AiReviewMode as I, type AiSearchHit as J, type AiSearchQuery as K, type AiSearchResult as L, type AiSpeechAudio as M, type AiStatus as N, type AiSynthesizeRequest as O, type AiTranscribeRequest as P, type AiTranscript as Q, type AiUnavailableReason as R, type DocBlocksHostAPI as S, type DocBlocksHostAiAPI as T, type DocBlocksHostClipboardAPI as U, type DocBlocksHostExportAPI as V, type DocBlocksHostExternalAPI as W, type DocBlocksHostFfmpegAPI as X, type DocBlocksHostFsAPI as Y, type DocBlocksHostGitAPI as Z, type DocBlocksHostLifecycleAPI as _, type AiChatEvent as a, deriveHostCapabilities as a$, type DocBlocksHostShellAPI as a0, type DocBlocksHostSpeechAPI as a1, type DocBlocksHostUpdaterAPI as a2, type DocBlocksHostWorkspacesAPI as a3, type ElectronWorkspaceInfo as a4, type ExternalBinaryCommitResult as a5, type GitBranchInfo as a6, type GitCapabilities as a7, type GitCloneHandle as a8, type GitCloneProgress as a9, type SpeechAudioChunk as aA, type SpeechCatalog as aB, type SpeechError as aC, type SpeechErrorCode as aD, type SpeechInstallEvent as aE, type SpeechInstallHandle as aF, type SpeechModelInfo as aG, type SpeechModelKind as aH, type SpeechPreferences as aI, type SpeechPreferencesPatch as aJ, type SpeechProgress as aK, type SpeechReadiness as aL, type SpeechReadinessState as aM, type SpeechResult as aN, type SpeechSegment as aO, type SpeechStatus as aP, type SpeechSynthesisHandle as aQ, type SpeechSynthesisSummary as aR, type SpeechSynthesizeEvent as aS, type SpeechSynthesizeRequest as aT, type SpeechTranscribeRequest as aU, type SpeechTranscript as aV, type SpeechVoiceInfo as aW, type SpeechWordTiming as aX, type UpdateCheckResult as aY, type UpdateInstallResult as aZ, type UpdaterStatus as a_, type GitError as aa, type GitErrorCode as ab, type GitFileAtRevision as ac, type GitFileChange as ad, type GitFileStatusCode as ae, type GitLogEntry as af, type GitLogOptions as ag, type GitRemoteInfo as ah, type GitRepoDetection as ai, type GitResult as aj, type GitRevision as ak, type GitStatus as al, HOST_PLATFORMS as am, HOST_SURFACE_KINDS as an, type HostCapabilities as ao, type HostCloseReason as ap, type HostEnvironment as aq, type HostExportTargetGrant as ar, type HostPinnedDocument as as, type HostPlatform as at, type HostPrepareCloseRequest as au, type HostPrepareCloseResult as av, type HostSurfaceKind as aw, type MenuCommand as ax, NO_HOST_CAPABILITIES as ay, type OpenRequest as az, type AiChatEvidence as b, parseAiKnowledgeAction as b0, parseAiKnowledgeState as b1, parseHostEnvironment as b2, type AiChatHandle as c, type AiChatKnowledge as d, type AiChatKnowledgeSource as e, type AiChatMessage as f, type AiChatProgress as g, type AiChatPurpose as h, type AiChatRequest as i, type AiConnectionStep as j, type AiEnsureWorkspaceHandle as k, type AiError as l, type AiErrorCode as m, type AiFactCheck as n, type AiFactCheckRequest as o, type AiFactCheckSentence as p, type AiImageRequest as q, type AiImageResult as r, type AiKnowledgeAPI as s, type AiKnowledgeAction as t, type AiKnowledgeCatalog as u, type AiKnowledgeState as v, type AiModelDownloadInfo as w, type AiModelFit as x, type AiModelInfo as y, type AiModelInstallEvent as z };
+export { type AiSearchQuery as $, AI_IMAGE_ASPECTS as A, type AiImageModelFit as B, type AiImagePhase as C, type AiImagePreferences as D, type AiImagePreferencesPatch as E, type AiImageProgress as F, type AiImageRequest as G, type AiImageResult as H, type AiImageUnavailableReason as I, type AiImagesAPI as J, type AiKnowledgeAPI as K, type AiKnowledgeAction as L, type AiKnowledgeCatalog as M, type AiKnowledgeState as N, type AiModelDownloadInfo as O, type AiModelFit as P, type AiModelInfo as Q, type AiModelInstallEvent as R, type AiModelInstallHandle as S, type AiPreferences as T, type AiPreferencesPatch as U, type AiProgress as V, type AiProviderInfo as W, type AiResponseFormat as X, type AiResult as Y, type AiReviewMode as Z, type AiSearchHit as _, AI_IMAGE_FIT_VERDICTS as a, type SpeechProgress as a$, type AiSearchResult as a0, type AiSpeechAudio as a1, type AiStatus as a2, type AiSynthesizeRequest as a3, type AiTranscribeRequest as a4, type AiTranscript as a5, type AiUnavailableReason as a6, type DocBlocksHostAPI as a7, type DocBlocksHostAiAPI as a8, type DocBlocksHostClipboardAPI as a9, type GitResult as aA, type GitRevision as aB, type GitStatus as aC, HOST_PLATFORMS as aD, HOST_SURFACE_KINDS as aE, type HostCapabilities as aF, type HostCloseReason as aG, type HostEnvironment as aH, type HostExportTargetGrant as aI, type HostPinnedDocument as aJ, type HostPlatform as aK, type HostPrepareCloseRequest as aL, type HostPrepareCloseResult as aM, type HostSurfaceKind as aN, type MenuCommand as aO, NO_HOST_CAPABILITIES as aP, type OpenRequest as aQ, type SpeechAudioChunk as aR, type SpeechCatalog as aS, type SpeechError as aT, type SpeechErrorCode as aU, type SpeechInstallEvent as aV, type SpeechInstallHandle as aW, type SpeechModelInfo as aX, type SpeechModelKind as aY, type SpeechPreferences as aZ, type SpeechPreferencesPatch as a_, type DocBlocksHostExportAPI as aa, type DocBlocksHostExternalAPI as ab, type DocBlocksHostFfmpegAPI as ac, type DocBlocksHostFsAPI as ad, type DocBlocksHostGitAPI as ae, type DocBlocksHostLifecycleAPI as af, type DocBlocksHostMenuAPI as ag, type DocBlocksHostShellAPI as ah, type DocBlocksHostSpeechAPI as ai, type DocBlocksHostUpdaterAPI as aj, type DocBlocksHostWorkspacesAPI as ak, type ElectronWorkspaceInfo as al, type ExternalBinaryCommitResult as am, type GitBranchInfo as an, type GitCapabilities as ao, type GitCloneHandle as ap, type GitCloneProgress as aq, type GitError as ar, type GitErrorCode as as, type GitFileAtRevision as at, type GitFileChange as au, type GitFileStatusCode as av, type GitLogEntry as aw, type GitLogOptions as ax, type GitRemoteInfo as ay, type GitRepoDetection as az, AI_IMAGE_WIRE_LIMITS as b, type SpeechReadiness as b0, type SpeechReadinessState as b1, type SpeechResult as b2, type SpeechSegment as b3, type SpeechStatus as b4, type SpeechSynthesisHandle as b5, type SpeechSynthesisSummary as b6, type SpeechSynthesizeEvent as b7, type SpeechSynthesizeRequest as b8, type SpeechTranscribeRequest as b9, type SpeechTranscript as ba, type SpeechVoiceInfo as bb, type SpeechWord as bc, type SpeechWordTiming as bd, type UpdateCheckResult as be, type UpdateInstallResult as bf, type UpdaterStatus as bg, deriveHostCapabilities as bh, isAiImageAspect as bi, isAiImageModelId as bj, parseAiImageAccess as bk, parseAiImageEvent as bl, parseAiImageInstallEvent as bm, parseAiImageModel as bn, parseAiImageModelList as bo, parseAiImagePreferences as bp, parseAiImagePreferencesPatch as bq, parseAiImageRequest as br, parseAiImageResult as bs, parseAiKnowledgeAction as bt, parseAiKnowledgeState as bu, parseHostEnvironment as bv, type AiChatCompletion as c, type AiChatEvent as d, type AiChatEvidence as e, type AiChatHandle as f, type AiChatKnowledge as g, type AiChatKnowledgeSource as h, type AiChatMessage as i, type AiChatProgress as j, type AiChatPurpose as k, type AiChatRequest as l, type AiConnectionStep as m, type AiEnsureWorkspaceHandle as n, type AiError as o, type AiErrorCode as p, type AiFactCheck as q, type AiFactCheckRequest as r, type AiFactCheckSentence as s, type AiImageAccess as t, type AiImageAspect as u, type AiImageEvent as v, type AiImageHandle as w, type AiImageInstallEvent as x, type AiImageInstallHandle as y, type AiImageModel as z };

package/dist/{catalog-BQK05tne.d.ts → catalog-BmEXHaZf.d.ts}

@@ -1,5 +1,5 @@
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { C as CatalogSortOrder } from './settings-HrrCikVX.js';
+import { C as CatalogSortOrder } from './settings-C-TS15JZ.js';
 
 /**
  * Synchronous outside-in path layout.
@@ -36,8 +36,11 @@ declare function chooseOutsideInMarkdownPath(layout: OutsideInLayout, paths: rea
  *
  * Everything here is deterministic: identical inputs produce identical bytes
  * on every surface (shell, VS Code extension host, CLI). There are no
- * timestamps, no filesystem mtimes, and no locale-sensitive ordering, so a
- * catalog committed to git only changes when the documents do.
+ * filesystem mtimes and no locale-sensitive ordering. The only clock reading
+ * is a document's first-published and last-modified dates, carried forward from
+ * the previous catalog JSON and stamped only when a document first appears or
+ * its content changes — so a catalog committed to git still only changes when
+ * the documents do.
  */
 
 declare const CATALOG_GENERATOR = "docblocks-workspace-catalog";
@@ -65,11 +68,17 @@ interface CatalogEntry {
     readonly description?: string;
     readonly author?: string;
     readonly date?: string;
+    /** When the document first appeared in the catalog JSON (ISO 8601, UTC). */
+    readonly firstPublishedDate?: string;
+    /** When the catalog JSON last picked up a change to the document's content. */
+    readonly lastModifiedDate?: string;
     readonly tags?: readonly string[];
     readonly theme?: string;
     readonly outline: readonly CatalogOutlineEntry[];
     readonly wordCount: number;
     readonly excerpt?: string;
+    /** SHA-256 hex of the source text with normalized line endings; absent when unread. */
+    readonly contentHash?: string;
     /** Present only when the catalog is configured with `content: "markdown"`. */
     readonly markdown?: string;
 }
@@ -106,6 +115,23 @@ declare function createWorkspaceCatalog(title: string, entries: readonly Catalog
  */
 declare function serializeCatalogJson(catalog: WorkspaceCatalog): string;
 declare function isGeneratedCatalogJson(text: string): boolean;
+/** The dates a previously generated catalog recorded for one document. */
+interface CatalogDateRecord {
+    readonly firstPublishedDate: string;
+    readonly lastModifiedDate: string;
+    readonly contentHash?: string;
+}
+/**
+ * Per-path date history from a previously generated catalog JSON. Anything
+ * malformed is skipped, so the worst case is a document dated as new.
+ */
+declare function readCatalogDateHistory(text: string): Map<string, CatalogDateRecord>;
+/**
+ * Date each entry. A document keeps the dates `history` holds for its path;
+ * it is stamped `now` when it first appears, and its `lastModifiedDate`
+ * moves to `now` when its content hash changes.
+ */
+declare function stampCatalogDates(catalog: WorkspaceCatalog, history: ReadonlyMap<string, CatalogDateRecord>, now: Date): WorkspaceCatalog;
 /** Insert the generator marker directly after the doctype so it cannot affect quirks mode. */
 declare function stampCatalogHtml(html: string, inputsDigest: string): string;
 declare function readCatalogHtmlDigest(text: string): string | null;
@@ -119,4 +145,4 @@ declare function relativeCatalogLink(fromDirectory: string, toPath: string): str
  */
 declare function buildCatalogMarkdownDocument(catalog: WorkspaceCatalog, outputPath: string): MarkdownDocument;
 
-export { type CatalogEntry as C, OUTSIDE_IN_FORMAT_IDS as O, type WorkspaceCatalog as W, CATALOG_FORMAT_VERSION as a, CATALOG_GENERATOR as b, CATALOG_LIMITS as c, type CatalogDocumentFormat as d, type CatalogEntryHints as e, type CatalogOutlineEntry as f, type CatalogSource as g, type OutsideInFormatId as h, type OutsideInLayout as i, buildCatalogMarkdownDocument as j, catalogEntryForUnreadable as k, catalogEntryFromDocument as l, catalogEntryFromMarkdown as m, chooseOutsideInMarkdownPath as n, createWorkspaceCatalog as o, isGeneratedCatalogHtml as p, isGeneratedCatalogJson as q, readCatalogHtmlDigest as r, relativeCatalogLink as s, relocateOutsideInLayout as t, resolveOutsideInLayout as u, serializeCatalogJson as v, sortCatalogEntries as w, stampCatalogHtml as x };
+export { stampCatalogHtml as A, type CatalogEntry as C, OUTSIDE_IN_FORMAT_IDS as O, type WorkspaceCatalog as W, CATALOG_FORMAT_VERSION as a, CATALOG_GENERATOR as b, CATALOG_LIMITS as c, type CatalogDateRecord as d, type CatalogDocumentFormat as e, type CatalogEntryHints as f, type CatalogOutlineEntry as g, type CatalogSource as h, type OutsideInFormatId as i, type OutsideInLayout as j, buildCatalogMarkdownDocument as k, catalogEntryForUnreadable as l, catalogEntryFromDocument as m, catalogEntryFromMarkdown as n, chooseOutsideInMarkdownPath as o, createWorkspaceCatalog as p, isGeneratedCatalogHtml as q, isGeneratedCatalogJson as r, readCatalogDateHistory as s, readCatalogHtmlDigest as t, relativeCatalogLink as u, relocateOutsideInLayout as v, resolveOutsideInLayout as w, serializeCatalogJson as x, sortCatalogEntries as y, stampCatalogDates as z };

package/dist/{chunk-5VEIEFFC.js → chunk-CI3DHDPG.js}

@@ -17,7 +17,7 @@ import {
   createFileSystemDocumentTarget,
   describeEntryMove,
   describePartialMove
-} from "./chunk-FIEMYP2N.js";
+} from "./chunk-D7VUEVAX.js";
 import {
   getFileSystemProviderV2
 } from "./chunk-XAMILHQP.js";

package/dist/{chunk-FIEMYP2N.js → chunk-D7VUEVAX.js}

@@ -181,13 +181,15 @@ var DocumentSession = class {
     if (content === this.content) return this.revision;
     this.content = content;
     this.revision += 1;
+    this.localEditedAt = Date.now();
     this.error = null;
     this.autoSaveRetryAttempt = 0;
     if (this.conflict) {
       this.conflict = {
         ...this.conflict,
         localContent: content,
-        localRevision: this.revision
+        localRevision: this.revision,
+        localEditedAt: this.localEditedAt
       };
     }
     this.writeRecoverySnapshot();
@@ -377,6 +379,7 @@ var DocumentSession = class {
         targetKey: change.targetKey,
         localContent: this.content,
         localRevision: this.revision,
+        localEditedAt: this.localEditedAt,
         externalContent: change.content,
         externalVersion
       };
@@ -399,6 +402,7 @@ var DocumentSession = class {
       targetKey: change.targetKey,
       localContent: this.content,
       localRevision: this.revision,
+      localEditedAt: this.localEditedAt,
       externalContent: change.content,
       externalVersion: change.version ?? null
     };
@@ -411,6 +415,7 @@ var DocumentSession = class {
     this.clearAutoSaveTimer();
     this.autoSaveRetryAttempt = 0;
     this.content = content;
+    this.localEditedAt = void 0;
     this.revision += 1;
     this.persistedRevision = this.revision;
     this.persistedContent = content;
@@ -433,6 +438,7 @@ var DocumentSession = class {
         this.discardRecoverySnapshot();
         this.generation += 1;
         this.revision += 1;
+        this.localEditedAt = void 0;
         this.conflict = null;
         this.error = null;
         this.haltDrain = false;
@@ -518,6 +524,7 @@ var DocumentSession = class {
       this.externalSequence = -1;
       this.target = next.target;
       this.content = next.content;
+      this.localEditedAt = void 0;
       this.revision += 1;
       this.persistedRevision = this.revision;
       this.persistedContent = next.target ? next.content : null;
@@ -607,6 +614,7 @@ var DocumentSession = class {
             targetKey: target.key,
             localContent: this.content,
             localRevision: this.revision,
+            localEditedAt: this.localEditedAt,
             externalContent: error.externalContent,
             externalVersion: error.externalVersion
           };
@@ -715,6 +723,7 @@ var DocumentSession = class {
     this.externalSequence = -1;
     this.target = null;
     this.persistedContent = null;
+    this.localEditedAt = void 0;
     this.savingRevision = null;
     this.savingContent = null;
     this.error = null;

package/dist/{chunk-R2JX5N3F.js → chunk-L7HADBCQ.js}

@@ -168,11 +168,14 @@ function orderedEntry(entry) {
     "description",
     "author",
     "date",
+    "firstPublishedDate",
+    "lastModifiedDate",
     "tags",
     "theme",
     "outline",
     "wordCount",
     "excerpt",
+    "contentHash",
     "markdown"
   ];
   for (const key of keys) {
@@ -202,6 +205,50 @@ var CATALOG_JSON_MARKER = /^\uFEFF?\{\s*"generator"\s*:\s*"docblocks-workspace-c
 function isGeneratedCatalogJson(text) {
   return CATALOG_JSON_MARKER.test(text.slice(0, 256));
 }
+var CATALOG_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2}))?$/;
+var CONTENT_HASH_PATTERN = /^[0-9a-f]{64}$/;
+function catalogDate(value) {
+  return typeof value === "string" && CATALOG_DATE_PATTERN.test(value) && Number.isFinite(Date.parse(value)) ? value : void 0;
+}
+function readCatalogDateHistory(text) {
+  const history = /* @__PURE__ */ new Map();
+  if (!isGeneratedCatalogJson(text)) return history;
+  let parsed;
+  try {
+    parsed = JSON.parse(text.replace(/^\uFEFF/, ""));
+  } catch {
+    return history;
+  }
+  const documents = parsed?.documents;
+  if (!Array.isArray(documents)) return history;
+  for (const document of documents) {
+    if (!document || typeof document !== "object") continue;
+    const record = document;
+    const first = catalogDate(record.firstPublishedDate);
+    if (typeof record.path !== "string" || !first) continue;
+    const hash = record.contentHash;
+    history.set(record.path, {
+      firstPublishedDate: first,
+      lastModifiedDate: catalogDate(record.lastModifiedDate) ?? first,
+      ...typeof hash === "string" && CONTENT_HASH_PATTERN.test(hash) ? { contentHash: hash } : {}
+    });
+  }
+  return history;
+}
+function stampCatalogDates(catalog, history, now) {
+  const timestamp = now.toISOString().replace(/\.\d{3}Z$/, "Z");
+  return {
+    ...catalog,
+    documents: catalog.documents.map((entry) => {
+      const previous = history.get(entry.path);
+      return {
+        ...entry,
+        firstPublishedDate: previous?.firstPublishedDate ?? timestamp,
+        lastModifiedDate: previous && previous.contentHash === entry.contentHash ? previous.lastModifiedDate : timestamp
+      };
+    })
+  };
+}
 var CATALOG_HTML_MARKER = /<!-- docblocks-workspace-catalog v1 inputs=sha256:([0-9a-f]{64}) -->/;
 var CATALOG_HTML_MARKER_SCAN_CHARACTERS = 2048;
 function stampCatalogHtml(html, inputsDigest) {
@@ -369,6 +416,8 @@ export {
   createWorkspaceCatalog,
   serializeCatalogJson,
   isGeneratedCatalogJson,
+  readCatalogDateHistory,
+  stampCatalogDates,
   stampCatalogHtml,
   readCatalogHtmlDigest,
   isGeneratedCatalogHtml,

package/dist/{chunk-66WTIYYG.js → chunk-LP6JHGBP.js}

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "./chunk-NECMAJHS.js";
+} from "./chunk-ZBRXXOW5.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "./chunk-RFEB4N5Q.js";
+} from "./chunk-WE5W7BRL.js";
 
 // src/filesystem/electron-provider-v2.ts
 var ElectronFileSystemProviderV2 = class extends HostFileSystemProviderV2 {