@clepit/core 0.4.0 → 0.5.0-beta.350

package/CHANGELOG.md

@@ -7,13 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-08-31
+
+Note: 0.4.0 was released without a changelog entry, so the notes below cover
+everything since 0.3.0, part of which already shipped as 0.4.0.
+
 ### Added
 - Block identity flows end to end: `createBlockElement` honors an incoming `block.id` as the rendered `data-id` (minting one only when the block has none), `getBlockData` returns the id, and `EditorAPI.blocks.insert` accepts an optional `id` so a caller can insert a block under an identity it already holds. Previously the id existed only in the store and evaporated through every DOM-derived path.
 - `BLOCK_TOOLS` is exported as a value, so a host can check whether a block type is one this editor understands.
+- `INLINE_TOOLS` is exported as a value, and it now names `status`, the badge tool the inline toolbar already serves; `InlineToolType` widens with it.
 
 ### Changed
 - `BlockTunes` narrowed to the flat map its writer actually produces; the nested contract had no implementation on any path.
 
+### Fixed
+- Rendered headings are sized again. The output stylesheet keyed its per-level sizes on a `data-level` attribute no render path ever wrote, so every heading in `renderBlocks`/`draw` output fell back to browser defaults. Sizes now key on the heading tags the renderer actually emits.
+
 ## [0.3.0] — 2026-08-11
 
 ### Added

package/README.md

@@ -1,8 +1,6 @@
 # @clepit/core
 
