@texuli/blocks 0.0.0-stage → 0.1.0-next.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dailybot, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# @texuli/blocks
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Content blocks: the closed content vocabulary for pages, documents and slides.
+
+## Status
+
+**Core engine (T-blocks-core):** schemas, limits, untrusted-input guard, closed
+formula AST, text helpers and catalog metadata. UI family renderers land in
+later PLAN_001 tasks.
+
+## Core API (`@texuli/blocks` / `@texuli/blocks/core`)
+
+| Area | Exports |
+| --- | --- |
+| Limits | `BLOCK_LIMITS` |
+| Safety | `isUnsafeTextCharacter`, `classifyMediaSource`, `hasUnsafeText` |
+| Schemas | `safeParseBlocks`, `safeParseBlock`, `BLOCK_TYPES`, block types |
+| Untrusted | `parseUntrustedBlocks` |
+| Formula | `parseFormula`, `evaluateFormula`, `formatFormulaValue`, `FORMULA_LIMITS` |
+| Catalog | `BLOCK_CATALOG`, `getCatalogEntry`, `validateBlocksForAuthoring` |
+| Text | `walkBlocks`, `blockText`, `headingOutline`, `slugifyHeading` |
+
+```ts
+import {
+  parseUntrustedBlocks,
+  parseFormula,
+  evaluateFormula,
+  BLOCK_CATALOG,
+} from '@texuli/blocks';
+
+const loaded = parseUntrustedBlocks(agentJson);
+if (loaded.success) {
+  // loaded.blocks is schema-valid
+}
+
+const formula = parseFormula({
+  op: 'mul',
+  left: { op: 'var', name: 'seats' },
+  right: { op: 'num', value: 12 },
+});
+if (formula.success) evaluateFormula(formula.formula, { seats: 3 }); // 36
+```
+
+### Core block types (this task)
+
+`heading`, `text`, `list`, `quote`, `callout`, `divider`, `code`, `cta`,
+`columns`. Catalog entries include `useWhen`, `dontUseWhen`, `limits`, `a11y`,
+`exampleMinimal` and `exampleRich`.
+
+### Rules
+
+- No zod: owned validators only (runtime allowlist).
+- No HTML sinks; CTA `href` uses `@texuli/core` `safeHref` (`untrusted` tier).
+- Formulas are closed JSON ASTs — never executed as code.
+- Trojan Source / bidi controls are stripped or refused.
+- Fictional example data only (`example.com`).
+
+## Layout
+
+```text
+packages/blocks/
+├── src/
+│   ├── index.ts          re-exports core
+│   └── core/             engine (this task)
+│       ├── limits.ts, safety.ts, untrusted.ts, text.ts
+│       ├── schema/       vocabulary, primitives, blocks
+│       ├── formula/      parse + evaluate
+│       └── catalog/      entries + authoring validate
+└── tests/core.test.ts
+```
+
+## Testing
+
+```bash
+pnpm vitest run packages/blocks/tests/core.test.ts
+pnpm --filter @texuli/blocks typecheck
+npx biome check packages/blocks
+```

package/dist/code/CodeBlockView.svelte

