@clepit/core 0.6.0-beta.415 → 0.6.0-beta.417

package/CHANGELOG.md

@@ -8,13 +8,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+- `DrawContext.locale` and `DrawContext.defaultLocale`: `renderBlocks` draws each translated field in the language asked for, falling back to the page's own, and draws a translated document that names no language in the first of its languages, where it drew "[object Object]". A document with no translation draws exactly as before.
 - `EditorConfig.onClearRequest`: the toolbar's Clear awaits the host and empties the page only when it resolves `true`; a rejection leaves the page and is reported. Absent, Clear empties the page at once, as before. `@clepit/react`'s `ClepitEditor` forwards it through the same latest-props contract as `onChange`.
 - `EditorConfig.dialogLabels` and `DIALOG_LABELS`: the link, tooltip and status dialogs draw the host's words (titles, field labels, placeholders, the status variants, Cancel and Apply), in English when absent. Each dialog element carries a test id (`link-dialog-title`, `status-dialog-variant-success` and the rest).
 - Six `blockToolbarLabels` keys for the image block's own words: `imageDropTitle`, `imageDropAction`, `imageDropFormats`, `imageUploading`, `imageUploadFailed` and `imageInvalidType`, in English when absent. The drop area's delete button takes the `delete` label as its tooltip and its `aria-label`. Each state carries a test id (`image-drop`, `image-drop-title`, `image-uploading`, `image-upload-failed`, `image-invalid-type` and the rest).
 - `UploadRefusal` and `UploadNotice`: an image uploader that rejects with `new UploadRefusal({ title, body, action, remove })` turns the block into a framed notice in the host's words, in place of the drop area: the title, the reason, the action as a link opening in a new tab (http and https only; left out when absent) and a Remove that deletes the block. Any other rejection still shows the failed-upload line. Test ids `image-refusal`, `image-refusal-title`, `image-refusal-body`, `image-refusal-action` and `image-refusal-remove`.
 - `PublicPage.alternates` and `PublicPage.notice`: `renderPage` writes one `<link rel="alternate">` per hreflang and address pair, and draws the notice (a title and a line, test id `public-page-notice`) below the page title with its own styles. A page passing neither renders exactly as before.
+- `pageMetadata`, `renderNotice` and `noticeStylesheet`: a host that frames a public page in its own chrome writes the page's description, canonical, language and link-preview tags and draws its language notice exactly as `renderPage` does, which now draws both through them.
+- `PublicPage.scheme`: `renderPage` draws the page in `light` or `dark` only, by setting `data-clepit-theme` on `<body>` (the attribute the theme's tokens resolve under) and a `color-scheme` meta so the browser's own canvas and text follow it. A page passing no scheme renders exactly as before.
 
 ### Fixed
+- An editor given `locale` kept only the language being edited: an edit replaced a field's map of languages with one string. The editor now keeps each block's stored data and writes an edit back into it with the rule both twins share, on every way a block leaves it (`onChange`, `data.extract()`, `blocks.get` and `blocks.getAll`), while `blocks.insert`, `blocks.update` and `data.set` take stored data and show it in the language being edited. A converted block keeps the languages of the fields both types share.
+- An editor given no `locale` drew a translated field as "[object Object]". It now shows a translated document in the first of its languages, and keeps the others through an edit.
 - The inline toolbar no longer leaves a hidden copy of the rewrite menu behind each time a new selection repaints it, so each rewrite action exists once in the page.
 
 ## [0.6.0] - 2026-09-25

package/dist/core/editor/index.d.ts

@@ -1,5 +1,6 @@
 import { EditorAPI, EditorConfig } from '../../types';
 export declare class Editor {
+    private static sources;
     static create(config: EditorConfig): EditorAPI;
     private static initialize;
     /**
@@ -12,6 +13,10 @@ export declare class Editor {
      * change when they switched.
      */
     private static localizeData;
+    private static localizeBlock;
+    private static localizeArriving;
+    private static delocalizeBlock;
+    private static delocalizeData;
     private static render;
     /** Releases the runtime a container holds and leaves its document in the
      *  store. `create` runs this first so a second create in the same container

package/dist/core/element/index.d.ts

@@ -66,6 +66,8 @@ export type DrawContext = {
     issueChip?: IssueChipParts;
     /** Translated issue words; English fallbacks otherwise. */
     issueLabels?: Partial<Record<IssueLabel, string>>;
+    locale?: string;
+    defaultLocale?: string;
 };
 export type Backing = {
     create(tag: string): ClepitElement;

package/dist/core/i18n/index.d.ts

@@ -40,4 +40,9 @@ export declare const resolveLocalized: <T>(value: Localized<T> | undefined, requ
  * changes shape.
  */
 export declare const withLocale: <T>(value: Localized<T> | undefined, locale: string, next: T, documentDefault: string) => Localized<T>;
+export declare const writeBlockData: (blockType: string, stored: Record<string, unknown> | undefined, edited: Record<string, unknown>, locale: string, documentDefault: string) => Record<string, unknown>;
+export declare const firstLocaleOf: (blocks: {
+    data: unknown;
+    type: string;
+}[]) => string | undefined;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/renderer/page.d.ts

@@ -10,6 +10,7 @@ export type PublicPage = {
     canonicalUrl?: string;
     alternates?: PublicPageAlternate[];
     notice?: PublicPageNotice;
+    scheme?: 'light' | 'dark';
 };
 export type PublicPageAlternate = {
     href: string;
@@ -19,6 +20,9 @@ export type PublicPageNotice = {
     body: string;
     title: string;
 };
+export declare const noticeStylesheet: () => string;
+export declare const renderNotice: (notice: PublicPageNotice) => string;
+export declare const pageMetadata: (page: Pick<PublicPage, "alternates" | "canonicalUrl" | "description" | "title">) => string;
 /**
  * Every stylesheet a drawn document needs, as text.
  *

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { StyleManager } from './core/managers/style';
 export { Renderer } from './core/renderer';
 export { activateBlocks } from './core/renderer/activate';
 export { drawBlock } from './core/renderer/draw';
-export { type PublicPage, type PublicPageAlternate, type PublicPageNotice, pageStylesheet, renderBlocks, renderPage } from './core/renderer/page';
+export { noticeStylesheet, type PublicPage, type PublicPageAlternate, type PublicPageNotice, pageMetadata, pageStylesheet, renderBlocks, renderNotice, renderPage } from './core/renderer/page';
 export { type ThemeTokens, tokensToLightDarkBlock } from './core/theme';
 export { UploadRefusal } from './core/upload-refusal';
 export { EMBED_ENGLISH, EMBED_TOOL_NAMES, embedLabel } from './tools/block/embed/output';