@lostgradient/cinder 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @lostgradient/cinder
 
+## 0.6.0
+
+### Minor Changes
+
+- [#638](https://github.com/stevekinney/cinder/pull/638) [`f0a6ac2`](https://github.com/stevekinney/cinder/commit/f0a6ac23c75a2ee8361f27a67649418452d550c3) Thanks [@stevekinney](https://github.com/stevekinney)! - Move rich editor, markdown rendering, and syntax-highlighting packages out of the base install path. Styles-only and lightweight component consumers no longer install Milkdown, ProseMirror, Shiki, remark, or rehype trees unless they opt into the rich feature surfaces.
+
+  Consumers importing `@lostgradient/cinder/chat` with the default composer, `@lostgradient/cinder/markdown-editor`, `@lostgradient/cinder/review-editor`, `@lostgradient/cinder/markdown`, `@lostgradient/cinder/markdown/*`, `@lostgradient/cinder/editor`, `@lostgradient/cinder/editor/*`, `@lostgradient/cinder/commentary`, `@lostgradient/cinder/commentary/*`, `@lostgradient/cinder/highlighters/shiki`, or relying on `Chat` built-in markdown/tool message rendering or `CodeBlock` automatic highlighting should install the listed optional peer dependencies, including the public markdown AST type packages, for those rich features. `MarkdownEditor` and `ReviewEditor` are now subpath-only imports so the root barrel can stay usable without rich optional peers.
+
+### Patch Changes
+
+- [#646](https://github.com/stevekinney/cinder/pull/646) [`a5dc7c0`](https://github.com/stevekinney/cinder/commit/a5dc7c04cee27f18b20470f3d6edc669fcb9045e) Thanks [@stevekinney](https://github.com/stevekinney)! - Add `ActionRow`, a selectable full-width button row primitive for master-detail lists, timelines, and sidebar selection surfaces.
+
+- [#642](https://github.com/stevekinney/cinder/pull/642) [`a51a733`](https://github.com/stevekinney/cinder/commit/a51a733c8ef7a48719bded3b64c9e876ea2d68e5) Thanks [@stevekinney](https://github.com/stevekinney)! - Keep the collapsible NavigationBar menu toggle grouped with trailing actions on narrow bars.
+
+- [#643](https://github.com/stevekinney/cinder/pull/643) [`5322ca3`](https://github.com/stevekinney/cinder/commit/5322ca376874cf637b8bbb4649aa78b02fedd7e4) Thanks [@stevekinney](https://github.com/stevekinney)! - Add SourceDiffViewer for bounded, accessible unified source patches.
+
 ## 0.5.0
 
 ### Minor Changes
@@ -16,6 +32,8 @@
 
 ### Patch Changes
 
+- [#641](https://github.com/stevekinney/cinder/pull/641) [`ec89bc1`](https://github.com/stevekinney/cinder/commit/ec89bc11) Thanks [@stevekinney](https://github.com/stevekinney)! - **Breaking CSS utility rename:** the icon sizing helpers exported from `@lostgradient/cinder/styles` and `@lostgradient/cinder/styles/utilities` are now namespaced as `.cinder-icon-xs`, `.cinder-icon-sm`, `.cinder-icon-md`, and `.cinder-icon-lg`. Cinder components use the namespaced utilities internally so application-level `.icon-*` classes cannot change component icon sizing. Consumer markup that used `.icon-xs`, `.icon-sm`, `.icon-md`, or `.icon-lg` should rename those classes to the matching `.cinder-icon-*` class.
+
 - [#559](https://github.com/stevekinney/cinder/pull/559) [`9628078`](https://github.com/stevekinney/cinder/commit/96280780a150a69f74a3abfa60d9006fd2be3c6c) Thanks [@stevekinney](https://github.com/stevekinney)! - Align Chat's conversation model with the published `conversationalist` package instead of maintaining bespoke mirrored transcript types.
 
 - [#577](https://github.com/stevekinney/cinder/pull/577) [`f4a9386`](https://github.com/stevekinney/cinder/commit/f4a938605a20ff0fdfe401f43db32248930af0e5) Thanks [@stevekinney](https://github.com/stevekinney)! - Preserve server component identity in the published SSR bundle so SvelteKit development SSR can render Cinder snippet content without crashing. Fixes [#572](https://github.com/stevekinney/cinder/issues/572) and [#573](https://github.com/stevekinney/cinder/issues/573).

package/README.md

@@ -12,6 +12,12 @@ bun add @lostgradient/cinder svelte lucide-svelte
 
 `svelte` and `lucide-svelte` are peer dependencies. Cinder uses Lucide for its own component chrome, but it does not provide a general icon library for your application-specific icons.
 
+Rich editor, markdown rendering, editor/commentary re-exports, and syntax-highlighting surfaces use optional peer dependencies. Install them only when your app imports `@lostgradient/cinder/chat` with the default composer, `@lostgradient/cinder/markdown-editor`, `@lostgradient/cinder/review-editor`, `@lostgradient/cinder/markdown`, `@lostgradient/cinder/markdown/*`, `@lostgradient/cinder/editor`, `@lostgradient/cinder/editor/*`, `@lostgradient/cinder/commentary`, `@lostgradient/cinder/commentary/*`, `@lostgradient/cinder/highlighters/shiki`, or relies on `Chat` built-in markdown/tool message rendering or `CodeBlock` automatic highlighting:
+
+```bash
+bun add @milkdown/ctx @milkdown/kit @milkdown/prose @shikijs/engine-oniguruma @shikijs/langs @shikijs/rehype @shikijs/types @types/hast @types/mdast @types/unist comlink hast-util-sanitize js-yaml prosemirror-inputrules prosemirror-model prosemirror-state prosemirror-view rehype-katex rehype-sanitize rehype-stringify remark-gfm remark-html remark-math remark-parse remark-rehype remark-stringify shiki unified unist-util-remove unist-util-visit
+```
+
 ## Quickstart
 
 Load the base stylesheet once at your app entry:
@@ -80,7 +86,21 @@ import { Button, Modal } from '@lostgradient/cinder';
 
 ## Finding the Right Component
 
-Cinder ships a machine-readable manifest:
+For agents and local tooling, prefer the published `cinder` command:
+
+```sh
+cinder search modal
+cinder show button --json
+cinder compare modal drawer --json
+cinder best-practices styles
+```
+
+Use `cinder mcp` to start the read-only stdio MCP server. It exposes the same
+component search, detail, comparison, best-practice guidance, and generated
+artifact resources without requiring agents to parse package files directly.
+
+Cinder also ships a machine-readable manifest for environments where the CLI or
+MCP server is unavailable:
 
 ```ts
 import manifest from '@lostgradient/cinder/manifest' with { type: 'json' };
@@ -116,8 +136,18 @@ html {
 html[data-theme='dark'] {
   color-scheme: dark;
 }
+
+[data-theme='light'] {
+  color-scheme: light;
+}
+
+[data-theme='dark'] {
+  color-scheme: dark;
+}
 ```
 
+Use `[data-theme='dark']` or `[data-theme='light']` on a subtree for scoped theme islands. Cinder pins the core semantic surface, text, border, overlay, interaction, status, and control tokens inside those scopes so components inherit local values without app-level token overrides. If your app replaces Cinder's public tokens for custom branding, set those brand overrides in the same scoped theme selector.
+
 Public tokens use the `--cinder-` prefix. Internal implementation variables use `--_cinder-`; do not redefine those.
 
 ## What Cinder Does Not Provide

package/components.json

@@ -3,7 +3,7 @@
   "manifestVersion": 1,
   "package": {
     "name": "@lostgradient/cinder",
-    "version": "0.5.0",
+    "version": "0.6.0",
     "framework": "svelte",
     "frameworkVersionRange": ">=5.55.0 <6",
     "classPrefix": "cinder-",
@@ -179,6 +179,36 @@
         "variables": "@lostgradient/cinder/accordion-item/variables"
       }
     },
+    {
+      "name": "ActionRow",
+      "id": "action-row",
+      "import": "@lostgradient/cinder/action-row",
+      "exportName": "ActionRow",
+      "category": "action",
+      "status": "beta",
+      "purpose": "Full-width button row for selectable sidebars, timelines, and master-detail lists with leading, title, description, meta, and trailing regions.",
+      "tags": ["row", "list", "selection"],
+      "useWhen": [
+        "Selecting an item in-place from a vertical list, timeline, run list, or master-detail sidebar.",
+        "A row must behave like a native button while presenting rich row metadata."
+      ],
+      "avoidWhen": [
+        {
+          "reason": "Navigating to a URL — use stacked-list-item with href or navigation-item instead."
+        },
+        {
+          "reason": "Showing static record rows without button semantics — use stacked-list-item inside data-list."
+        }
+      ],
+      "related": ["stacked-list-item", "data-list", "button"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/action-row/schema",
+        "variables": "@lostgradient/cinder/action-row/variables",
+        "examples": "@lostgradient/cinder/action-row/examples"
+      }
+    },
     {
       "name": "Alert",
       "id": "alert",
@@ -766,7 +796,7 @@
       "exportName": "Callout",
       "category": "feedback",
       "status": "stable",
-      "purpose": "Inline aside that highlights supporting commentary alongside body content without claiming live-region urgency.",
+      "purpose": "Inline static note or aside that highlights supporting commentary alongside body content without claiming live-region urgency.",
       "tags": ["feedback", "notice"],
       "useWhen": [
         "Drawing attention to tangential information nested inside prose, documentation, or article content.",
@@ -4662,6 +4692,38 @@
         "examples": "@lostgradient/cinder/sortable-list/examples"
       }
     },
+    {
+      "name": "SourceDiffViewer",
+      "id": "source-diff-viewer",
+      "import": "@lostgradient/cinder/source-diff-viewer",
+      "exportName": "SourceDiffViewer",
+      "category": "data-display",
+      "status": "beta",
+      "purpose": "Lightweight unified-patch viewer for source-code and operational diffs with file headers, hunk headers, line state styling, and bounded rendering.",
+      "tags": ["diff", "source", "code"],
+      "useWhen": [
+        "Rendering source-code unified patches from agent output, Git operations, workspace changes, or review systems.",
+        "Showing operational patch output where file and hunk structure matters more than Markdown front matter or word-level prose review."
+      ],
+      "avoidWhen": [
+        {
+          "reason": "Comparing two Markdown documents with normalization, front-matter handling, and revert affordances.",
+          "alternative": "diff-viewer"
+        },
+        {
+          "reason": "Showing syntax-highlighted code samples rather than patch output.",
+          "alternative": "code-block"
+        }
+      ],
+      "related": ["diff-viewer", "diff-statistics", "code-block"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/source-diff-viewer/schema",
+        "variables": "@lostgradient/cinder/source-diff-viewer/variables",
+        "examples": "@lostgradient/cinder/source-diff-viewer/examples"
+      }
+    },
     {
       "name": "Sparkbar",
       "id": "sparkbar",

package/dist/cli/best-practices.d.ts

@@ -0,0 +1,2 @@
+import type { BestPracticeSection, BestPracticeTopic } from './types.ts';
+export declare const bestPracticeSections: Record<Exclude<BestPracticeTopic, 'all'>, BestPracticeSection>;

package/dist/cli/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { type ListOptions, type SearchOptions } from './types.ts';
+type ParsedCommand = {
+    command: string;
+    positionals: string[];
+    json: boolean;
+    listOptions: ListOptions;
+    searchOptions: SearchOptions;
+    help: boolean;
+};
+export declare function parseCommand(argv: string[]): ParsedCommand;
+export declare function runCli(argv?: string[]): Promise<number>;
+export declare function isCliEntrypoint(entrypointPath?: string | undefined, moduleUrl?: string): boolean;
+export {};