@@ -0,0 +1,135 @@
+<script lang="ts">
+import { onDestroy } from 'svelte';
+import { copyText } from 'texuli/kbd-code';
+import { checkCodeBlock } from './check.js';
+import type { CodeBlockViewProps } from './family.js';
+import { loadCodeGrammar, resolveCodeLanguage } from './grammars.js';
+import { resolveHighlightSteps } from './highlight.js';
+import { fillCodeLabel, resolveCodeBlockLabels } from './labels.js';
+import { activeHighlightIndex, codeTokenClass } from './token-styles.js';
+import { type CodeToken, type Grammar, splitTokenLines, tokenize } from './tokenizer.js';
+import './code.css';
+
+/**
+ * The code family renderer. It takes untrusted data and renders only what
+ * `checkCodeBlock` accepts; anything else becomes an inert notice. Tokens are
+ * printed as text in spans colored by theme roles, never as HTML. The grammar
+ * of the block's language loads on demand; until it arrives (and for `text`
+ * or unknown languages) the same text shows unhighlighted.
+ */
+let {
+  block,
+  labels,
+  oninvalid,
+  lineNumbers,
+  highlights,
+  hostStep,
+  step,
+  copyable = true,
+}: CodeBlockViewProps = $props();
+
+const check = $derived(checkCodeBlock(block));
+const text = $derived(resolveCodeBlockLabels(labels));
+const uid = $props.id();
+const nameId = `tx-code-name-${uid}`;
+
+$effect(() => {
+  if (!check.ok) oninvalid?.(check.issues);
+});
+
+const code = $derived(check.ok ? check.block.code : '');
+const lang = $derived(check.ok ? check.block.lang : undefined);
+
+let loaded = $state<{ lang: string | undefined; grammar: Grammar } | null>(null);
+$effect(() => {
+  const wanted = lang;
+  let current = true;
+  void loadCodeGrammar(wanted).then((grammar) => {
+    if (current) loaded = grammar ? { lang: wanted, grammar } : null;
+  });
+  return () => {
+    current = false;
+  };
+});
+
+const tokenized = $derived(loaded !== null && loaded.lang === lang);
+const tokens = $derived.by((): CodeToken[] => {
+  if (loaded && loaded.lang === lang) return tokenize(code, loaded.grammar);
+  return code === '' ? [] : [{ kind: 'plain', text: code }];
+});
+const lines = $derived(splitTokenLines(tokens));
+// Block data sets highlights and line numbers; props override them.
+const highlightSteps = $derived(
+  highlights ?? (check.ok ? check.block.highlights : undefined) ?? []
+);
+const numbered = $derived(lineNumbers ?? (check.ok ? check.block.lineNumbers : undefined) ?? false);
+const steps = $derived(resolveHighlightSteps(highlightSteps, lines.length));
+const active = $derived(
+  activeHighlightIndex(steps.length, step, hostStep, check.ok ? (check.block.step ?? 0) : 0)
+);
+const marked = $derived(new Set(active >= 0 ? steps[active] : []));
+const name = $derived(
+  check.ok ? (check.block.filename ?? check.block.lang?.toUpperCase() ?? text.code) : text.code
+);
+
+let status = $state<'idle' | 'copying' | 'copied' | 'failed'>('idle');
+let timer: ReturnType<typeof setTimeout> | undefined;
+onDestroy(() => clearTimeout(timer));
+
+async function copy(): Promise<void> {
+  clearTimeout(timer);
+  status = 'copying';
+  status = (await copyText(code)) ? 'copied' : 'failed';
+  timer = setTimeout(() => {
+    status = 'idle';
+  }, 2000);
+}
+</script>
+
+{#if !check.ok}
+  <p class="tx-block tx-block-invalid" role="note" data-tx-block="invalid">{text.invalid}</p>
+{:else}
+  <figure
+    class="tx-block tx-code"
+    data-tx-block="code"
+    data-lang={lang}
+    data-grammar={lang === undefined ? undefined : (resolveCodeLanguage(lang) ?? 'none')}
+    data-tokenized={tokenized || undefined}
+    data-highlight-step={active >= 0 ? active : undefined}
+    data-tone={check.block.tone}
+  >
+    <div class="tx-code__bar">
+      <span id={nameId} class="tx-code__name">{name}</span>
+      {#if copyable}
+        <button
+          type="button"
+          class="tx-code__copy"
+          data-state={status}
+          aria-label={fillCodeLabel(text.copyName, name)}
+          aria-busy={status === 'copying' || undefined}
+          disabled={status === 'copying'}
+          onclick={() => copy()}
+        >
+          <svg class="tx-code__icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false">
+            {#if status === 'copied'}
+              <path d="M20 6 9 17l-5-5" />
+            {:else if status === 'failed'}
+              <path d="M12 8v5m0 4h.01M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0" />
+            {:else}
+              <rect x="9" y="9" width="13" height="13" rx="2" /><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
+            {/if}
+          </svg>
+          <span aria-hidden="true">{status === 'copied' ? text.copied : status === 'failed' ? text.copyFailed : text.copy}</span>
+        </button>
+      {/if}
+    </div>
+    <!-- svelte-ignore a11y_no_noninteractive_tabindex -->
+    <!-- Long lines scroll, so keyboard users must reach them (WCAG 2.1.1); a focusable scroll area needs a role to carry its name. -->
+    <!-- Each line ends with a real newline except the last, so the text equals the source; line numbers are CSS content, never text. Code reads left to right even on RTL pages. -->
+    <pre class="tx-code__pre" class:tx-code__pre--numbered={numbered} role="region" tabindex="0" dir="ltr" aria-labelledby={nameId}><code class="tx-code__code">{#each lines as line, index (index)}{@const number = index + 1}<svelte:element this={marked.has(number) ? 'mark' : 'span'} class="tx-code__line" data-line={number} data-highlighted={marked.has(number) || undefined}>{#each line as token, t (t)}<span class={codeTokenClass(token.kind)}>{token.text}</span>{/each}{index < lines.length - 1 ? '\n' : ''}</svelte:element>{/each}</code></pre>
+    {#if check.block.caption}
+      <figcaption class="tx-code__caption">{check.block.caption}</figcaption>
+    {/if}
+    <span class="tx-code__sr-only" aria-live="polite">{status === 'copied' ? text.copiedAnnouncement : status === 'failed' ? text.copyFailedAnnouncement : ''}</span>
+  </figure>
+{/if}

package/dist/code/CodeBlockView.svelte.d.ts

@@ -0,0 +1,5 @@
+/// <reference path="../css-modules.d.ts" />
+import type { CodeBlockViewProps } from './family.js';
+declare const CodeBlockView: import("svelte").Component<CodeBlockViewProps, {}, "">;
+type CodeBlockView = ReturnType<typeof CodeBlockView>;
+export default CodeBlockView;

package/dist/code/check.d.ts

@@ -0,0 +1,15 @@
+import type { FieldIssue } from '../core/schema/primitives.js';
+import type { CodeFamilyBlock } from './family-engine.js';
+export type CodeBlockCheck = {
+    ok: true;
+    block: CodeFamilyBlock;
+} | {
+    ok: false;
+    issues: FieldIssue[];
+};
+/**
+ * The only way data reaches the code renderer: untrusted input runs through
+ * the block schemas (length, line count, language token, no bidi controls),
+ * then must be a code block.
+ */
+export declare function checkCodeBlock(value: unknown): CodeBlockCheck;

package/dist/code/check.js

@@ -0,0 +1,14 @@
+import { parseCodeFamilyBlock } from "../core/schema/code-family.js";
+import { parseFamilyBlock } from "../core/schema/parse-family.js";
+/**
+ * The only way data reaches the code renderer: untrusted input runs through
+ * the block schemas (length, line count, language token, no bidi controls),
+ * then must be a code block.
+ */
+export function checkCodeBlock(value) {
+    // Only this family's parser: the renderer does not bundle every family's rules.
+    const parsed = parseFamilyBlock(value, [parseCodeFamilyBlock], 'code');
+    if (!parsed.success)
+        return { ok: false, issues: parsed.issues };
+    return { ok: true, block: parsed.data };
+}

package/dist/code/code.css

@@ -0,0 +1,201 @@
+/**
+ * Code block — header bar, copy button, scroller, lines, highlights and token
+ * colors. Token colors are theme roles that reach AA as text on `surface` and
+ * on `muted` (highlighted lines) in every library theme; keywords and tags are
+ * bold and comments italic, so kinds differ without color too.
+ * @layer tx.components so consumer utilities can override.
+ */
+@layer tx.components {
+  .tx-code {
+    /* In a grid or flex parent, long lines scroll inside instead of widening the page. */
+    min-inline-size: 0;
+    max-inline-size: 100%;
+    margin: 0;
+    border: var(--tx-border-width, 1px) solid var(--tx-border, currentColor);
+    border-radius: var(--tx-radius, 0.5rem);
+    background-color: var(--tx-surface, Canvas);
+    color: var(--tx-surface-foreground, CanvasText);
+    overflow: clip;
+  }
+
+  .tx-code__bar {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.5rem;
+    padding-block: 0.25rem;
+    padding-inline: 0.75rem 0.25rem;
+    border-block-end: var(--tx-border-width, 1px) solid var(--tx-border, currentColor);
+  }
+
+  .tx-code__name {
+    min-inline-size: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    font-family: var(--tx-font-mono, ui-monospace, monospace);
+    font-size: var(--tx-font-size-xs, 0.75rem);
+    font-weight: var(--tx-font-weight-medium, 500);
+    color: var(--tx-muted-foreground, CanvasText);
+  }
+
+  .tx-code__copy {
+    display: inline-flex;
+    flex-shrink: 0;
+    align-items: center;
+    gap: 0.375rem;
+    min-block-size: var(--tx-target-size, 2rem);
+    padding-inline: 0.5rem;
+    border: 0;
+    border-radius: calc(var(--tx-radius, 0.5rem) * 0.75);
+    background: transparent;
+    color: var(--tx-muted-foreground, ButtonText);
+    font: inherit;
+    font-size: var(--tx-font-size-xs, 0.75rem);
+    font-weight: var(--tx-font-weight-medium, 500);
+    cursor: pointer;
+  }
+
+  .tx-code__copy:hover {
+    background-color: var(--tx-muted, Canvas);
+    color: var(--tx-foreground, ButtonText);
+  }
+
+  .tx-code__copy:focus-visible,
+  .tx-code__pre:focus-visible {
+    outline: var(--tx-focus-ring-width, 2px) solid var(--tx-ring, Highlight);
+    outline-offset: calc(var(--tx-focus-ring-width, 2px) * -1);
+  }
+
+  .tx-code__copy:disabled {
+    cursor: progress;
+  }
+
+  .tx-code__icon {
+    inline-size: 0.875rem;
+    block-size: 0.875rem;
+    fill: none;
+    stroke: currentColor;
+    stroke-width: 2;
+    stroke-linecap: round;
+    stroke-linejoin: round;
+  }
+
+  .tx-code__pre {
+    margin: 0;
+    padding-block: 0.75rem;
+    overflow-x: auto;
+    font-family: var(--tx-font-mono, ui-monospace, monospace);
+    font-size: 0.8125rem;
+    line-height: 1.6;
+    tab-size: 2;
+  }
+
+  .tx-code__code {
+    display: block;
+    min-inline-size: max-content;
+    font: inherit;
+  }
+
+  .tx-code__line {
+    display: block;
+    padding-inline: 0.75rem 1rem;
+    border-inline-start: 2px solid transparent;
+    background: transparent;
+    color: inherit;
+  }
+
+  .tx-code__line[data-highlighted] {
+    border-inline-start-color: var(--tx-primary, Highlight);
+    background-color: var(--tx-muted, Canvas);
+  }
+
+  .tx-code__pre--numbered .tx-code__line::before {
+    display: inline-block;
+    min-inline-size: 2.5ch;
+    margin-inline-end: 1.25ch;
+    content: attr(data-line);
+    color: var(--tx-muted-foreground, CanvasText);
+    text-align: end;
+    user-select: none;
+  }
+
+  /* Numbers are visual only: the line text is what is read and copied. */
+  @supports (content: "a" / "") {
+    .tx-code__pre--numbered .tx-code__line::before {
+      content: attr(data-line) / "";
+    }
+  }
+
+  .tx-code-tok--keyword,
+  .tx-code-tok--tag {
+    color: var(--tx-primary, CanvasText);
+    font-weight: var(--tx-font-weight-bold, 700);
+  }
+
+  .tx-code-tok--string,
+  .tx-code-tok--attr {
+    color: var(--tx-success, CanvasText);
+  }
+
+  .tx-code-tok--number,
+  .tx-code-tok--constant {
+    color: var(--tx-destructive, CanvasText);
+  }
+
+  .tx-code-tok--function,
+  .tx-code-tok--type {
+    color: var(--tx-info, CanvasText);
+  }
+
+  .tx-code-tok--comment {
+    color: var(--tx-muted-foreground, CanvasText);
+    font-style: italic;
+  }
+
+  .tx-code__caption {
+    padding-block: 0.5rem;
+    padding-inline: 0.75rem;
+    border-block-start: var(--tx-border-width, 1px) solid var(--tx-border, currentColor);
+    color: var(--tx-muted-foreground, CanvasText);
+    font-family: var(--tx-font-sans, system-ui, sans-serif);
+    font-size: var(--tx-font-size-sm, 0.875rem);
+  }
+
+  .tx-code__sr-only {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    margin: -1px;
+    padding: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+  }
+
+  .tx-block-invalid {
+    margin: 0;
+    padding-block: 0.5em;
+    padding-inline: 0.75em;
+    border: 1px dashed currentColor;
+    border-radius: 0.375em;
+    font-size: 0.875em;
+  }
+
+  @media (forced-colors: active) {
+    .tx-code,
+    .tx-code__bar {
+      border-color: CanvasText;
+    }
+    .tx-code__line[data-highlighted] {
+      forced-color-adjust: none;
+      background-color: Highlight;
+      color: HighlightText;
+      border-inline-start-color: HighlightText;
+    }
+    .tx-code__line[data-highlighted] [class^="tx-code-tok--"] {
+      color: HighlightText;
+    }
+  }
+}

package/dist/code/code.css.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/code/engine-entry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@texuli/blocks/code/engine` — Svelte-free code family surface for hosts that
+ * parse/highlight without mounting the renderer. Grammars + labels + checks;
+ * full tokenize helpers remain on `@texuli/blocks/code/tokenizer`.
+ */
+export { type CodeBlockCheck, checkCodeBlock } from './check.js';
+export { CODE_BLOCK_TYPES, type CodeBlockViewProps, type CodeFamilyBlock, type CodeFamilyBlockType, isCodeFamilyBlock, } from './family-engine.js';
+export { CODE_GRAMMAR_LANGUAGES, type CodeGrammarLanguage, loadCodeGrammar, resolveCodeLanguage, } from './grammars.js';
+export { type CodeBlockLabelOverrides, type CodeBlockLabels, DEFAULT_CODE_BLOCK_LABELS, fillCodeLabel, resolveCodeBlockLabels, } from './labels.js';
+export { activeHighlightIndex, CODE_COLOR_ROLES, CODE_TOKEN_STYLES, type CodeColorRole, type CodeTokenStyle, codeTokenClass, } from './token-styles.js';

package/dist/code/engine-entry.js

@@ -0,0 +1,10 @@
+/**
+ * `@texuli/blocks/code/engine` — Svelte-free code family surface for hosts that
+ * parse/highlight without mounting the renderer. Grammars + labels + checks;
+ * full tokenize helpers remain on `@texuli/blocks/code/tokenizer`.
+ */
+export { checkCodeBlock } from "./check.js";
+export { CODE_BLOCK_TYPES, isCodeFamilyBlock, } from "./family-engine.js";
+export { CODE_GRAMMAR_LANGUAGES, loadCodeGrammar, resolveCodeLanguage, } from "./grammars.js";
+export { DEFAULT_CODE_BLOCK_LABELS, fillCodeLabel, resolveCodeBlockLabels, } from "./labels.js";
+export { activeHighlightIndex, CODE_COLOR_ROLES, CODE_TOKEN_STYLES, codeTokenClass, } from "./token-styles.js";

package/dist/code/engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@texuli/blocks/code/tokenizer`: an owned, linear-time code tokenizer.
+ * Source becomes `{ kind, text }` tokens for ts, js, json, bash, python, html,
+ * css, sql and yaml; renderers print the text in spans colored by theme
+ * roles and never build HTML. Ported from Protoyard's code family (which
+ * replaced a 303 KB highlight.js).
+ *
+ * ```ts
+ * const lines = splitTokenLines(tokenizeCode('const a = 1;', 'ts'));
+ * // [[{ kind: 'keyword', text: 'const' }, { kind: 'plain', text: ' a ' }, …]]
+ * ```
+ *
+ * This entry bundles every grammar, for tools, servers and tests. The
+ * renderer loads only the grammar of each block's language (`loadCodeGrammar`).
+ */
+export { countCodeLines, type HighlightStep, parseLineSpec, resolveHighlightSteps, } from './highlight.js';
+export { bashGrammar, cssGrammar, htmlGrammar, javascriptGrammar, jsonGrammar, pythonGrammar, sqlGrammar, tokenizeCode, typescriptGrammar, yamlGrammar, } from './tokenize-code.js';
+export { CODE_TOKEN_KINDS, CODE_TOKENIZE_MAX_LENGTH, type CodeToken, type CodeTokenKind, type Grammar, type GrammarRule, type RuleContext, splitTokenLines, sticky, tokenize, } from './tokenizer.js';

package/dist/code/engine.js

@@ -0,0 +1,18 @@
+/**
+ * `@texuli/blocks/code/tokenizer`: an owned, linear-time code tokenizer.
+ * Source becomes `{ kind, text }` tokens for ts, js, json, bash, python, html,
+ * css, sql and yaml; renderers print the text in spans colored by theme
+ * roles and never build HTML. Ported from Protoyard's code family (which
+ * replaced a 303 KB highlight.js).
+ *
+ * ```ts
+ * const lines = splitTokenLines(tokenizeCode('const a = 1;', 'ts'));
+ * // [[{ kind: 'keyword', text: 'const' }, { kind: 'plain', text: ' a ' }, …]]
+ * ```
+ *
+ * This entry bundles every grammar, for tools, servers and tests. The
+ * renderer loads only the grammar of each block's language (`loadCodeGrammar`).
+ */
+export { countCodeLines, parseLineSpec, resolveHighlightSteps, } from "./highlight.js";
+export { bashGrammar, cssGrammar, htmlGrammar, javascriptGrammar, jsonGrammar, pythonGrammar, sqlGrammar, tokenizeCode, typescriptGrammar, yamlGrammar, } from "./tokenize-code.js";
+export { CODE_TOKEN_KINDS, CODE_TOKENIZE_MAX_LENGTH, splitTokenLines, sticky, tokenize, } from "./tokenizer.js";

package/dist/code/family-engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Code family meta without loaders (Svelte-free).
+ * Full tokenizer stays on `@texuli/blocks/code/tokenizer` (`./engine.ts`).
+ */
+import type { CodeBlock, FieldIssue } from '../core/index.js';
+import type { HighlightStep } from './highlight.js';
+import type { CodeBlockLabelOverrides } from './labels.js';
+export declare const CODE_BLOCK_TYPES: readonly ["code"];
+export type CodeFamilyBlockType = (typeof CODE_BLOCK_TYPES)[number];
+export type CodeFamilyBlock = CodeBlock;
+export declare function isCodeFamilyBlock(block: {
+    type: string;
+}): block is CodeFamilyBlock;
+export interface CodeBlockViewProps {
+    block: unknown;
+    labels?: CodeBlockLabelOverrides;
+    oninvalid?: (issues: FieldIssue[]) => void;
+    lineNumbers?: boolean;
+    highlights?: readonly HighlightStep[];
+    hostStep?: number;
+    step?: number;
+    copyable?: boolean;
+}

package/dist/code/family-engine.js

@@ -0,0 +1,4 @@
+export const CODE_BLOCK_TYPES = ['code'];
+export function isCodeFamilyBlock(block) {
+    return CODE_BLOCK_TYPES.includes(block.type);
+}

package/dist/code/family.d.ts

@@ -0,0 +1,7 @@
+import type { Component } from 'svelte';
+import type { CodeBlockViewProps } from './family-engine.js';
+export { CODE_BLOCK_TYPES, type CodeBlockViewProps, type CodeFamilyBlock, type CodeFamilyBlockType, isCodeFamilyBlock, } from './family-engine.js';
+/** Lazily loads the code family renderer (its own chunk). */
+export declare function loadCodeFamily(): Promise<{
+    default: Component<CodeBlockViewProps>;
+}>;

package/dist/code/family.js

@@ -0,0 +1,5 @@
+export { CODE_BLOCK_TYPES, isCodeFamilyBlock, } from "./family-engine.js";
+/** Lazily loads the code family renderer (its own chunk). */
+export function loadCodeFamily() {
+    return import('./CodeBlockView.svelte');
+}

package/dist/code/grammars.d.ts

@@ -0,0 +1,12 @@
+import type { Grammar } from './tokenizer.js';
+/** Languages with a grammar. Anything else renders as plain text. */
+export declare const CODE_GRAMMAR_LANGUAGES: readonly ["ts", "js", "json", "bash", "python", "html", "css", "sql", "yaml"];
+export type CodeGrammarLanguage = (typeof CODE_GRAMMAR_LANGUAGES)[number];
+/** A language id or alias (`typescript`, `sh`, `yml`…) → a grammar language, or `null`. */
+export declare function resolveCodeLanguage(lang: string): CodeGrammarLanguage | null;
+/**
+ * The grammar for a language id or alias, loaded on demand and cached; `null`
+ * for `text` and unknown languages. A failed load is not cached, so a later
+ * render can retry.
+ */
+export declare function loadCodeGrammar(lang: string | undefined): Promise<Grammar | null>;