-A framework-agnostic block-style editor with clean JSON output and a batteries-included renderer. Ships with 12 block types, 8 inline tools, and first-class theming.
-
-**Homepage:** [clepit.com](https://clepit.com) · **Docs:** [clepit.com/docs](https://clepit.com/docs)
+[Clepit](https://clepit.com) is a block-style editor with clean JSON output and a renderer that works with or without a browser. This package is the framework-agnostic core behind clepit.com: the editor, the renderer, and the theming engine, with no framework dependency.
 
 ## Install
 
@@ -14,65 +12,27 @@ npm install @clepit/core
 
 ## Quick start
 
-```html
-<div id="editor"></div>
-```
-
 ```ts
 import { Editor } from '@clepit/core';
 
-const editor = Editor.create({
-  containerId: 'editor',
-  theme: 'auto', // 'auto' | 'light' | 'dark'
-});
-
+const editor = Editor.create({ containerId: 'editor', theme: 'auto' });
 const data = editor.data.extract();
-console.log(data.blocks);
-```
-
-## Features
-
-- **12 built-in block types** — header, paragraph, list, checklist, quote, code, alert, table, image, video, delimiter, json.
-- **8 inline tools** — link, marker, tooltip, bold, italic, underline, strikethrough, inline-code.
-- **Framework-agnostic** — no React, Vue, or Svelte dependency. Drop into any app that can mount a DOM node.
-- **TypeScript-first** — every public API is typed. No `any`.
-- **Theme-aware** — pass `theme: 'auto'` and the editor follows the OS color scheme. Override any token with `themeOverrides`.
-- **Clean JSON output** — persist, sync, and render wherever you like.
-
-## Theming
-
-```ts
-Editor.create({
-  containerId: 'editor',
-  theme: 'auto',
-  themeOverrides: {
-    accentPrimary: '#5b5bff',
-    bgDefault: '#ffffff',
-    textPrimary: '#0a0a0a',
-  },
-});
 ```
 
-Subscribe to runtime token changes:
-
-```ts
-import { StyleManager } from '@clepit/core';
-
-const unsub = StyleManager.subscribe(tokens => {
-  // sync surrounding UI with editor theme
-});
-```
+## Documentation
 
-## Rendering saved content
+The full documentation lives at [clepit.com/docs](https://clepit.com/docs) and is rendered with this package:
 
-```ts
-import { Renderer } from '@clepit/core';
+- [Getting started](https://clepit.com/docs/getting-started)
+- [Core concepts](https://clepit.com/docs/core-concepts)
+- [Block types](https://clepit.com/docs/blocks)
+- [Inline tools](https://clepit.com/docs/inline-tools)
+- [Configuration](https://clepit.com/docs/configuration)
+- [Theming](https://clepit.com/docs/themes)
+- [Rendering and embedding](https://clepit.com/docs/embedding)
+- [API reference](https://clepit.com/docs/api)
 
-Renderer.render({
-  containerId: 'view',
-  data, // block JSON from editor.data.extract()
-});
-```
+Using React? [`@clepit/react`](https://www.npmjs.com/package/@clepit/react) wraps this core in server-first components. Building with Dart or Flutter? [`clepit_core`](https://pub.dev/packages/clepit_core) is the native twin.
 
 ## License
 

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

@@ -0,0 +1,19 @@
+/** Five minutes: an issue's status is a slow thing, and a page left open all
+ * day should not cost a tracker a read a minute. */
+export declare const REFRESH_EVERY_MS: number;
+/**
+ * Keeps a page's issues current while it is open: one lookup on mount, again
+ * when the window regains focus (the reader came back from the tracker), and
+ * every five minutes. Chips, cards and tables are redrawn in place; the
+ * document is not marked changed, because nothing the author did changed.
+ */
+export declare class IssueRefresh {
+    private static timers;
+    private static focusHandlers;
+    static start(containerId: string): void;
+    static stop(containerId: string): void;
+    /** The URLs a refresh asks about: every chip and every issue card in the editor. */
+    static urls(containerId: string): string[];
+    static run(containerId: string): Promise<void>;
+}
+//# sourceMappingURL=issues.d.ts.map

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

@@ -1,4 +1,4 @@
-import { Block } from '../../types';
+import { Block, EmbedLabel, IssueChipParts, IssueLabel, IssueSnapshot } from '../../types';
 /**
  * The construction surface a block's render path is allowed to use.
  *
@@ -54,6 +54,18 @@ export type DrawContext = {
     mapsEmbedKey?: string;
     /** How a doc card turns a page id into a link, which only the host knows. */
     docHref?: (pageId: string) => string;
+    /** The workspace's switched-off embed tools, by wire key: a card where the
+     * workspace said so, on a public page as much as in the editor. */
+    disabledEmbedProviders?: readonly string[];
+    /** Translated embed words; English fallbacks otherwise. */
+    embedLabels?: Partial<Record<EmbedLabel, string>>;
+    /** The freshest issue snapshots the host resolved, by URL: a chip, a card or
+     * a Linked issues row draws these over what the document stored. */
+    issues?: Record<string, IssueSnapshot>;
+    /** The reader's two chip switches; both on when absent. */
+    issueChip?: IssueChipParts;
+    /** Translated issue words; English fallbacks otherwise. */
+    issueLabels?: Partial<Record<IssueLabel, string>>;
 };
 export type Backing = {
     create(tag: string): ClepitElement;

package/dist/core/managers/block/index.d.ts

@@ -8,6 +8,9 @@ export declare class BlockManager {
     private static createBlockElement;
     static insertBlock(block: Block, containerId: string, index: number): HTMLElement | null;
     static removeBlock(containerId: string, index: number): null | undefined;
+    /** Insert first, then remove: `removeBlock` keeps the last block of a document,
+     * so replacing the only block by removing it first left the old block in
+     * place beside the new one. */
     static replaceBlock(containerId: string, index: number, block: Block<BlockToolType>): void;
     static moveBlock(containerId: string, fromIndex: number, toIndex: number): void;
     static getBlock(blockId: string): HTMLElement | null;

package/dist/core/managers/event.d.ts

@@ -8,6 +8,11 @@ export declare class EventManager {
     } | null;
     private static handleClick;
     private static handleSelectionChange;
+    /**
+     * A paste is intercepted only when it is one this editor turns into a block:
+     * an image URL, a video URL, or a link a provider renders. Plain text and
+     * links no provider knows reach the browser's own paste untouched.
+     */
     static handlePaste(event: ClipboardEvent): void;
 }
 //# sourceMappingURL=event.d.ts.map

package/dist/index.d.ts

@@ -6,9 +6,14 @@ 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, tokensToLightDarkBlock } from './core/theme';
+export { EMBED_ENGLISH, EMBED_TOOL_NAMES, embedLabel } from './tools/block/embed/output';
+export { EMBED_WIRE_KEYS, isEmbedProviderDisabled, resolveEmbed } from './tools/block/embed/providers';
 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';
-export { BLOCK_TOOLS } from './types';
+export { chipsInHtml, IssueChip, readChipMarkup, refreshChipsInHtml } from './tools/inline/issue';
+export { ISSUE_ENGLISH, ISSUE_TOOL_NAMES, issueLabel, issueToolName } from './tools/inline/issue/labels';
+export { classifyIssueUrl } from './tools/inline/issue/providers';
+export type { ALERT_VARIANTS, AlertData, AlertVariant, AudioData, Block, BlockClassNames, BlockMargins, BlockStyles, BlockTune, CodeData, CodeVariant, CSSProperties, CSSValue, DelimiterData, DelimiterVariant, EditorAPI, EditorClassNames, EditorConfig, EditorData, EditorStyles, EmbedAction, EmbedData, EmbedFile, EmbedGist, EmbedGistFile, EmbedLabel, EmbedProvider, EmbedReason, EmbedResolution, GlanceData, GlanceRow, HeaderData, HeaderLevel, ImageData, InlineToolType as InlineTool, InputClassNames, InputConfig, InputStyles, IssueAction, IssueCards, IssueCategory, IssueChipParts, IssueLabel, IssueReason, IssueSnapshot, IssuesData, IssueTarget, IssueTool, ListData, ListType, OpenApiData, OpenApiFilter, OutputComponent, OutputConfig, ParagraphData, PasteEmbeds, QuoteData, RendererConfig, TableData, ToolType as BlockType, UploadFunction, VideoData, } from './types';
+export { BLOCK_TOOLS, EMBED_LABELS, INLINE_TOOLS, ISSUE_LABELS, ISSUE_TOOLS } from './types';
 export { sanitizeHtmlWithoutDom } from './utils/sanitize-html-nodom';
 //# sourceMappingURL=index.d.ts.map