@cfbender/cesium 0.4.0 → 0.5.1

package/src/render/blocks/themes/claret-dark.ts

@@ -0,0 +1,206 @@
+// Claret-dark shiki theme — converted from ports/bat/ClaretDark.tmTheme.
+// src/render/blocks/themes/claret-dark.ts
+//
+// Source of truth: /claret.nvim/ports/bat/ClaretDark.tmTheme
+// Every scope rule in the tmTheme is preserved verbatim; comma-separated
+// scope strings are split into the string[] form shiki prefers.
+//
+// Global tokens (from tmTheme global settings):
+//   bg         #180810  — editor background
+//   fg         #DDD3C7  — default foreground
+//   selection  #2B1F22
+//   gutter fg  #71685E
+//
+// Derived palette reference (claret.nvim/lua/claret/palette.lua — dark):
+//   rose_1    #C75B7A   keyword / statement / accent
+//   rose_2    #B04A68   property / data keys
+//   gold_1    #D4A76A   function / number / constant / decorator
+//   sage_1    #8FA86E   string
+//   slate_1   #8995A8   type / class / tag / escape / link
+//   slate_2   #6E7A90   tag attribute
+//   text      #DDD3C7   variable / default fg
+//   text_2    #BDB3A7   operator (syntax.lua maps Operator → text_2; tmTheme uses #9E9288)
+//             NOTE: the tmTheme uses #9E9288 (text_3) for operator/punctuation — preserved.
+//   text_4    #71685E   comment (fg)
+//   terra_1   #C44536   invalid / diff deleted
+
+import type { ThemeRegistration } from "shiki";
+
+export const claretDark: ThemeRegistration = {
+  name: "claret-dark",
+  type: "dark",
+  fg: "#DDD3C7",
+  bg: "#180810",
+  colors: {
+    "editor.foreground": "#DDD3C7",
+    "editor.background": "#180810",
+    "editor.selectionBackground": "#2B1F22",
+    "editor.lineHighlightBackground": "#2B1F22",
+    "editorLineNumber.foreground": "#71685E",
+  },
+  tokenColors: [
+    // Comment — #71685E italic
+    {
+      name: "Comment",
+      scope: ["comment", "punctuation.definition.comment"],
+      settings: { foreground: "#71685E", fontStyle: "italic" },
+    },
+    // Keyword — #C75B7A
+    {
+      name: "Keyword",
+      scope: ["keyword", "storage.type", "storage.modifier"],
+      settings: { foreground: "#C75B7A" },
+    },
+    // Function — #D4A76A
+    {
+      name: "Function",
+      scope: ["entity.name.function", "support.function"],
+      settings: { foreground: "#D4A76A" },
+    },
+    // String — #8FA86E
+    {
+      name: "String",
+      scope: ["string", "punctuation.definition.string"],
+      settings: { foreground: "#8FA86E" },
+    },
+    // Number — #D4A76A
+    {
+      name: "Number",
+      scope: ["constant.numeric"],
+      settings: { foreground: "#D4A76A" },
+    },
+    // Constant — #D4A76A
+    {
+      name: "Constant",
+      scope: ["constant", "constant.language", "variable.language"],
+      settings: { foreground: "#D4A76A" },
+    },
+    // Type — #8995A8
+    {
+      name: "Type",
+      scope: [
+        "entity.name.type",
+        "entity.name.class",
+        "support.type",
+        "support.class",
+      ],
+      settings: { foreground: "#8995A8" },
+    },
+    // Variable — #DDD3C7
+    {
+      name: "Variable",
+      scope: ["variable", "variable.parameter"],
+      settings: { foreground: "#DDD3C7" },
+    },
+    // Parameter — #DDD3C7 italic (overrides Variable for parameters)
+    {
+      name: "Parameter",
+      scope: ["variable.parameter"],
+      settings: { foreground: "#DDD3C7", fontStyle: "italic" },
+    },
+    // Property — #B04A68
+    {
+      name: "Property",
+      scope: ["variable.other.property", "variable.other.member"],
+      settings: { foreground: "#B04A68" },
+    },
+    // JSON/YAML/TOML Keys — #B04A68
+    {
+      name: "JSON/YAML/TOML Keys",
+      scope: [
+        "meta.mapping.key string",
+        "support.type.property-name.json",
+        "punctuation.support.type.property-name.json",
+        "support.type.property-name.toml",
+        "punctuation.support.type.property-name.toml",
+        "entity.name.tag.yaml",
+        "support.type.property-name.yaml",
+      ],
+      settings: { foreground: "#B04A68" },
+    },
+    // Operator — #9E9288
+    {
+      name: "Operator",
+      scope: ["keyword.operator"],
+      settings: { foreground: "#9E9288" },
+    },
+    // Punctuation — #9E9288
+    {
+      name: "Punctuation",
+      scope: ["punctuation"],
+      settings: { foreground: "#9E9288" },
+    },
+    // Decorator — #D4A76A italic
+    {
+      name: "Decorator",
+      scope: ["meta.decorator", "punctuation.decorator"],
+      settings: { foreground: "#D4A76A", fontStyle: "italic" },
+    },
+    // Tag — #8995A8
+    {
+      name: "Tag",
+      scope: ["entity.name.tag"],
+      settings: { foreground: "#8995A8" },
+    },
+    // Tag Attribute — #6E7A90
+    {
+      name: "Tag Attribute",
+      scope: ["entity.other.attribute-name"],
+      settings: { foreground: "#6E7A90" },
+    },
+    // Invalid — #C44536
+    {
+      name: "Invalid",
+      scope: ["invalid", "invalid.illegal"],
+      settings: { foreground: "#C44536" },
+    },
+    // Escape — #8995A8
+    {
+      name: "Escape",
+      scope: ["constant.character.escape"],
+      settings: { foreground: "#8995A8" },
+    },
+    // Markup Heading — #C75B7A bold
+    {
+      name: "Markup Heading",
+      scope: ["markup.heading"],
+      settings: { foreground: "#C75B7A", fontStyle: "bold" },
+    },
+    // Markup Bold — bold (no color override)
+    {
+      name: "Markup Bold",
+      scope: ["markup.bold"],
+      settings: { fontStyle: "bold" },
+    },
+    // Markup Italic — italic (no color override)
+    {
+      name: "Markup Italic",
+      scope: ["markup.italic"],
+      settings: { fontStyle: "italic" },
+    },
+    // Markup Link — #8995A8
+    {
+      name: "Markup Link",
+      scope: ["markup.underline.link", "string.other.link"],
+      settings: { foreground: "#8995A8" },
+    },
+    // Diff Added — #8FA86E
+    {
+      name: "Diff Added",
+      scope: ["markup.inserted"],
+      settings: { foreground: "#8FA86E" },
+    },
+    // Diff Deleted — #C44536
+    {
+      name: "Diff Deleted",
+      scope: ["markup.deleted"],
+      settings: { foreground: "#C44536" },
+    },
+    // Diff Changed — #D4A76A
+    {
+      name: "Diff Changed",
+      scope: ["markup.changed"],
+      settings: { foreground: "#D4A76A" },
+    },
+  ],
+};

