@clepit/core 0.4.0 → 0.5.0

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/index.d.ts

@@ -9,6 +9,6 @@ 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';
-export { BLOCK_TOOLS } from './types';
+export { BLOCK_TOOLS, INLINE_TOOLS } from './types';
 export { sanitizeHtmlWithoutDom } from './utils/sanitize-html-nodom';
 //# sourceMappingURL=index.d.ts.map