@xtrable-ltd/nanoesis 0.1.23 → 0.1.25

package/dist/adapter-azure-blob.d.ts

@@ -20,8 +20,12 @@ interface BlobContainer {
     list(prefix: string): Promise<readonly string[]>;
     /** A blob's bytes, or null if it does not exist. */
     read(name: string): Promise<Uint8Array | null>;
-    /** Create or overwrite a blob with the given bytes and content type. */
-    write(name: string, data: Uint8Array, contentType: string): Promise<void>;
+    /**
+     * Create or overwrite a blob with the given bytes and content type. `cacheControl`, when
+     * given, is stored as the blob's `Cache-Control` so a static-website read serves the right
+     * freshness (DESIGN §11); omitted for the editor's working blobs.
+     */
+    write(name: string, data: Uint8Array, contentType: string, cacheControl?: string): Promise<void>;
     /** Delete a blob; a missing blob is a no-op (idempotent). */
     remove(name: string): Promise<void>;
 }
@@ -31,13 +35,16 @@ interface BlobContainer {
  */
 declare class InMemoryBlobContainer implements BlobContainer {
     private readonly blobs;
+    private readonly cacheControls;
     constructor(seed?: Readonly<Record<string, Uint8Array | string>>);
     list(prefix: string): Promise<readonly string[]>;
     read(name: string): Promise<Uint8Array | null>;
-    write(name: string, data: Uint8Array, contentType?: string): Promise<void>;
+    write(name: string, data: Uint8Array, contentType?: string, cacheControl?: string): Promise<void>;
     remove(name: string): Promise<void>;
     /** Test helper: the current blob names. */
     get names(): readonly string[];
+    /** Test helper: the `Cache-Control` a blob was written with, if any. */
+    cacheControlOf(name: string): string | undefined;
 }
 
 /**
@@ -56,7 +63,7 @@ declare class AzureBlobContainer implements BlobContainer {
     ensureContainer(): Promise<void>;
     list(prefix: string): Promise<readonly string[]>;
     read(name: string): Promise<Uint8Array | null>;
-    write(name: string, data: Uint8Array, contentType: string): Promise<void>;
+    write(name: string, data: Uint8Array, contentType: string, cacheControl?: string): Promise<void>;
     remove(name: string): Promise<void>;
 }
 
@@ -71,7 +78,7 @@ declare class BlobContainerStore implements BlobStore {
     private readonly container;
     constructor(container: BlobContainer);
     get(key: string): Promise<Uint8Array | undefined>;
-    put(key: string, bytes: Uint8Array): Promise<void>;
+    put(key: string, bytes: Uint8Array, cacheControl?: string): Promise<void>;
     delete(key: string): Promise<void>;
 }
 
@@ -87,7 +94,7 @@ declare class BlobArtifactSink implements ArtifactSink {
     private readonly container;
     constructor(container: BlobContainer);
     wipe(): Promise<void>;
-    write(path: string, contents: string | Uint8Array): Promise<void>;
+    write(path: string, contents: string | Uint8Array, cacheControl?: string): Promise<void>;
 }
 
 /**

package/dist/adapter-azure-blob.js

@@ -1,10 +1,11 @@
 import {
   contentTypeFor
-} from "./chunk-WHK3SBV7.js";
+} from "./chunk-H6ZHZWDJ.js";
 
 // ../../adapters/azure-blob/src/container.ts
 var InMemoryBlobContainer = class {
   blobs = /* @__PURE__ */ new Map();
+  cacheControls = /* @__PURE__ */ new Map();
   constructor(seed = {}) {
     for (const [name, value] of Object.entries(seed)) {
       this.blobs.set(name, typeof value === "string" ? new TextEncoder().encode(value) : value);
@@ -20,9 +21,10 @@ var InMemoryBlobContainer = class {
   async read(name) {
     return this.blobs.get(name) ?? null;
   }
-  async write(name, data, contentType) {
+  async write(name, data, contentType, cacheControl) {
     void contentType;
     this.blobs.set(name, data);
+    if (cacheControl !== void 0) this.cacheControls.set(name, cacheControl);
   }
   async remove(name) {
     this.blobs.delete(name);
@@ -31,6 +33,10 @@ var InMemoryBlobContainer = class {
   get names() {
     return [...this.blobs.keys()].sort();
   }
+  /** Test helper: the `Cache-Control` a blob was written with, if any. */
+  cacheControlOf(name) {
+    return this.cacheControls.get(name);
+  }
 };
 
 // ../../adapters/azure-blob/src/azure-container.ts
@@ -68,9 +74,12 @@ var AzureBlobContainer = class _AzureBlobContainer {
       throw error;
     }
   }
-  async write(name, data, contentType) {
+  async write(name, data, contentType, cacheControl) {
     await this.client.getBlockBlobClient(name).uploadData(Buffer.from(data), {
-      blobHTTPHeaders: { blobContentType: contentType }
+      blobHTTPHeaders: {
+        blobContentType: contentType,
+        ...cacheControl !== void 0 && { blobCacheControl: cacheControl }
+      }
     });
   }
   async remove(name) {
@@ -92,9 +101,9 @@ var BlobContainerStore = class {
   async get(key) {
     return await this.container.read(normalizeBlobName(key)) ?? void 0;
   }
-  async put(key, bytes) {
+  async put(key, bytes, cacheControl) {
     const name = normalizeBlobName(key);
-    await this.container.write(name, bytes, contentTypeFor(name));
+    await this.container.write(name, bytes, contentTypeFor(name), cacheControl);
   }
   async delete(key) {
     await this.container.remove(normalizeBlobName(key));
@@ -112,10 +121,10 @@ var BlobArtifactSink = class {
       await this.container.remove(name);
     }
   }
-  async write(path, contents) {
+  async write(path, contents, cacheControl) {
     const name = normalizeBlobName(path);
     const data = typeof contents === "string" ? new TextEncoder().encode(contents) : contents;
-    await this.container.write(name, data, contentTypeFor(name));
+    await this.container.write(name, data, contentTypeFor(name), cacheControl);
   }
 };
 
@@ -124,7 +133,10 @@ function azureStorage(container) {
   const store = new BlobContainerStore(container);
   return {
     get: (key) => store.get(key),
-    put: (key, bytes) => store.put(key, bytes),
+    // Forward `cacheControl` (DESIGN §11): this is the published-site sink `createEditor`
+    // actually wires (`asSink(azureStorage(website))`), so dropping the arg here silently
+    // strips the publish Cache-Control before it reaches the blob.
+    put: (key, bytes, cacheControl) => store.put(key, bytes, cacheControl),
     delete: (key) => store.delete(key),
     wipe: async () => {
       for (const name of await container.list("")) await container.remove(name);

package/dist/{chunk-WHK3SBV7.js → chunk-H6ZHZWDJ.js}

@@ -1554,6 +1554,13 @@ function renderAuthors(value, directory) {
   return joinAuthors(names);
 }
 
+// ../engine/src/publish/cache-control.ts
+var CACHE_REVALIDATE = "no-cache";
+var CACHE_IMMUTABLE = "public, max-age=31536000, immutable";
+function cacheControlFor(artifact) {
+  return artifact.cacheControl ?? CACHE_REVALIDATE;
+}
+
 // ../engine/src/media/media.ts
 var DEFAULT_WIDTHS = [400, 800, 1200, 1600];
 var MIME = {
@@ -1591,7 +1598,7 @@ async function processImage(input, assetPath, encoder) {
   const artifacts = [];
   const urlOf = (variant) => {
     const path = `${base}.${hash}-${variant.width}.${extOf(variant.format)}`;
-    artifacts.push({ path, contents: variant.bytes });
+    artifacts.push({ path, contents: variant.bytes, cacheControl: CACHE_IMMUTABLE });
     return `/${path}`;
   };
   const byFormat = /* @__PURE__ */ new Map();
@@ -2786,11 +2793,11 @@ async function validateSite(source) {
       deriveFields(snapshotHtml, components),
       deriveFields(currentHtml, components)
     );
-    const destructive = new Set(
-      delta.typeChanged.filter((change) => change.destructive).map((change) => change.name)
+    const renderDrift = new Set(
+      delta.typeChanged.filter((change) => change.destructive && valueKindOf(change.from) !== valueKindOf(change.to)).map((change) => change.name)
     );
-    driftFieldsCache.set(templateName, destructive);
-    return destructive;
+    driftFieldsCache.set(templateName, renderDrift);
+    return renderDrift;
   };
   const snapshotNameCache = /* @__PURE__ */ new Map();
   const highestSnapshotName = async (baseName) => {
@@ -2874,7 +2881,7 @@ async function validateSite(source) {
           add(
             "warning",
             "content.type-drift",
-            `"${node.path}" has field${affected.length === 1 ? "" : "s"} whose type changed destructively in template "${templateName}": ${affected.map((f) => `"${f}"`).join(", ")}. The value will render under the new type (commonly HTML escaped as text). Open the Migrations workspace to migrate.`,
+            `"${node.path}" has field${affected.length === 1 ? "" : "s"} whose stored value now renders under a different kind in template "${templateName}": ${affected.map((f) => `"${f}"`).join(", ")}. The value carries over but may look different (e.g. rich text shown as escaped text). Re-edit the field, or revert the template's type change if it wasn't intended.`,
             node.path
           );
         }
@@ -3093,14 +3100,14 @@ async function publishSite(source, sink, options = {}) {
     hashByPath.set(artifact.path, contentHash(asBytes(artifact.contents)));
   const hashFor = (path) => hashByPath.get(path);
   const stamped = artifacts.map(
-    (artifact) => typeof artifact.contents === "string" && artifact.path.endsWith(".html") ? { path: artifact.path, contents: cacheBustAssets(artifact.contents, hashFor) } : artifact
+    (artifact) => typeof artifact.contents === "string" && artifact.path.endsWith(".html") ? { ...artifact, contents: cacheBustAssets(artifact.contents, hashFor) } : artifact
   );
   const byPath = /* @__PURE__ */ new Map();
-  for (const artifact of [...stamped, ...passthrough]) byPath.set(artifact.path, artifact.contents);
+  for (const artifact of [...stamped, ...passthrough]) byPath.set(artifact.path, artifact);
   await mapWithConcurrency(
-    [...byPath],
+    [...byPath.values()],
     writeConcurrency,
-    ([path, contents]) => sink.write(path, contents)
+    (artifact) => sink.write(artifact.path, artifact.contents, cacheControlFor(artifact))
   );
   await purge.purgeAll();
   return { ok: true, validation, written: [...byPath.keys()].sort(), summary };
@@ -3155,13 +3162,20 @@ function normalizePath2(path) {
 }
 var InMemoryArtifactSink = class {
   store = /* @__PURE__ */ new Map();
-  async write(path, contents) {
-    this.store.set(normalizePath2(path), contents);
+  cacheControls = /* @__PURE__ */ new Map();
+  async write(path, contents, cacheControl) {
+    const key = normalizePath2(path);
+    this.store.set(key, contents);
+    if (cacheControl !== void 0) this.cacheControls.set(key, cacheControl);
   }
   /** The artifacts written so far, path→contents, for assertions in tests. */
   get written() {
     return this.store;
   }
+  /** The `Cache-Control` an artifact was written with, for assertions in tests. */
+  cacheControlOf(path) {
+    return this.cacheControls.get(normalizePath2(path));
+  }
 };
 
 // ../engine/src/identity.ts
@@ -3393,6 +3407,9 @@ export {
   toAuthorRefs,
   joinAuthors,
   renderAuthors,
+  CACHE_REVALIDATE,
+  CACHE_IMMUTABLE,
+  cacheControlFor,
   contentHash,
   processImage,
   buildPictureMarkup,

package/dist/{chunk-SHGYQTZ7.js → chunk-TEIQFPNO.js}

@@ -17,7 +17,7 @@ import {
   renderReferenceMarkdown,
   validateSite,
   workingStoreRoundTripDiagnostic
-} from "./chunk-WHK3SBV7.js";
+} from "./chunk-H6ZHZWDJ.js";
 
 // ../editor-api/src/scaffold.ts
 var HOME_HTML = `<!doctype html>
@@ -911,7 +911,11 @@ async function anyPublishedContentItem(store, dir = "content") {
 function asSink(storage) {
   const encoder = new TextEncoder();
   return {
-    write: (path, contents) => storage.put(path, typeof contents === "string" ? encoder.encode(contents) : contents)
+    write: (path, contents, cacheControl) => storage.put(
+      path,
+      typeof contents === "string" ? encoder.encode(contents) : contents,
+      cacheControl
+    )
   };
 }
 function createEditor(config) {

package/dist/editor-api.js

@@ -21,8 +21,8 @@ import {
   serveEditorAsset,
   templateSnapshotIntegrityDiagnostic,
   templateSuffixConflictDiagnostic
-} from "./chunk-SHGYQTZ7.js";
-import "./chunk-WHK3SBV7.js";
+} from "./chunk-TEIQFPNO.js";
+import "./chunk-H6ZHZWDJ.js";
 export {
   FileBrandingStore,
   InMemoryBrandingStore,

package/dist/index.d.ts

@@ -149,8 +149,12 @@ declare function parseSortFile(raw: unknown): SortFile;
 interface BlobStore {
     /** The bytes stored at `key`, or `undefined` if nothing is stored there. */
     get(key: string): Promise<Uint8Array | undefined>;
-    /** Create or overwrite `key` with `bytes`. */
-    put(key: string, bytes: Uint8Array): Promise<void>;
+    /**
+     * Create or overwrite `key` with `bytes`. `cacheControl` is an optional `Cache-Control`
+     * value the publish sink passes for a served-website store to persist (DESIGN §11); the
+     * editor's working store omits it, and a store with no header model ignores it.
+     */
+    put(key: string, bytes: Uint8Array, cacheControl?: string): Promise<void>;
     /** Remove `key`. Deleting an absent key is a no-op (idempotent). */
     delete(key: string): Promise<void>;
 }
@@ -310,6 +314,12 @@ interface Artifact {
     /** Output path relative to the published root, e.g. "blog/first/index.html". */
     readonly path: string;
     readonly contents: string | Uint8Array;
+    /**
+     * The `Cache-Control` policy for this artifact (DESIGN §11; see
+     * {@link cacheControlFor}). Absent means revalidate-every-load; a fingerprinted
+     * (content-hashed) asset sets it to immutable. Only the publish sink reads it.
+     */
+    readonly cacheControl?: string;
 }
 /**
  * Compile a whole site to artifacts (DESIGN §15 step 9, compile phase). Walks the
@@ -1291,8 +1301,13 @@ declare const noopPurgeService: PurgeService;
  * Paths are POSIX-style and relative to the published root (e.g. "blog/first/index.html").
  */
 interface ArtifactSink {
-    /** Write one artifact, creating any intermediate structure the backing store needs. */
-    write(path: string, contents: string | Uint8Array): Promise<void>;
+    /**
+     * Write one artifact, creating any intermediate structure the backing store needs.
+     * `cacheControl` is the artifact's `Cache-Control` policy (DESIGN §11): a store that
+     * serves HTTP (the blob sink) persists it; one with no header model (the filesystem
+     * sink) ignores it. Optional so non-publish callers (e.g. a port probe) can omit it.
+     */
+    write(path: string, contents: string | Uint8Array, cacheControl?: string): Promise<void>;
 }
 /**
  * An in-memory {@link ArtifactSink} backed by a flat path→contents map. This is the
@@ -1301,9 +1316,12 @@ interface ArtifactSink {
  */
 declare class InMemoryArtifactSink implements ArtifactSink {
     private readonly store;
-    write(path: string, contents: string | Uint8Array): Promise<void>;
+    private readonly cacheControls;
+    write(path: string, contents: string | Uint8Array, cacheControl?: string): Promise<void>;
     /** The artifacts written so far, path→contents, for assertions in tests. */
     get written(): ReadonlyMap<string, string | Uint8Array>;
+    /** The `Cache-Control` an artifact was written with, for assertions in tests. */
+    cacheControlOf(path: string): string | undefined;
 }
 
 interface PublishOptions extends CompileSiteOptions {
@@ -1365,6 +1383,39 @@ interface PublishResult {
  */
 declare function publishSite(source: ContentSource, sink: ArtifactSink, options?: PublishOptions): Promise<PublishResult>;
 
+/**
+ * Cache-Control policy for published artifacts (DESIGN §11; see
+ * docs/cache-busting-and-browser-cache.md). The published site is served from a static
+ * store ($web / a folder behind a CDN) that sets no freshness directive of its own, so
+ * without an explicit header browsers fall back to *heuristic* caching (RFC 9111 §4.2.2)
+ * and keep serving a stale copy until a hard refresh. A CDN purge can't fix that, it
+ * clears the edge, not a visitor's browser. So publish stamps each artifact with the
+ * policy for its class, and the storage port persists it (the Azure adapter as the blob's
+ * `cacheControl`; the filesystem adapter has no header model and ignores it).
+ *
+ * Two classes today:
+ * - **Revalidate** (HTML and every non-fingerprinted file): `no-cache` means "always
+ *   check with the origin before reuse". The store serves strong `ETag`/`Last-Modified`,
+ *   so this is a cheap `304` when nothing changed and the new bytes the instant something
+ *   does, no stale window, no hard refresh.
+ * - **Immutable** (content-hashed asset filenames): cache hard and forever. Safe only
+ *   because the filename encodes the content hash, so changed bytes mean a new URL. Today
+ *   that's the responsive image variants the media pipeline emits (`hero.<hash>-800.webp`);
+ *   stable-named assets (`styles.css`) stay on revalidate until they're content-hashed too.
+ */
+/** Revalidate every load: the default for HTML and any non-fingerprinted artifact. */
+declare const CACHE_REVALIDATE = "no-cache";
+/** Cache hard and forever: only for content-hashed (fingerprinted) asset filenames. */
+declare const CACHE_IMMUTABLE = "public, max-age=31536000, immutable";
+/**
+ * The Cache-Control value for an artifact: its own policy if it declared one (a
+ * fingerprinted asset opts into {@link CACHE_IMMUTABLE}), else {@link CACHE_REVALIDATE}.
+ * Revalidate is the safe default, never serve a non-hashed file as immutable.
+ */
+declare function cacheControlFor(artifact: {
+    readonly cacheControl?: string;
+}): string;
+
 /**
  * The identity port (DESIGN §11). The engine has *no auth logic*, auth is purely an
  * HTTP-layer concern that lives in the host, but the port type lives here alongside
@@ -1714,4 +1765,4 @@ declare function createDiagnosticRegistry(): DiagnosticRegistry;
 
 declare const workingStoreRoundTripDiagnostic: Diagnostic;
 
-export { type Artifact, type ArtifactSink, type AuthEndpoints, type AuthResult, type AuthorDirectory, type AuthorEntry, type AuthorOption, type AuthorRef, type AuthoringReference, type BlobStore, type BoundItem, type ChangePasswordRequest, type ChangePasswordSuccess, type CollectionConfig, type CollectionQuery, type CompileInput, type CompilePageOptions, type CompileSiteOptions, type CompiledPage, type ComponentMap, type ContentIndex, type ContentItem, ContentParseError, type ContentSource, type CreateTokenSuccess, type CreateUserRequest, DEFAULT_DIRS, DOCUMENT_SHELL, type DerivedField, type DiagnoseDeps, type Severity as DiagnoseSeverity, type Source as DiagnoseSource, type Diagnostic$1 as Diagnostic, type Diagnostic as DiagnosticCheck, type DiagnosticRegistry, type DirEntry, type DirNode, type EncodeRequest, type EncodedImage, type EncodedVariant, type EntryKind, FIELD_TYPES, type FieldPrimitive, type FieldRecord, type FieldType, type FieldTypeDef, type FieldValue, type Finding, type IdentityProvider, type ImageEncoder, type ImageFormat, type ImageInfo, InMemoryArtifactSink, InMemoryBlobStore, InMemoryContentSource, IndexedStore, type ItemNode, type LengthConstraints, type LoginRequest, type LoginSuccess, type MediaResolver, type MigrationResolution, type PageEntry, type PendingMigrationItem, type PendingMigrations, type PreBuildHook, type Principal, type PublishOptions, type PublishResult, type PublishSummary, type PurgeService, RESERVED_PREFIX, type ReconcileResult, type RedirectRule, type ReferenceContext, type ReferenceEntry, type ReferenceSection, type RefreshSuccess, type RenameResult, type Repair, type RepairArgs, type ResetPasswordRequest, type ResolveContext, type Role, type RssOptions, type SchemaDelta, type SchemaFieldRef, type Scope, type Severity$1 as Severity, type SiteConfig, type SortFile, type StampDecision, type StampRecord, type Storage, type TemplateAnalysis, type TemplateKind, type TokenContext, type TokenRef, type TreeNode, type TypeChange, type UpdateUserRequest, type UserAdminEndpoints, type UserSummary, type ValidationResult, type ValueKind, type WorkingStore, analyzeTemplate, applyMigration, baseTemplateName, bestFitSnapshot, buildAuthoringReference, buildContentIndex, buildPictureMarkup, buildRedirects, buildResolveContext, buildRss, buildSitemap, canEdit, compilePage, compileSite, compileTemplate, computeSchemaDelta, contentHash, contentTypeFor, createDiagnosticRegistry, deriveFields, detectStamp, emptyIndex, escapeHtmlAttribute, escapeHtmlText, escapeJsonStringContent, findTokens, hasRole, humanize, inferControl, isDestructiveTypeChange, isFieldType, isReservedVersionedPath, isVersionedTemplateName, joinAuthors, loadComponentScripts, loadComponentStyles, loadComponents, loadContentTree, loadDocumentShell, loadIndex, loadRedirects, loadSiteConfig, loadTemplate, nextVersionNumber, noopPurgeService, outputPathForItem, parseContentItem, parseRedirects, parseSortFile, pendingMigrations, processImage, publishSite, reconcileIndex, renderAuthors, renderReferenceMarkdown, sanitizeUrl, saveIndex, slugify, snapshotName, textContent, toAuthorRefs, urlForItem, validateSite, valueKindOf, versionNumber, wholeValueToken, workingStoreRoundTripDiagnostic };
+export { type Artifact, type ArtifactSink, type AuthEndpoints, type AuthResult, type AuthorDirectory, type AuthorEntry, type AuthorOption, type AuthorRef, type AuthoringReference, type BlobStore, type BoundItem, CACHE_IMMUTABLE, CACHE_REVALIDATE, type ChangePasswordRequest, type ChangePasswordSuccess, type CollectionConfig, type CollectionQuery, type CompileInput, type CompilePageOptions, type CompileSiteOptions, type CompiledPage, type ComponentMap, type ContentIndex, type ContentItem, ContentParseError, type ContentSource, type CreateTokenSuccess, type CreateUserRequest, DEFAULT_DIRS, DOCUMENT_SHELL, type DerivedField, type DiagnoseDeps, type Severity as DiagnoseSeverity, type Source as DiagnoseSource, type Diagnostic$1 as Diagnostic, type Diagnostic as DiagnosticCheck, type DiagnosticRegistry, type DirEntry, type DirNode, type EncodeRequest, type EncodedImage, type EncodedVariant, type EntryKind, FIELD_TYPES, type FieldPrimitive, type FieldRecord, type FieldType, type FieldTypeDef, type FieldValue, type Finding, type IdentityProvider, type ImageEncoder, type ImageFormat, type ImageInfo, InMemoryArtifactSink, InMemoryBlobStore, InMemoryContentSource, IndexedStore, type ItemNode, type LengthConstraints, type LoginRequest, type LoginSuccess, type MediaResolver, type MigrationResolution, type PageEntry, type PendingMigrationItem, type PendingMigrations, type PreBuildHook, type Principal, type PublishOptions, type PublishResult, type PublishSummary, type PurgeService, RESERVED_PREFIX, type ReconcileResult, type RedirectRule, type ReferenceContext, type ReferenceEntry, type ReferenceSection, type RefreshSuccess, type RenameResult, type Repair, type RepairArgs, type ResetPasswordRequest, type ResolveContext, type Role, type RssOptions, type SchemaDelta, type SchemaFieldRef, type Scope, type Severity$1 as Severity, type SiteConfig, type SortFile, type StampDecision, type StampRecord, type Storage, type TemplateAnalysis, type TemplateKind, type TokenContext, type TokenRef, type TreeNode, type TypeChange, type UpdateUserRequest, type UserAdminEndpoints, type UserSummary, type ValidationResult, type ValueKind, type WorkingStore, analyzeTemplate, applyMigration, baseTemplateName, bestFitSnapshot, buildAuthoringReference, buildContentIndex, buildPictureMarkup, buildRedirects, buildResolveContext, buildRss, buildSitemap, cacheControlFor, canEdit, compilePage, compileSite, compileTemplate, computeSchemaDelta, contentHash, contentTypeFor, createDiagnosticRegistry, deriveFields, detectStamp, emptyIndex, escapeHtmlAttribute, escapeHtmlText, escapeJsonStringContent, findTokens, hasRole, humanize, inferControl, isDestructiveTypeChange, isFieldType, isReservedVersionedPath, isVersionedTemplateName, joinAuthors, loadComponentScripts, loadComponentStyles, loadComponents, loadContentTree, loadDocumentShell, loadIndex, loadRedirects, loadSiteConfig, loadTemplate, nextVersionNumber, noopPurgeService, outputPathForItem, parseContentItem, parseRedirects, parseSortFile, pendingMigrations, processImage, publishSite, reconcileIndex, renderAuthors, renderReferenceMarkdown, sanitizeUrl, saveIndex, slugify, snapshotName, textContent, toAuthorRefs, urlForItem, validateSite, valueKindOf, versionNumber, wholeValueToken, workingStoreRoundTripDiagnostic };

package/dist/index.js

@@ -1,4 +1,6 @@
 import {
+  CACHE_IMMUTABLE,
+  CACHE_REVALIDATE,
   ContentParseError,
   DEFAULT_DIRS,
   DOCUMENT_SHELL,
@@ -19,6 +21,7 @@ import {
   buildResolveContext,
   buildRss,
   buildSitemap,
+  cacheControlFor,
   canEdit,
   compilePage,
   compileSite,
@@ -75,8 +78,10 @@ import {
   versionNumber,
   wholeValueToken,
   workingStoreRoundTripDiagnostic
-} from "./chunk-WHK3SBV7.js";
+} from "./chunk-H6ZHZWDJ.js";
 export {
+  CACHE_IMMUTABLE,
+  CACHE_REVALIDATE,
   ContentParseError,
   DEFAULT_DIRS,
   DOCUMENT_SHELL,
@@ -97,6 +102,7 @@ export {
   buildResolveContext,
   buildRss,
   buildSitemap,
+  cacheControlFor,
   canEdit,
   compilePage,
   compileSite,

package/dist/mcp.js

@@ -3,8 +3,8 @@ import {
   MCP_TOOLS,
   callMcpTool,
   readMcpResource
-} from "./chunk-SHGYQTZ7.js";
-import "./chunk-WHK3SBV7.js";
+} from "./chunk-TEIQFPNO.js";
+import "./chunk-H6ZHZWDJ.js";
 
 // ../../hosts/host-mcp/src/http.ts
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
@@ -56,7 +56,7 @@ function createMcpServer(deps, identity) {
 }
 
 // ../../hosts/host-mcp/src/http.ts
-var DEFAULT_VERSION = true ? "0.1.23" : "0.0.0-workspace";
+var DEFAULT_VERSION = true ? "0.1.25" : "0.0.0-workspace";
 async function handleMcpRequest(deps, request, opts) {
   const server = createMcpServer(deps, {
     name: opts?.name ?? "nanoesis",

package/editor/assets/{MigrationsPane-hBGg21Ij.js → MigrationsPane-B0x1iqiv.js}

@@ -1,4 +1,4 @@
-import{af as Ie,aD as F,ad as Te,a7 as g,T as w,Q as e,f as n,a8 as Qe,o as a,N as H,aE as h,w as O,az as o,O as _,ar as v,p as Ue,G as X,v as Ve,g as He,aK as Xe,ax as c,aF as A,at as Y,au as _e,U as Ye,aq as Ze,a9 as ea}from"./index-DxbHJHyK.js";var aa=_('<p class="placeholder svelte-1lpfi31">Loading preview…</p>'),ta=_('<p class="error svelte-1lpfi31" role="alert"> </p>'),la=_("<option> </option>"),sa=_('<select class="svelte-1lpfi31"></select>'),ra=_('<li class="orphan svelte-1lpfi31"><div class="orphan-head svelte-1lpfi31"><code class="orphan-name svelte-1lpfi31"> </code> <span class="orphan-value svelte-1lpfi31"> </span></div> <div class="orphan-actions svelte-1lpfi31" role="radiogroup"><label class="svelte-1lpfi31"><input type="radio" value="drop"/> Drop</label> <label class="svelte-1lpfi31"><input type="radio" value="keep"/> Keep (unrendered)</label> <label class="svelte-1lpfi31"><input type="radio" value="rename"/> Rename to</label> <!></div></li>'),ia=_(`<section class="resolutions svelte-1lpfi31" aria-label="Orphan field resolutions"><h3 class="svelte-1lpfi31">Orphan fields</h3> <p class="hint svelte-1lpfi31">These fields exist in this item's JSON but the current template doesn't render them.
+import{af as Ie,aD as F,ad as Te,a7 as g,T as w,Q as e,f as n,a8 as Qe,o as a,N as H,aE as h,w as O,az as o,O as _,ar as v,p as Ue,G as X,v as Ve,g as He,aK as Xe,ax as c,aF as A,at as Y,au as _e,U as Ye,aq as Ze,a9 as ea}from"./index-oaWmlNac.js";var aa=_('<p class="placeholder svelte-1lpfi31">Loading preview…</p>'),ta=_('<p class="error svelte-1lpfi31" role="alert"> </p>'),la=_("<option> </option>"),sa=_('<select class="svelte-1lpfi31"></select>'),ra=_('<li class="orphan svelte-1lpfi31"><div class="orphan-head svelte-1lpfi31"><code class="orphan-name svelte-1lpfi31"> </code> <span class="orphan-value svelte-1lpfi31"> </span></div> <div class="orphan-actions svelte-1lpfi31" role="radiogroup"><label class="svelte-1lpfi31"><input type="radio" value="drop"/> Drop</label> <label class="svelte-1lpfi31"><input type="radio" value="keep"/> Keep (unrendered)</label> <label class="svelte-1lpfi31"><input type="radio" value="rename"/> Rename to</label> <!></div></li>'),ia=_(`<section class="resolutions svelte-1lpfi31" aria-label="Orphan field resolutions"><h3 class="svelte-1lpfi31">Orphan fields</h3> <p class="hint svelte-1lpfi31">These fields exist in this item's JSON but the current template doesn't render them.
             Pick what to do with each.</p> <ul class="orphans svelte-1lpfi31"></ul></section>`),na=_('<p class="error svelte-1lpfi31" role="alert"> </p>'),oa=_('<div class="diff svelte-1lpfi31"><section class="pane svelte-1lpfi31" aria-label="Previous version (left)"><header class="pane-head svelte-1lpfi31"><!></header> <pre class="source svelte-1lpfi31"> </pre></section> <section class="pane svelte-1lpfi31" aria-label="Current template (right)"><header class="pane-head svelte-1lpfi31"> </header> <pre class="source svelte-1lpfi31"> </pre></section></div> <!> <!> <div class="commit-bar svelte-1lpfi31"><button type="button" class="primary svelte-1lpfi31"> </button></div>',1),va=_('<header class="detail-head svelte-1lpfi31"><button type="button" class="back svelte-1lpfi31">← Back</button> <h2 class="svelte-1lpfi31"> </h2></header> <!>',1),pa=_('<p class="error svelte-1lpfi31" role="alert"> </p>'),ca=_('<p class="placeholder svelte-1lpfi31">Loading…</p>'),fa=_(`<div class="empty svelte-1lpfi31"><h3 class="svelte-1lpfi31">All caught up</h3> <p>Every content item's fields match its bound template. Migrations show up here when a
           destructive template edit (or a manual hand-edit) leaves an item with orphan fields.</p></div>`),da=_('<li class="item"><button class="item-row svelte-1lpfi31" type="button"><span class="item-path svelte-1lpfi31"><code> </code></span> <span class="item-summary svelte-1lpfi31"><!> <!> <!></span> <span class="open-icon svelte-1lpfi31">→</span></button></li>'),ua=_('<section class="group svelte-1lpfi31"><h3 class="group-title svelte-1lpfi31"><code class="svelte-1lpfi31"> </code> <span class="count svelte-1lpfi31"> </span></h3> <ul class="items svelte-1lpfi31"></ul></section>'),ma=_('<header class="list-head svelte-1lpfi31"><h2>Migrations</h2> <button type="button" class="svelte-1lpfi31"> </button></header> <!>',1),_a=_('<div class="migrations svelte-1lpfi31"><!> <!></div>');function ga(Ee,Le){Ie(Le,!0);let j=F(null),d=F(null),Z=F(!1),R=F(null),r=F(Te({})),he=F(Te({})),D=F(!1),J=F(null);g.ensureLoaded();async function Re(s){v(j,s,!0),v(r,{},!0),v(he,{},!0),v(d,null),v(R,null),v(Z,!0);try{v(d,await ea(s),!0);const f={};for(const l of e(d).orphans){const u=Se(l.name,e(d).currentTemplateFields);f[l.name]=u?{rename:u}:"keep"}v(r,f,!0)}catch(f){v(R,f instanceof Error?f.message:String(f),!0)}finally{v(Z,!1)}}function ge(){v(j,null),v(d,null),v(R,null)}function Se(s,f){const l=s.toLowerCase();for(const u of f)if(u.toLowerCase().startsWith(l)||u.toLowerCase().endsWith(l))return u;return null}async function Ce(){if(!(e(j)===null||e(d)===null)){v(D,!0),v(J,null);try{const s={drop:Object.entries(e(r)).filter(([,l])=>l==="drop").map(([l])=>l),keep:Object.entries(e(r)).filter(([,l])=>l==="keep").map(([l])=>l),rename:Object.fromEntries(Object.entries(e(r)).filter(([,l])=>typeof l=="object"&&l!==null&&"rename"in l).map(([l,u])=>[l,u.rename])),fill:{...e(he)}},f=await He(e(j),s);g.refresh().catch(()=>{}),ge()}catch(s){v(J,s instanceof Error?s.message:String(s),!0)}finally{v(D,!1)}}}function Pe(s){return typeof s=="string"?s:JSON.stringify(s)}const qe=Xe(()=>g.list===null?[]:Object.entries(g.list.byTemplate).map(([s,f])=>({template:s,items:[...f].sort((l,u)=>l.path.localeCompare(u.path))})));var be=_a(),xe=a(be);{var Be=s=>{var f=va(),l=H(f),u=a(l),ee=o(u,2),ae=a(ee),te=o(l,2);{var le=i=>{var m=aa();n(i,m)},se=i=>{var m=ta(),k=a(m);h(()=>c(k,e(R))),n(i,m)},re=i=>{var m=oa(),k=H(m),E=a(k),M=a(E),K=a(M);{var W=p=>{var x=A();h(()=>c(x,`Before — ${e(d).left.template??""}`)),n(p,x)},$=p=>{var x=A("Before — no snapshot available");n(p,x)};w(K,p=>{e(d).left?p(W):p($,-1)})}var ie=o(M,2),ne=a(ie),oe=o(E,2),z=a(oe),S=a(z),b=o(z,2),G=a(b),C=o(k,2);{var I=p=>{var x=ia(),P=o(a(x),4);X(P,21,()=>e(d).orphans,q=>q.name,(q,t)=>{var y=ra(),U=a(y),ye=a(U),Je=a(ye),Ke=o(ye,2),We=a(Ke),we=o(U,2),ke=a(we),fe=a(ke),Fe=o(ke,2),de=a(Fe),Oe=o(Fe,2),ue=a(Oe),$e=o(Oe,2);{var ze=B=>{var T=sa();X(T,20,()=>e(d).currentTemplateFields,N=>N,(N,me)=>{var V=la(),Ge=a(V),Me={};h(()=>{c(Ge,me),Me!==(Me=me)&&(V.value=(V.__value=me)??"")}),n(N,V)});var je;Ye(T),h(()=>{je!==(je=e(r)[e(t).name].rename)&&(T.value=(T.__value=e(r)[e(t).name].rename)??"",Ze(T,e(r)[e(t).name].rename))}),O("change",T,N=>v(r,{...e(r),[e(t).name]:{rename:N.currentTarget.value}},!0)),n(B,T)};w($e,B=>{typeof e(r)[e(t).name]=="object"&&e(r)[e(t).name]!==null&&"rename"in e(r)[e(t).name]&&B(ze)})}h(B=>{c(Je,e(t).name),c(We,B),Y(we,"aria-label",`Resolution for ${e(t).name}`),Y(fe,"name",`d-${e(t).name}`),_e(fe,e(r)[e(t).name]==="drop"),Y(de,"name",`d-${e(t).name}`),_e(de,e(r)[e(t).name]==="keep"),Y(ue,"name",`d-${e(t).name}`),_e(ue,typeof e(r)[e(t).name]=="object"&&e(r)[e(t).name]!==null&&"rename"in e(r)[e(t).name])},[()=>Pe(e(t).value)]),O("change",fe,()=>v(r,{...e(r),[e(t).name]:"drop"},!0)),O("change",de,()=>v(r,{...e(r),[e(t).name]:"keep"},!0)),O("change",ue,()=>v(r,{...e(r),[e(t).name]:{rename:e(d).currentTemplateFields[0]??""}},!0)),n(q,y)}),n(p,x)};w(C,p=>{e(d).orphans.length>0&&p(I)})}var Q=o(C,2);{var ve=p=>{var x=na(),P=a(x);h(()=>c(P,e(J))),n(p,x)};w(Q,p=>{e(J)&&p(ve)})}var pe=o(Q,2),L=a(pe),ce=a(L);h(()=>{var p;c(ne,((p=e(d).left)==null?void 0:p.html)??"(no snapshot covers this item)"),c(S,`After — ${e(d).right.template??""}`),c(G,e(d).right.html),L.disabled=e(D)||e(d).orphans.length===0,c(ce,e(D)?"Migrating…":"Migrate item")}),O("click",L,Ce),n(i,m)};w(te,i=>{e(Z)?i(le):e(R)?i(se,1):e(d)&&i(re,2)})}h(()=>c(ae,e(j))),O("click",u,ge),n(s,f)},Ne=s=>{var f=ma(),l=H(f),u=o(a(l),2),ee=a(u),ae=o(l,2);{var te=i=>{var m=pa(),k=a(m);h(()=>c(k,g.error)),n(i,m)},le=i=>{var m=ca();n(i,m)},se=i=>{var m=fa();n(i,m)},re=i=>{var m=Ue(),k=H(m);X(k,17,()=>e(qe),E=>E.template,(E,M)=>{var K=ua(),W=a(K),$=a(W),ie=a($),ne=o($,2),oe=a(ne),z=o(W,2);X(z,21,()=>e(M).items,S=>S.path,(S,b)=>{var G=da(),C=a(G),I=a(C),Q=a(I),ve=a(Q),pe=o(I,2),L=a(pe);{var ce=t=>{var y=A();h(U=>c(y,`${e(b).orphanFields.length??""} orphan field${e(b).orphanFields.length===1?"":"s"}:
                       ${U??""}`),[()=>e(b).orphanFields.join(", ")]),n(t,y)};w(L,t=>{e(b).orphanFields.length>0&&t(ce)})}var p=o(L,2);{var x=t=>{var y=A();h(()=>c(y,`· ${e(b).missingRequiredFields.length??""} missing required`)),n(t,y)};w(p,t=>{e(b).missingRequiredFields.length>0&&t(x)})}var P=o(p,2);{var q=t=>{var y=A();h(()=>c(y,`· best-fit: ${e(b).bestFitSnapshot??""}`)),n(t,y)};w(P,t=>{e(b).bestFitSnapshot&&t(q)})}h(()=>c(ve,e(b).path)),O("click",C,()=>Re(e(b).path)),n(S,G)}),h(()=>{c(ie,e(M).template),c(oe,`${e(M).items.length??""} item${e(M).items.length===1?"":"s"}`)}),n(E,K)}),n(i,m)};w(ae,i=>{g.error?i(te):g.loading&&g.list===null?i(le,1):g.count===0?i(se,2):i(re,-1)})}h(()=>{u.disabled=g.loading,c(ee,g.loading?"Refreshing…":"Refresh")}),O("click",u,()=>g.refresh()),n(s,f)};w(xe,s=>{e(j)!==null?s(Be):s(Ne,-1)})}var Ae=o(xe,2);{var De=s=>{};w(Ae,s=>{!e(j)&&g.list===null&&s(De)})}n(Ee,be),Qe()}Ve(["click","change"]);export{ga as default};