@clepit/core 0.2.0-beta.323 → 0.3.0-beta.324

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] — 2026-08-11
+
+### Added
+- `tokensToLightDarkBlock` is exported: turns a light/dark `ThemeTokens` pair into a `light-dark()` CSS variable block for a selector, so a host can emit theme overrides for statically rendered content (`renderBlocks`) without a live `StyleManager`.
+- `activateBlocks(container, blocks)` is exported: wires the behaviors statically rendered markup deliberately leaves out (code tab switching, language sync and the clipboard; openapi response tabs and embedded samples; table CSV download) into markup `renderBlocks` produced earlier, and returns a disposer that removes every listener it added.
+
+- `drawBlock` stamps `data-block-type` and, when the block carries an id, `data-clepit-block-id` on each drawn root element, so statically rendered markup is addressable per block.
+- Public pages are anchor-navigable: `renderPage` sets the new `DrawContext.anchorTargets` flag so identified block roots carry a real DOM `id`, and the stylesheet highlights the `:target` block. A copied block anchor link (`…/slug#blockId`) scrolls and highlights with no script.
+
+### Fixed
+- Code samples embedded in an openapi reference are now live in every path: their copy buttons and language tabs were drawn but never wired, on the client render path included. `CodeOutput.activateFromMarkup` reads the wiring inputs back out of the drawn markup (pane text as code, tab text as label, the sync key from a stamped attribute).
+- `Editor.destroy` now releases id-keyed state (theme registry, body theme attribute, pending toolbar timers) even when the container element has already left the DOM. React hosts remove the element before effect cleanup fires, so the previous early return leaked the theme registration on every unmount and left `body[data-clepit-theme]` stuck.
+
 ## [0.2.0] — 2026-04-21
 
 ### Added

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

@@ -13,6 +13,10 @@ export declare class Editor {
      */
     private static localizeData;
     private static render;
+    /** Runs even after the container has left the DOM (a React host removes the
+     *  element before effect cleanup fires): every helper guards its own DOM
+     *  access, and the id-keyed state — theme registry, body theme attribute,
+     *  pending toolbar timers — must be released either way. */
     static destroy(containerId: string): void;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -43,6 +43,11 @@ export type ClepitElement = {
 export type DrawContext = {
     /** A toc derives from its siblings, which no block-local data carries. */
     documentBlocks?: readonly Block[];
+    /** Stamp each identified block root with a DOM `id` so a URL fragment can
+     * land on it. Set by `renderPage` for public pages; off elsewhere, because
+     * the docs pipeline injects its own slug ids onto headings and one element
+     * must not carry two. */
+    anchorTargets?: boolean;
     /** Which variant a code block opens on. */
     activeVariant?: number;
     /** Google Maps embeds need a key to build a provider URL. */

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

@@ -0,0 +1,14 @@
+import { Block } from '../../types';
+/**
+ * Wire the behaviors `renderBlocks` markup deliberately leaves out: code tab
+ * switching, language sync and the clipboard; openapi response tabs; the
+ * table CSV download.
+ *
+ * The markup carries `data-clepit-block-id` from `drawBlock`, so each block's
+ * element is found exactly rather than by position, including inside columns
+ * and collapsibles. An element already activated is skipped, and the returned
+ * disposer removes every listener that was added: a React host can activate
+ * on mount and release on unmount as often as it likes.
+ */
+export declare const activateBlocks: (container: HTMLElement, blocks: readonly Block[]) => (() => void);
+//# sourceMappingURL=activate.d.ts.map

package/dist/index.d.ts

@@ -2,9 +2,10 @@ export { Editor } from './core/editor';
 export { type Backing, type ClepitElement, type DrawContext, domBacking, renderToString, stringBacking, toDomElement } from './core/element';
 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, pageStylesheet, renderBlocks, renderPage } from './core/renderer/page';
-export type { ThemeTokens } from './core/theme';
+export { type ThemeTokens, tokensToLightDarkBlock } from './core/theme';
 export type { OpenApiGroup, OpenApiModel, OpenApiOperation, OpenApiServer } from './tools/block/openapi/spec';
 export { parseOpenApi } from './tools/block/openapi/spec';
 export type { ALERT_VARIANTS, AlertData, AlertVariant, AudioData, Block, BlockClassNames, BlockMargins, BlockStyles, BlockTune, CodeData, CodeVariant, CSSProperties, CSSValue, DelimiterData, DelimiterVariant, EditorAPI, EditorClassNames, EditorConfig, EditorData, EditorStyles, GlanceData, GlanceRow, HeaderData, HeaderLevel, ImageData, InlineToolType as InlineTool, InputClassNames, InputConfig, InputStyles, ListData, ListType, OpenApiData, OpenApiFilter, OutputComponent, OutputConfig, ParagraphData, QuoteData, RendererConfig, TableData, ToolType as BlockType, UploadFunction, VideoData, } from './types';