@cosmicdrift/kumiko-samples 0.368.0 → 0.370.0

package/packages/bundled-features/src/template-resolver/handlers/template-write.ts

@@ -14,20 +14,20 @@ import {
   type WriteFailure,
   writeFailure,
 } from "@cosmicdrift/kumiko-framework/errors";
-import { requireForTenant } from "../../shared/index.js";
-import type { ContentFormat, TemplateKind } from "../constants.js";
-import type { TemplateWriteScope } from "../layout-regions.js";
-import { TemplateResolverErrors } from "../qualified-names.js";
-import { type TemplateResourceRow, templateResourcesTable } from "../table.js";
-import { activationChanges, serializeTemplateDraft } from "../template-draft.js";
-import { isSystemOnlyTemplate } from "../template-system-only.js";
-import type { TemplateValidation } from "../template-validation.js";
-import { executor } from "./shared.js";
+import { requireForTenant } from "../../shared/index.ts";
+import type { ContentFormat, TemplateKind } from "../constants.ts";
+import type { TemplateWriteScope } from "../layout-regions.ts";
+import { TemplateResolverErrors } from "../qualified-names.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "../table.ts";
+import { activationChanges, serializeTemplateDraft } from "../template-draft.ts";
+import { isSystemOnlyTemplate } from "../template-system-only.ts";
+import type { TemplateValidation } from "../template-validation.ts";
+import { executor } from "./shared.ts";
 import {
   evaluateTemplateWrite,
   type TemplateWriteInput,
   type TemplateWriteResult,
-} from "./template-gates.js";
+} from "./template-gates.ts";
 
 export type TemplateRowPayload = {
   readonly slug: string;

package/packages/bundled-features/src/template-resolver/handlers/tenant-overrides.query.ts

@@ -1,11 +1,11 @@
 import { selectMany } from "@cosmicdrift/kumiko-framework/db";
 import { defineQueryHandler, SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import { TenantQueries } from "../../tenant/index.js";
-import { type TemplateResourceRow, templateResourcesTable } from "../table.js";
-import { servedVersionOf } from "../template-draft.js";
-import { buildOverrideDiff } from "./override-diff.js";
-import { kindSchema, localeSchema, templateSlugSchema } from "./shared.js";
+import { TenantQueries } from "../../tenant/index.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "../table.ts";
+import { servedVersionOf } from "../template-draft.ts";
+import { buildOverrideDiff } from "./override-diff.ts";
+import { kindSchema, localeSchema, templateSlugSchema } from "./shared.ts";
 
 const TENANT_OVERRIDES_REASON =
   "SystemAdmin template overview lists which tenants override one system template; it reads tenant-scope template rows of every tenant (and the system row for the optional per-tenant diff), which the tenant-scoped db cannot reach";

package/packages/bundled-features/src/template-resolver/handlers/toggle-status.write.ts

@@ -11,12 +11,12 @@ import {
   writeFailure,
 } from "@cosmicdrift/kumiko-framework/errors";
 import * as z from "zod";
-import { requireForTenant } from "../../shared/index.js";
-import type { TemplateResourceRow } from "../table.js";
-import { templateResourcesTable } from "../table.js";
-import { activationChanges, parseTemplateDraft, toWorkingRow } from "../template-draft.js";
-import { executor } from "./shared.js";
-import { publishGateIssues } from "./template-gates.js";
+import { requireForTenant } from "../../shared/index.ts";
+import type { TemplateResourceRow } from "../table.ts";
+import { templateResourcesTable } from "../table.ts";
+import { activationChanges, parseTemplateDraft, toWorkingRow } from "../template-draft.ts";
+import { executor } from "./shared.ts";
+import { publishGateIssues } from "./template-gates.ts";
 
 type TemplateStatus = "active" | "archived";
 export type StatusTarget = "own" | "system";

package/packages/bundled-features/src/template-resolver/handlers/upsert-system.write.ts

@@ -1,7 +1,7 @@
 import { defineWriteHandler, SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
-import { resolveTemplateVariables } from "../template-validation.js";
-import { upsertPayloadSchema } from "./shared.js";
-import { writeTemplateRow } from "./template-write.js";
+import { resolveTemplateVariables } from "../template-validation.ts";
+import { upsertPayloadSchema } from "./shared.ts";
+import { writeTemplateRow } from "./template-write.ts";
 
 // System-Template anlegen/updaten. Liegt unter SYSTEM_TENANT_ID,
 // scope='system'. Nur SystemAdmin (globale Rolle). TenantAdmin kann

package/packages/bundled-features/src/template-resolver/handlers/upsert-tenant.write.ts

@@ -1,8 +1,8 @@
 import { defineWriteHandler, type TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import { resolveTemplateVariables } from "../template-validation.js";
-import { upsertPayloadSchema } from "./shared.js";
-import { writeTemplateRow } from "./template-write.js";
+import { resolveTemplateVariables } from "../template-validation.ts";
+import { upsertPayloadSchema } from "./shared.ts";
+import { writeTemplateRow } from "./template-write.ts";
 
 // Tenant-Override anlegen/updaten. Liegt unter event.user.tenantId,
 // scope='tenant'. Default-Status='draft' — User publisht explizit

package/packages/bundled-features/src/template-resolver/handlers/usage.query.ts

@@ -1,11 +1,11 @@
 import { selectMany } from "@cosmicdrift/kumiko-framework/db";
 import { defineQueryHandler } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import { TEMPLATE_KINDS } from "../constants.js";
-import { type TemplateResourceRow, templateResourcesTable } from "../table.js";
-import { templateSlugSchema } from "../template-meta.js";
-import { collectTemplateUsage } from "../template-usage.js";
-import { effectiveMailLayoutSlugs } from "./overview.query.js";
+import { TEMPLATE_KINDS } from "../constants.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "../table.ts";
+import { templateSlugSchema } from "../template-meta.ts";
+import { collectTemplateUsage } from "../template-usage.ts";
+import { effectiveMailLayoutSlugs } from "./overview.query.ts";
 
 const MAIL_ROW_LIMIT = 5000;
 

package/packages/bundled-features/src/template-resolver/handlers/validate.query.ts

@@ -6,14 +6,14 @@ import {
   SYSTEM_TENANT_ID,
 } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import type { ContentFormat, UpsertKind } from "../constants.js";
-import type { TemplateWriteScope } from "../layout-regions.js";
-import { imageResourceKeysOf } from "../linked-resources.js";
-import { type TemplateResourceRow, templateResourcesTable } from "../table.js";
-import { isSystemAdmin } from "../template-draft.js";
-import { resolveTemplateVariables, systemPlaceholdersFor } from "../template-validation.js";
-import { contentFormatSchema, kindSchema, localeSchema, templateSlugSchema } from "./shared.js";
-import { evaluateTemplateWrite } from "./template-gates.js";
+import type { ContentFormat, UpsertKind } from "../constants.ts";
+import type { TemplateWriteScope } from "../layout-regions.ts";
+import { imageResourceKeysOf } from "../linked-resources.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "../table.ts";
+import { isSystemAdmin } from "../template-draft.ts";
+import { resolveTemplateVariables, systemPlaceholdersFor } from "../template-validation.ts";
+import { contentFormatSchema, kindSchema, localeSchema, templateSlugSchema } from "./shared.ts";
+import { evaluateTemplateWrite } from "./template-gates.ts";
 
 async function knownResourceKeys(
   db: Parameters<typeof selectMany>[0],

package/packages/bundled-features/src/template-resolver/index.ts

@@ -5,13 +5,13 @@ export {
   TemplateNotFoundError,
   type TemplateResolverApi,
   type TemplateResource,
-} from "./api.js";
+} from "./api.ts";
 export {
   type CompileDocumentBodyOptions,
   collectDocumentResourceKeys,
   compileDocumentBodyToHandlebars,
   toResourceDataUri,
-} from "./compile-document-body.js";
+} from "./compile-document-body.ts";
 export {
   CONTENT_FORMATS,
   type ContentFormat,
@@ -41,7 +41,7 @@ export {
   type TemplateStatus,
   UPSERT_KINDS,
   type UpsertKind,
-} from "./constants.js";
+} from "./constants.ts";
 export {
   type DocumentViolation,
   type DocumentViolationCode,
@@ -51,7 +51,7 @@ export {
   type SanitizeHtmlResult,
   sanitizeDocumentHtml,
   sanitizeTemplateBody,
-} from "./document-sanitizer.js";
+} from "./document-sanitizer.ts";
 export {
   DOCUMENT_CONDITION_ATTRIBUTE,
   DOCUMENT_NODE_NAMES,
@@ -74,28 +74,28 @@ export {
   isDocumentPlaceholderHref,
   isDocumentReferenceName,
   isDocumentResourceKey,
-} from "./document-schema.js";
-export { createTemplateResolverFeature } from "./feature.js";
-export type { LayoutSourceResponse, LayoutSourceRow } from "./handlers/layout-source.query.js";
+} from "./document-schema.ts";
+export { createTemplateResolverFeature } from "./feature.ts";
+export type { LayoutSourceResponse, LayoutSourceRow } from "./handlers/layout-source.query.ts";
 export type {
   OverviewKindGroup,
   OverviewOrigin,
   OverviewResponse,
   OverviewRow,
   OverviewUsage,
-} from "./handlers/overview.query.js";
-export { localeSchema } from "./handlers/shared.js";
+} from "./handlers/overview.query.ts";
+export { localeSchema } from "./handlers/shared.ts";
 export {
   isHexColor,
   type MailLayoutAppearance,
   mailLayoutAppearance,
-} from "./layout-appearance.js";
+} from "./layout-appearance.ts";
 export {
   type LayoutRegions,
   readLayoutRegions,
   type SanitizeLayoutResult,
   sanitizeLayoutHtml,
-} from "./layout-regions.js";
+} from "./layout-regions.ts";
 export {
   fileAttachmentsOf,
   imageLinksOf,
@@ -104,28 +104,28 @@ export {
   pdfAttachmentLinksOf,
   type TemplatePdfAttachmentLink,
   templatePdfAttachmentLinkSchema,
-} from "./linked-resources.js";
-export { prepareDocumentForPrint } from "./print-document.js";
+} from "./linked-resources.ts";
+export { prepareDocumentForPrint } from "./print-document.ts";
 export {
   TEMPLATE_RESOLVER_FEATURE,
   TemplateResolverErrors,
   TemplateResolverHandlers,
   TemplateResolverQueries,
-} from "./qualified-names.js";
-export { mapRecordToVariables } from "./record-mapping.js";
+} from "./qualified-names.ts";
+export { mapRecordToVariables } from "./record-mapping.ts";
 export {
   type PreparedTemplateImage,
   prepareTemplateResourceBeforeTransaction,
   readTemplateResourceMaxBytes,
   type StoredTemplateResource,
   storePreparedTemplateResource,
-} from "./store-template-resource.js";
+} from "./store-template-resource.ts";
 export {
   type TemplateResourceRow,
   templateResourceEntity,
   templateResourcesTable,
-} from "./table.js";
-export { type TemplateBundle, templateBundleSchema } from "./template-bundle.js";
+} from "./table.ts";
+export { type TemplateBundle, templateBundleSchema } from "./template-bundle.ts";
 export {
   isMailTemplateMeta,
   type LayoutTemplateMeta,
@@ -144,11 +144,11 @@ export {
   type TemplateMetaIssue,
   type TemplateMetaResult,
   templateSlugSchema,
-} from "./template-meta.js";
-export { type DocumentDraftOutcome, evaluateDocumentDraft } from "./template-preview.js";
-export { readTemplateResource, type TemplateResourceFile } from "./template-resources.js";
-export { isSystemOnlyTemplate } from "./template-system-only.js";
-export { collectTemplateUsage, type TemplateUsageEntry } from "./template-usage.js";
+} from "./template-meta.ts";
+export { type DocumentDraftOutcome, evaluateDocumentDraft } from "./template-preview.ts";
+export { readTemplateResource, type TemplateResourceFile } from "./template-resources.ts";
+export { isSystemOnlyTemplate } from "./template-system-only.ts";
+export { collectTemplateUsage, type TemplateUsageEntry } from "./template-usage.ts";
 export {
   hasPlaceholderProblems,
   resolveTemplateVariables,
@@ -156,9 +156,9 @@ export {
   systemPlaceholdersFor,
   type TemplateValidation,
   validateTemplatePlaceholders,
-} from "./template-validation.js";
+} from "./template-validation.ts";
 export {
   type UserContentEntryRow,
   userContentEntriesTable,
   userContentEntryEntity,
-} from "./user-content-table.js";
+} from "./user-content-table.ts";