package/src/render/blocks/themes/claret-light.ts

@@ -0,0 +1,227 @@
+// Claret-light shiki theme — derived from claret.nvim light palette.
+// src/render/blocks/themes/claret-light.ts
+//
+// Source of truth: /claret.nvim/lua/claret/palette.lua (light section)
+// Scope-to-role mapping mirrors ClaretDark.tmTheme exactly; colors
+// are substituted from the light palette using the same semantic roles.
+//
+// Light palette (palette.lua):
+//   bg         #F5E6E2   editor background
+//   bg_mute    #DDD0CC   selection / line highlight
+//   text       #2A1F1A   default fg
+//   text_4     #928578   comment / gutter fg
+//   rose_1     #B80842   keyword / heading / statement
+//   rose_2     #920820   property / data keys
+//   gold_1     #946000   function / number / constant / decorator
+//   sage_1     #1B5500   string
+//   slate_1    #0E3088   type / class / tag / escape / link
+//   slate_2    #0A2575   tag attribute
+//   terra_1    #D42010   invalid / diff deleted
+//
+// Role mapping (matching dark tmTheme):
+//   Comment       → text_4   #928578   italic
+//   Keyword       → rose_1   #B80842
+//   Function      → gold_1   #946000
+//   String        → sage_1   #1B5500
+//   Number        → gold_1   #946000
+//   Constant      → gold_1   #946000
+//   Type          → slate_1  #0E3088
+//   Variable      → text     #2A1F1A
+//   Parameter     → text     #2A1F1A   italic
+//   Property      → rose_2   #920820
+//   Keys          → rose_2   #920820
+//   Operator      → text_4   #928578   (text_3 equivalent; nearest warm muted in light palette)
+//   Punctuation   → text_4   #928578
+//   Decorator     → gold_1   #946000   italic
+//   Tag           → slate_1  #0E3088
+//   Tag Attribute → slate_2  #0A2575
+//   Invalid       → terra_1  #D42010
+//   Escape        → slate_1  #0E3088
+//   Markup Heading→ rose_1   #B80842   bold
+//   Markup Bold   → (no fg)            bold
+//   Markup Italic → (no fg)            italic
+//   Markup Link   → slate_1  #0E3088
+//   Diff Added    → sage_1   #1B5500
+//   Diff Deleted  → terra_1  #D42010
+//   Diff Changed  → gold_1   #946000
+
+import type { ThemeRegistration } from "shiki";
+
+export const claretLight: ThemeRegistration = {
+  name: "claret-light",
+  type: "light",
+  fg: "#2A1F1A",
+  bg: "#F5E6E2",
+  colors: {
+    "editor.foreground": "#2A1F1A",
+    "editor.background": "#F5E6E2",
+    "editor.selectionBackground": "#DDD0CC",
+    "editor.lineHighlightBackground": "#DDD0CC",
+    "editorLineNumber.foreground": "#928578",
+  },
+  tokenColors: [
+    // Comment — #928578 italic
+    {
+      name: "Comment",
+      scope: ["comment", "punctuation.definition.comment"],
+      settings: { foreground: "#928578", fontStyle: "italic" },
+    },
+    // Keyword — #B80842
+    {
+      name: "Keyword",
+      scope: ["keyword", "storage.type", "storage.modifier"],
+      settings: { foreground: "#B80842" },
+    },
+    // Function — #946000
+    {
+      name: "Function",
+      scope: ["entity.name.function", "support.function"],
+      settings: { foreground: "#946000" },
+    },
+    // String — #1B5500
+    {
+      name: "String",
+      scope: ["string", "punctuation.definition.string"],
+      settings: { foreground: "#1B5500" },
+    },
+    // Number — #946000
+    {
+      name: "Number",
+      scope: ["constant.numeric"],
+      settings: { foreground: "#946000" },
+    },
+    // Constant — #946000
+    {
+      name: "Constant",
+      scope: ["constant", "constant.language", "variable.language"],
+      settings: { foreground: "#946000" },
+    },
+    // Type — #0E3088
+    {
+      name: "Type",
+      scope: [
+        "entity.name.type",
+        "entity.name.class",
+        "support.type",
+        "support.class",
+      ],
+      settings: { foreground: "#0E3088" },
+    },
+    // Variable — #2A1F1A
+    {
+      name: "Variable",
+      scope: ["variable", "variable.parameter"],
+      settings: { foreground: "#2A1F1A" },
+    },
+    // Parameter — #2A1F1A italic (overrides Variable for parameters)
+    {
+      name: "Parameter",
+      scope: ["variable.parameter"],
+      settings: { foreground: "#2A1F1A", fontStyle: "italic" },
+    },
+    // Property — #920820
+    {
+      name: "Property",
+      scope: ["variable.other.property", "variable.other.member"],
+      settings: { foreground: "#920820" },
+    },
+    // JSON/YAML/TOML Keys — #920820
+    {
+      name: "JSON/YAML/TOML Keys",
+      scope: [
+        "meta.mapping.key string",
+        "support.type.property-name.json",
+        "punctuation.support.type.property-name.json",
+        "support.type.property-name.toml",
+        "punctuation.support.type.property-name.toml",
+        "entity.name.tag.yaml",
+        "support.type.property-name.yaml",
+      ],
+      settings: { foreground: "#920820" },
+    },
+    // Operator — #928578
+    {
+      name: "Operator",
+      scope: ["keyword.operator"],
+      settings: { foreground: "#928578" },
+    },
+    // Punctuation — #928578
+    {
+      name: "Punctuation",
+      scope: ["punctuation"],
+      settings: { foreground: "#928578" },
+    },
+    // Decorator — #946000 italic
+    {
+      name: "Decorator",
+      scope: ["meta.decorator", "punctuation.decorator"],
+      settings: { foreground: "#946000", fontStyle: "italic" },
+    },
+    // Tag — #0E3088
+    {
+      name: "Tag",
+      scope: ["entity.name.tag"],
+      settings: { foreground: "#0E3088" },
+    },
+    // Tag Attribute — #0A2575
+    {
+      name: "Tag Attribute",
+      scope: ["entity.other.attribute-name"],
+      settings: { foreground: "#0A2575" },
+    },
+    // Invalid — #D42010
+    {
+      name: "Invalid",
+      scope: ["invalid", "invalid.illegal"],
+      settings: { foreground: "#D42010" },
+    },
+    // Escape — #0E3088
+    {
+      name: "Escape",
+      scope: ["constant.character.escape"],
+      settings: { foreground: "#0E3088" },
+    },
+    // Markup Heading — #B80842 bold
+    {
+      name: "Markup Heading",
+      scope: ["markup.heading"],
+      settings: { foreground: "#B80842", fontStyle: "bold" },
+    },
+    // Markup Bold — bold (no color override)
+    {
+      name: "Markup Bold",
+      scope: ["markup.bold"],
+      settings: { fontStyle: "bold" },
+    },
+    // Markup Italic — italic (no color override)
+    {
+      name: "Markup Italic",
+      scope: ["markup.italic"],
+      settings: { fontStyle: "italic" },
+    },
+    // Markup Link — #0E3088
+    {
+      name: "Markup Link",
+      scope: ["markup.underline.link", "string.other.link"],
+      settings: { foreground: "#0E3088" },
+    },
+    // Diff Added — #1B5500
+    {
+      name: "Diff Added",
+      scope: ["markup.inserted"],
+      settings: { foreground: "#1B5500" },
+    },
+    // Diff Deleted — #D42010
+    {
+      name: "Diff Deleted",
+      scope: ["markup.deleted"],
+      settings: { foreground: "#D42010" },
+    },
+    // Diff Changed — #946000
+    {
+      name: "Diff Changed",
+      scope: ["markup.changed"],
+      settings: { foreground: "#946000" },
+    },
+  ],
+};

package/src/render/blocks/types.ts

@@ -0,0 +1,127 @@
+// Block discriminated union — the closed type system for cesium_publish structured input.
+// src/render/blocks/types.ts
+
+export type Block =
+  | HeroBlock
+  | TldrBlock
+  | SectionBlock
+  | ProseBlock
+  | ListBlock
+  | CalloutBlock
+  | CodeBlock
+  | TimelineBlock
+  | CompareTableBlock
+  | RiskTableBlock
+  | KvBlock
+  | PillRowBlock
+  | DividerBlock
+  | DiagramBlock
+  | RawHtmlBlock;
+
+export type HeroBlock = {
+  type: "hero";
+  eyebrow?: string;
+  title: string;
+  subtitle?: string;
+  meta?: Array<{ k: string; v: string }>;
+};
+
+export type TldrBlock = {
+  type: "tldr";
+  // markdown subset; at most one tldr per document
+  markdown: string;
+};
+
+export type SectionBlock = {
+  type: "section";
+  title: string;
+  num?: string; // omitted = auto-numbered sequentially
+  eyebrow?: string;
+  children: Block[];
+};
+
+export type ProseBlock = {
+  type: "prose";
+  markdown: string;
+};
+
+export type ListBlock = {
+  type: "list";
+  style?: "bullet" | "number" | "check";
+  items: string[]; // each item is markdown (subset)
+};
+
+export type CalloutBlock = {
+  type: "callout";
+  variant: "note" | "warn" | "risk";
+  title?: string;
+  markdown: string;
+};
+
+export type CodeBlock = {
+  type: "code";
+  lang: string; // required; "text" if unknown
+  code: string;
+  filename?: string;
+  caption?: string;
+};
+
+export type TimelineBlock = {
+  type: "timeline";
+  items: Array<{ label: string; text: string; date?: string }>;
+};
+
+export type CompareTableBlock = {
+  type: "compare_table";
+  headers: string[];
+  rows: string[][]; // cells are markdown (subset)
+};
+
+export type RiskTableBlock = {
+  type: "risk_table";
+  rows: Array<{
+    risk: string;
+    likelihood: "low" | "medium" | "high";
+    impact: "low" | "medium" | "high";
+    mitigation: string;
+  }>;
+};
+
+export type KvBlock = {
+  type: "kv";
+  rows: Array<{ k: string; v: string }>;
+};
+
+export type PillRowBlock = {
+  type: "pill_row";
+  items: Array<{ kind: "pill" | "tag"; text: string }>;
+};
+
+export type DividerBlock = {
+  type: "divider";
+  label?: string;
+};
+
+export type DiagramBlock = {
+  type: "diagram";
+  caption?: string;
+  // exactly one of svg or html
+  svg?: string;
+  html?: string;
+};
+
+export type RawHtmlBlock = {
+  type: "raw_html";
+  html: string;
+  purpose?: string; // brief reason; surfaced in critique findings
+};
+
+// ─── BlockMeta ───────────────────────────────────────────────────────────────
+
+export type BlockMeta = {
+  type: Block["type"];
+  description: string;
+  schema: object; // JSON Schema fragment for the block
+  example: Block; // canonical example matching schema
+  renderedExample?: string; // optional pre-rendered HTML for docs
+};