package/packages/bundled-features/src/template-resolver/layout-appearance.ts

@@ -1,5 +1,5 @@
-import { HEX_COLOR_PATTERN } from "./constants.js";
-import { type MailLayoutMeta, readMailLayoutMeta } from "./template-meta.js";
+import { HEX_COLOR_PATTERN } from "./constants.ts";
+import { type MailLayoutMeta, readMailLayoutMeta } from "./template-meta.ts";
 
 // Every value is a member of a closed set, so it can be written into MJML and inline styles as is.
 export type MailLayoutAppearance = {

package/packages/bundled-features/src/template-resolver/layout-regions.ts

@@ -4,7 +4,7 @@
 // the renderer did not plan for.
 
 import type { Element as ScanElement } from "happy-dom";
-import type { ContentFormat } from "./constants.js";
+import type { ContentFormat } from "./constants.ts";
 import {
   type DocumentViolation,
   type SanitizeBodyResult,
@@ -12,7 +12,7 @@ import {
   sanitizeTemplateBody,
   violation,
   withParsedDocument,
-} from "./document-sanitizer.js";
+} from "./document-sanitizer.ts";
 
 const REGION_ATTRIBUTES = ["data-header", "data-content", "data-signature", "data-footer"] as const;
 type RegionAttribute = (typeof REGION_ATTRIBUTES)[number];

package/packages/bundled-features/src/template-resolver/linked-resources.ts

@@ -1,7 +1,7 @@
 import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
 import * as z from "zod";
-import type { FileAttachmentRef } from "../renderer-foundation/index.js";
-import { pdfAttachmentFileNamePatternSchema, templateSlugSchema } from "./template-meta.js";
+import type { FileAttachmentRef } from "../renderer-foundation/index.ts";
+import { pdfAttachmentFileNamePatternSchema, templateSlugSchema } from "./template-meta.ts";
 
 export const templatePdfAttachmentLinkSchema = z
   .object({

package/packages/bundled-features/src/template-resolver/preview-display-html.ts

@@ -1,4 +1,4 @@
-import type { InlineAttachmentRef } from "../renderer-foundation/index.js";
+import type { InlineAttachmentRef } from "../renderer-foundation/index.ts";
 
 export const PREVIEW_IMAGE_BUDGET_BYTES = 5 * 1024 * 1024;
 

package/packages/bundled-features/src/template-resolver/print-document.ts

@@ -3,7 +3,7 @@
 // everything that would make the browser fetch something external is removed.
 
 import type { Element as ScanElement } from "happy-dom";
-import { withParsedDocument } from "./document-sanitizer.js";
+import { withParsedDocument } from "./document-sanitizer.ts";
 
 const REPEAT_HEADER_ATTRIBUTE = "data-repeat-header";
 const FETCHING_ELEMENTS =

package/packages/bundled-features/src/template-resolver/resource-image.ts

@@ -4,7 +4,7 @@ import {
   RESOURCE_IMAGE_FORMATS,
   type ResourceImageContentType,
   SHARP_INPUT_OPTIONS,
-} from "../shared/index.js";
+} from "../shared/index.ts";
 
 const MAX_RESOURCE_WIDTH = 1200;
 

package/packages/bundled-features/src/template-resolver/seeding.ts

@@ -31,15 +31,15 @@ import {
 import type { Dispatcher } from "@cosmicdrift/kumiko-framework/pipeline";
 import { runEventStoreSeed, type SeedIfExists } from "@cosmicdrift/kumiko-framework/seeding";
 import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
-import { type ContentFormat, TEXT_BLOCK_KIND, type UpsertKind } from "./constants.js";
-import { executor } from "./handlers/shared.js";
-import { evaluateTemplateWrite } from "./handlers/template-gates.js";
-import { TEMPLATE_RESOLVER_FEATURE, TemplateResolverHandlers } from "./qualified-names.js";
-import { type TemplateResourceRow, templateResourcesTable } from "./table.js";
-import type { TemplateBundle } from "./template-bundle.js";
-import { activeStampChanges, servedStampChanges } from "./template-draft.js";
-import { templateSlugSchema } from "./template-meta.js";
-import { variablesFromSchema } from "./template-validation.js";
+import { type ContentFormat, TEXT_BLOCK_KIND, type UpsertKind } from "./constants.ts";
+import { executor } from "./handlers/shared.ts";
+import { evaluateTemplateWrite } from "./handlers/template-gates.ts";
+import { TEMPLATE_RESOLVER_FEATURE, TemplateResolverHandlers } from "./qualified-names.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "./table.ts";
+import type { TemplateBundle } from "./template-bundle.ts";
+import { activeStampChanges, servedStampChanges } from "./template-draft.ts";
+import { templateSlugSchema } from "./template-meta.ts";
+import { variablesFromSchema } from "./template-validation.ts";
 
 /** Drop projection orphans (no events anywhere) so boot seeds can recreate. */
 async function resolveExistingForEventStoreSeed(
@@ -334,7 +334,7 @@ export async function seedNotificationTemplates(
   }
   if (hasTemplates) {
     // Dynamic: renderer-foundation imports this feature's barrel, a static import would cycle.
-    const { collectRendererPlugins } = await import("../renderer-foundation/index.js");
+    const { collectRendererPlugins } = await import("../renderer-foundation/index.ts");
     if (!collectRendererPlugins(registry).some((plugin) => plugin.kinds.includes("mail"))) {
       throw new Error(
         'Notifications declare a mail template but no renderer plugin for kind "mail" is registered (mount renderer-foundation and @cosmicdrift/kumiko-renderer-mail-html)',

package/packages/bundled-features/src/template-resolver/store-template-resource.ts

@@ -19,25 +19,25 @@ import {
   type UploadedFileBytes,
   uploadFileBytesBeforeTransaction,
 } from "@cosmicdrift/kumiko-framework/files";
-import { fileContextForTenant } from "../file-foundation/index.js";
-import { extensionForResourceContentType, requireForTenant } from "../shared/index.js";
-import { ACTIVE_TEMPLATE_STATUS, SYSTEM_TENANT_ID } from "./constants.js";
+import { fileContextForTenant } from "../file-foundation/index.ts";
+import { extensionForResourceContentType, requireForTenant } from "../shared/index.ts";
+import { ACTIVE_TEMPLATE_STATUS, SYSTEM_TENANT_ID } from "./constants.ts";
 import {
   DEFAULT_RESOURCE_MAX_BYTES,
   MAX_FILE_ATTACHMENTS_PER_TEMPLATE,
   RESOURCE_MAX_BYTES_CONFIG_KEY,
-} from "./handlers/resource-shared.js";
-import { executor } from "./handlers/shared.js";
+} from "./handlers/resource-shared.ts";
+import { executor } from "./handlers/shared.ts";
 import {
   attachmentEntriesOf,
   type LinkedResourceEntry,
   parseLinkedResourceEntries,
   templatePdfAttachmentLinkSchema,
-} from "./linked-resources.js";
-import { TemplateResolverErrors } from "./qualified-names.js";
-import { normalizeResourceImage } from "./resource-image.js";
-import { type TemplateResourceRow, templateResourcesTable } from "./table.js";
-import { readTemplateResource } from "./template-resources.js";
+} from "./linked-resources.ts";
+import { TemplateResolverErrors } from "./qualified-names.ts";
+import { normalizeResourceImage } from "./resource-image.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "./table.ts";
+import { readTemplateResource } from "./template-resources.ts";
 
 export async function readTemplateResourceMaxBytes(
   config: ConfigAccessor | undefined,

package/packages/bundled-features/src/template-resolver/table.ts

@@ -14,7 +14,7 @@ import {
   TEMPLATE_KINDS,
   TEMPLATE_SCOPES,
   TEMPLATE_STATUSES,
-} from "./constants.js";
+} from "./constants.ts";
 
 // Stored v1 events name the kind "mail-html", which is now "mail".
 const renameMailHtmlKind: EntityEventMigration = {

package/packages/bundled-features/src/template-resolver/template-bundle.ts

@@ -1,8 +1,8 @@
 import * as z from "zod";
-import { CONTENT_FORMATS, UPSERT_KINDS } from "./constants.js";
-import { isDocumentResourceKey } from "./document-schema.js";
-import { templatePdfAttachmentLinkSchema } from "./linked-resources.js";
-import { templateSlugSchema } from "./template-meta.js";
+import { CONTENT_FORMATS, UPSERT_KINDS } from "./constants.ts";
+import { isDocumentResourceKey } from "./document-schema.ts";
+import { templatePdfAttachmentLinkSchema } from "./linked-resources.ts";
+import { templateSlugSchema } from "./template-meta.ts";
 
 const MAX_RESOURCES = 20;
 const MAX_LOCALES = 50;

package/packages/bundled-features/src/template-resolver/template-diff.ts

@@ -1,4 +1,4 @@
-import { withParsedDocument } from "./document-sanitizer.js";
+import { withParsedDocument } from "./document-sanitizer.ts";
 
 export type TemplateDiffChange = "same" | "added" | "removed";
 

package/packages/bundled-features/src/template-resolver/template-draft.ts

@@ -1,7 +1,7 @@
 import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 import * as z from "zod";
-import { CONTENT_FORMATS, type ContentFormat } from "./constants.js";
-import type { TemplateResourceRow } from "./table.js";
+import { CONTENT_FORMATS, type ContentFormat } from "./constants.ts";
+import type { TemplateResourceRow } from "./table.ts";
 
 const templateDraftSchema = z.object({
   content: z.string().nullable(),

package/packages/bundled-features/src/template-resolver/template-meta.ts

@@ -4,8 +4,8 @@ import {
   PDF_ORIENTATIONS,
   PDF_PAGE_FORMATS,
   type TemplateKind,
-} from "./constants.js";
-import { MAIL_TONES, type MailTone } from "./mail-constants.js";
+} from "./constants.ts";
+import { MAIL_TONES, type MailTone } from "./mail-constants.ts";
 
 // One or more kebab segments joined by ":" — notification templates are seeded
 // under their qualified name `feature:notify:name`.

package/packages/bundled-features/src/template-resolver/template-preview.ts

@@ -13,56 +13,61 @@ import {
   ValidationError,
 } from "@cosmicdrift/kumiko-framework/errors";
 import { fileRefsTable } from "@cosmicdrift/kumiko-framework/files";
+import { createI18n } from "@cosmicdrift/kumiko-framework/i18n";
 import { escapeHtml } from "@cosmicdrift/kumiko-headless";
-import { createEmailAttachmentReader, createTemplateMailRenderer } from "../delivery/index.js";
-import { fileContextForTenant } from "../file-foundation/index.js";
+import { createEmailAttachmentReader, createTemplateMailRenderer } from "../delivery/index.ts";
+import { fileContextForTenant } from "../file-foundation/index.ts";
 import {
   collectRendererPlugins,
   createRendererFoundationApi,
   type MailAttachmentRef,
   RendererError,
   type RendererPlugin,
-} from "../renderer-foundation/index.js";
-import { createTemplateResolverApi, TemplateNotFoundError, type TemplateResource } from "./api.js";
-import { collectDocumentResourceKeys } from "./compile-document-body.js";
+} from "../renderer-foundation/index.ts";
+import { createTemplateResolverApi, TemplateNotFoundError, type TemplateResource } from "./api.ts";
+import { collectDocumentResourceKeys } from "./compile-document-body.ts";
 import {
   DEFAULT_MAIL_LAYOUT_SLUG,
   DEFAULT_PDF_LAYOUT_SLUG,
   MAIL_PREVIEW_MAX_BYTES,
   SYSTEM_TENANT_ID,
   type TemplateScope,
-} from "./constants.js";
-import { parseStoredJson } from "./handlers/template-gates.js";
-import { validateTemplateDraft } from "./handlers/validate.query.js";
+} from "./constants.ts";
+import { parseStoredJson } from "./handlers/template-gates.ts";
+import { validateTemplateDraft } from "./handlers/validate.query.ts";
 import {
   type LayoutRegions,
   readLayoutRegions,
   sanitizeLayoutHtml,
   type TemplateWriteScope,
-} from "./layout-regions.js";
-import { type LinkedResourceEntry, parseLinkedResourceEntries } from "./linked-resources.js";
-import { buildDisplayHtml } from "./preview-display-html.js";
-import { TemplateResolverErrors } from "./qualified-names.js";
-import { type TemplateResourceRow, templateResourcesTable } from "./table.js";
+} from "./layout-regions.ts";
+import { type LinkedResourceEntry, parseLinkedResourceEntries } from "./linked-resources.ts";
+import { buildDisplayHtml } from "./preview-display-html.ts";
+import { TemplateResolverErrors } from "./qualified-names.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "./table.ts";
 import {
   isMailTemplateMeta,
   type MailTemplateMeta,
   type PdfTemplateMeta,
   parseTemplateMeta,
   readPdfTemplateMeta,
-} from "./template-meta.js";
+} from "./template-meta.ts";
 
 const SAMPLE_LINK = "https://example.com";
 const SAMPLE_DATE = "2026-01-15";
 const SAMPLE_LIST_ROWS = 3;
 
-function sampleScalar(name: string, def: TemplateScalarVariableDef): unknown {
+// A variable label is an i18n key or plain text; an unknown key reads as itself.
+type LabelText = (label: string) => string;
+
+function sampleScalar(name: string, def: TemplateScalarVariableDef, labelText: LabelText): unknown {
   if (def.example !== undefined) return def.example;
+  const label = def.label === undefined ? name : labelText(def.label);
   switch (def.type) {
     case "text":
-      return `[${def.label ?? name}]`;
+      return `[${label}]`;
     case "richText":
-      return `<p>[${escapeHtml(def.label ?? name)}]</p>`;
+      return `<p>[${escapeHtml(label)}]</p>`;
     case "link":
       return SAMPLE_LINK;
     case "money":
@@ -76,30 +81,40 @@ function sampleScalar(name: string, def: TemplateScalarVariableDef): unknown {
 
 function sampleRow(
   item: TemplateListVariableDef["item"],
+  labelText: LabelText,
   given: Readonly<Record<string, unknown>> = {},
 ): Record<string, unknown> {
   const row: Record<string, unknown> = {};
-  for (const [name, def] of Object.entries(item)) row[name] = sampleScalar(name, def);
+  for (const [name, def] of Object.entries(item)) row[name] = sampleScalar(name, def, labelText);
   return { ...row, ...given };
 }
 
-function sampleList(def: TemplateListVariableDef): Record<string, unknown>[] {
+function sampleList(def: TemplateListVariableDef, labelText: LabelText): Record<string, unknown>[] {
   const rows = (def.example ?? [])
     .slice(0, SAMPLE_LIST_ROWS)
-    .map((given) => sampleRow(def.item, given));
-  while (rows.length < SAMPLE_LIST_ROWS) rows.push(sampleRow(def.item));
+    .map((given) => sampleRow(def.item, labelText, given));
+  while (rows.length < SAMPLE_LIST_ROWS) rows.push(sampleRow(def.item, labelText));
   return rows;
 }
 
 // Declared examples win; the fallbacks are deterministic so a preview never differs between calls.
-export function sampleValuesFor(variables: TemplateVariables): Record<string, unknown> {
+export function sampleValuesFor(
+  variables: TemplateVariables,
+  labelText: LabelText = (label) => label,
+): Record<string, unknown> {
   const values: Record<string, unknown> = {};
   for (const [name, def] of Object.entries(variables)) {
-    values[name] = def.type === "list" ? sampleList(def) : sampleScalar(name, def);
+    values[name] =
+      def.type === "list" ? sampleList(def, labelText) : sampleScalar(name, def, labelText);
   }
   return values;
 }
 
+function labelTextFor(ctx: HandlerContext, locale: string): LabelText {
+  const i18n = createI18n(ctx.registry, { defaultLocale: "en" });
+  return (label) => i18n.t(label, locale);
+}
+
 export type PreviewCheckCode =
   | "resources_resolved"
   | "text_present"
@@ -494,7 +509,7 @@ export async function evaluateDocumentDraft(
     content: evaluation.content ?? "",
     meta: meta.ok ? readPdfTemplateMeta(meta.meta) : null,
     variableSchema: draft.variableSchema,
-    sampleValues: sampleValuesFor(response.variables),
+    sampleValues: sampleValuesFor(response.variables, labelTextFor(ctx, draft.locale)),
   };
 }
 
@@ -654,7 +669,7 @@ export async function renderTemplatePreview(
 
   const content = evaluation.content ?? "";
   const meta = parseTemplateMeta(input.kind, parseStoredJson(evaluation.metaJson));
-  const sampleValues = sampleValuesFor(validation.variables);
+  const sampleValues = sampleValuesFor(validation.variables, labelTextFor(ctx, input.locale));
 
   if (input.kind === "document-pdf") {
     return renderDocumentPreview(ctx, user, {

package/packages/bundled-features/src/template-resolver/template-resources.ts

@@ -7,10 +7,10 @@ import type {
 } from "@cosmicdrift/kumiko-framework/engine";
 import { NotFoundError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
 import { fileRefsTable } from "@cosmicdrift/kumiko-framework/files";
-import { requireForTenant } from "../shared/index.js";
-import { executor } from "./handlers/shared.js";
-import type { LinkedResourceEntry } from "./linked-resources.js";
-import { type TemplateResourceRow, templateResourcesTable } from "./table.js";
+import { requireForTenant } from "../shared/index.ts";
+import { executor } from "./handlers/shared.ts";
+import type { LinkedResourceEntry } from "./linked-resources.ts";
+import { type TemplateResourceRow, templateResourcesTable } from "./table.ts";
 
 export type TemplateResourceFile = {
   readonly fileName: string;

package/packages/bundled-features/src/template-resolver/template-system-only.ts

@@ -1,5 +1,5 @@
 import type { Registry } from "@cosmicdrift/kumiko-framework/engine";
-import { isSystemAdmin } from "./template-draft.js";
+import { isSystemAdmin } from "./template-draft.ts";
 
 const NOTIFICATION_TEMPLATE_KIND = "mail";