@miliastry/quasar 1.0.6 → 1.1.0

package/src/Visitors/MarkdownExporter.ts

@@ -1,14 +1,13 @@
 /**
  * DocumentEngine — MarkdownExporter
  *
- * Exports the Document Model to Markdown.
- * Demonstrates the format-agnostic power of the engine:
- * BBCode in → DocumentModel → Markdown out.
- *
- * A single visitor, no parser changes needed.
+ * Exports the Document Model to Markdown with hybrid BBCode embedding
+ * for features not natively supported in standard CommonMark (color, size,
+ * underline, alignment, collapsible boxes).
  */
 
 import { RedNode } from '../Syntax/RedNode'
+import { nodeAttrValue } from '../Syntax/nodeAttr'
 import { Visitor } from './Visitor'
 
 export class MarkdownExporter extends Visitor<string> {
@@ -34,35 +33,99 @@ export class MarkdownExporter extends Visitor<string> {
     switch (node.kind) {
       case 'bold': return `**${content}**`
       case 'italic': return `*${content}*`
-      case 'underline': return content
+      case 'underline': return `++${content}++`
       case 'strikethrough': return `~~${content}~~`
       case 'inline_code': return `\`${content}\``
       case 'code': return `\`\`\`\n${content}\n\`\`\``
       case 'spoiler': return `||${content}||`
-      case 'color': return content
-      case 'font_size': return content
-      case 'font': return content
-      case 'heading': return `${'#'.repeat(Math.min(depth + 1, 6))} ${content}`
-      case 'center': return content
-      case 'right': return content
-      case 'left': return content
-      case 'url': return `[${content}](${this.extractValue(node) || content})`
-      case 'email': return `[${content}](mailto:${this.extractValue(node) || content})`
-      case 'profile': return `[${content}](https://osu.ppy.sh/users/${this.extractValue(node) || content})`
-      case 'image': return `![Image](${node.text || ''})`
+      case 'color': {
+        const c = (node.metadata?.color as string) || this.extractValue(node) || '#ffffff'
+        return `[${content}]{${c}}`
+      }
+      case 'font_size': {
+        const s = (node.metadata?.size as string) || this.extractValue(node) || '100'
+        return `[${content}]{size="${s}"}`
+      }
+      case 'font': {
+        const f = (node.metadata?.font as string) || this.extractValue(node) || 'sans-serif'
+        return `[${content}]{font="${f}"}`
+      }
+      case 'heading': {
+        const level = (node.metadata?.level as number) || depth + 1
+        return `${'#'.repeat(Math.min(level, 6))} ${content}`
+      }
+      case 'center': return `-> ${content.trim()} <-`
+      case 'right': return `-> ${content.trim()} ->`
+      case 'left': return `[left]${content}[/left]`
+      case 'align': {
+        const a = (node.metadata?.align as string) || this.extractValue(node) || 'center'
+        if (a === 'center') return `-> ${content.trim()} <-`
+        if (a === 'right') return `-> ${content.trim()} ->`
+        return `[align=${a}]${content}[/align]`
+      }
+      case 'url': return `[${content}](${node.metadata?.href || this.extractValue(node) || content})`
+      case 'email': {
+        const addr = (node.metadata?.href as string)?.replace('mailto:', '') || this.extractValue(node) || content
+        return `[${content}](mailto:${addr})`
+      }
+      case 'profile': return `[${content}](https://osu.ppy.sh/users/${node.metadata?.username || this.extractValue(node) || content})`
+      case 'image': {
+        const src = (node.metadata?.src as string) || (node.text && !node.text.startsWith('=') ? node.text : '') || content
+        const alt = (node.metadata?.alt as string) || (content && content !== src ? content : 'Image')
+        return `![${alt}](${src})`
+      }
       case 'video': return `[🎥 YouTube Video](https://youtube.com/watch?v=${node.text || ''})`
       case 'audio': return `[🎵 Audio](${node.text || ''})`
-      case 'quote': return `> **${this.extractValue(node) || 'Quote'}**\n> ${content.replace(/\\n/g, '\n> ')}`
-      case 'notice': return `> [!NOTE]\n> ${content.replace(/\\n/g, '\n> ')}`
-      case 'spoilerbox': return `**${this.renderTitleMarkdown(node) || 'Spoiler'}**\n${content}`
+      case 'quote': {
+        const source = (node.metadata?.source as string) || this.extractValue(node)
+        const header = source ? `**${source}**\n> ` : ''
+        return `> ${header}${content.replace(/\n/g, '\n> ')}`
+      }
+      case 'notice': {
+        const color = (node.metadata?.color as string) || this.extractValue(node)
+        const colorAttr = color ? `=${color}` : ''
+        return `[notice${colorAttr}]\n${content}\n[/notice]`
+      }
+      case 'wnotice': {
+        const color = (node.metadata?.color as string) || this.extractValue(node)
+        const colorAttr = color ? `=${color}` : ''
+        return `[wnotice${colorAttr}]\n${content}\n[/wnotice]`
+      }
+      case 'spoilerbox':
       case 'box':
-      case 'boxw': return `**${this.renderTitleMarkdown(node) || 'Box'}**\n${content}`
-      case 'list': return content
-      case 'list_item': return `${'  '.repeat(Math.max(0, depth - 1))}- ${content.trim()}`
+      case 'boxw': {
+        const title = this.renderTitleMarkdown(node)
+        const header = title ? `::: details ${title}` : '::: details'
+        return `${header}\n${content}\n:::`
+      }
+      case 'list': {
+        const lines: string[] = []
+        let orderIdx = 1
+        for (const child of node.children) {
+          if (child.kind === 'list_item') {
+            const itemContent = child.children.map(c => this.exportNode(c, depth)).join('')
+            const isOrdered = node.metadata?.ordered
+            const prefix = isOrdered ? `${orderIdx++}. ` : '- '
+            lines.push(`${'  '.repeat(Math.max(0, depth))}${prefix}${itemContent.trim()}`)
+          }
+        }
+        return lines.length > 0 ? lines.join('\n') + '\n' : content
+      }
+      case 'list_item': {
+        const isOrdered = node.parent?.metadata?.ordered
+        const prefix = isOrdered ? '1. ' : '- '
+        return `${'  '.repeat(Math.max(0, depth - 1))}${prefix}${content.trim()}`
+      }
+      case 'separator': return '---'
       case 'spacing': return '\n'
       case 'empty_line': return '\n'
-      case 'text':
-      default: return content || node.text || ''
+      case 'paragraph': return content
+      case 'text': return content || node.text || ''
+      default: {
+        const val = this.extractValue(node) || (node.metadata?.value as string) || (node.metadata?.raw as string)
+        const attr = val !== undefined && val !== null && String(val) !== '' ? `=${val}` : ''
+        return `[${node.kind}${attr}]${content}[/${node.kind}]`
+      }
     }
   }
 
@@ -76,24 +139,18 @@ export class MarkdownExporter extends Visitor<string> {
 
   /**
    * Read a BBCode tag's `=VALUE` attribute.
+   */
+  /**
+   * El atributo del nodo, o `undefined` si no lleva.
    *
-   * This previously read `node.properties` / `node.attributes`, neither of
-   * which exists on RedNode — so it silently returned `undefined` for every
-   * node and every call site fell through to its placeholder. That is why
-   * Markdown export dropped link targets and quote/box titles.
+   * El recorte lo hace `nodeAttrValue`, el mismo lector del `HTMLRenderer`;
+   * aquí sólo se cambia el contrato del caso vacío. Este exportador encadena
+   * `metadata ?? atributo ?? contenido`, así que necesita un `undefined`
+   * explícito donde `nodeAttrValue` devuelve el texto crudo — es la única
+   * diferencia, y por eso no se llama directamente.
    */
   private extractValue(node: RedNode): string | undefined {
-    const text = node.text || ''
-    const eqIdx = text.indexOf('=')
-    if (eqIdx < 0) return undefined
-
-    let value = text.slice(eqIdx + 1)
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1)
-    }
-    return value || undefined
+    if (!(node.text || '').includes('=')) return undefined
+    return nodeAttrValue(node) || undefined
   }
 }

package/src/Visitors/TiptapExporter.ts

@@ -121,6 +121,7 @@ export class TiptapExporter extends Visitor<string> {
       case 'rainbow':
       case 'grow':
       case 'sinewave':
+      case 'paint':
         return { type: 'miliastryEffect', attrs: { effect: node.kind, ...node.metadata } }
     }
     return null

package/src/Visuals/index.ts

@@ -6,11 +6,14 @@
  * modificar el renderer HTML.
  *
  * Uso:
- *   // Importar como CSS directo (soportado por Next.js, Vite, Webpack):
- *   import 'MiliastryPlatform/DocumentEngine/Visuals/osu.css'
+ *   // Desde la FUENTE, que es como lo consume el monorepo (Next.js, Vite,
+ *   // Webpack): esta ruta funciona sin haber compilado nada.
+ *   import '@miliastry/quasar/src/Visuals/osu.css'
+ *
+ *   // Desde el paquete PUBLICADO. Solo resuelve tras `npm run build`, que es
+ *   // lo que copia los CSS a dist/Visuals (ver scripts/copy-css.mjs).
+ *   import '@miliastry/quasar/Visuals/osu.css'
  *
- *   // O desde un componente React:
- *   import 'MiliastryPlatform/DocumentEngine/Visuals/osu.css'
  *   // Luego en el JSX: <div className="bbcode-preview" ...
  *
  * Para cambiar de tema visual, solo cambia el import del CSS.

package/src/Visuals/lyne.css

@@ -6,11 +6,28 @@
  *
  * Scoped under `.bbcode-preview-lyne` and `.theme-lyne`.
  * All rules strictly override default/osu.css styles to ensure 0% pink bleed.
+ *
+ * No `@import` of Google Fonts here — the host supplies the faces.
+ *
+ * This file used to open with
+ *   @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono…&family=Saira+Condensed…&family=Saira…')
+ * and that line broke the desktop app. Chromium reports a stylesheet as FAILED
+ * when any of its @imports fails to load, so under a CSP whose `style-src` does
+ * not list fonts.googleapis.com (Tauri's) — or simply with no network — the CSS
+ * chunk carrying this file rejected, the dynamic import of the whole BBCode
+ * feature rejected with it, and the kernel booted without an editor.
+ *
+ * Miliastry self-hosts these families with next/font and publishes them as
+ * `--font-syne-display` / `--font-syne-body` / `--font-syne-mono` (app/layout.tsx;
+ * `[data-theme='syne']` in globals.css reads the same variables). They are
+ * used when present; the plain family names remain as the fallback for a host
+ * that installs the fonts by other means.
  */
 
-@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=Saira+Condensed:wght@600;700&family=Saira:wght@400;600&display=swap');
-
-:root {
+.theme-lyne,
+.bbcode-preview-lyne,
+[data-theme='syne'],
+[data-dialect='lyne'] {
   --color-accent: #2EE6E2;
   --color-accent-bright: #68FFF8;
   --color-warning: #FFC34D;
@@ -18,9 +35,9 @@
   --color-text-mid: #9EACD4;
   --color-text-dim: #606C8F;
   --color-hairline: rgba(255, 255, 255, 0.12);
-  --font-display: "Saira Condensed", sans-serif;
-  --font-body: "Saira", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-  --font-numeric: "IBM Plex Mono", monospace;
+  --font-display: var(--font-syne-display, "Saira Condensed"), "Saira Condensed", sans-serif;
+  --font-body: var(--font-syne-body, "Saira"), "Saira", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  --font-numeric: var(--font-syne-mono, "IBM Plex Mono"), "IBM Plex Mono", monospace;
   --lyne-cut: 8px;
 }
 
@@ -52,6 +69,41 @@
   border-bottom-color: var(--color-accent, #2EE6E2) !important;
 }
 
+.bbcode-preview-lyne a:has(img),
+.bbcode-preview-lyne a:has(.bb-img),
+.bbcode-preview-lyne a:has(svg),
+.bbcode-preview-lyne a.bb-link-img,
+.bbcode-preview.theme-lyne a:has(img),
+.bbcode-preview.theme-lyne a:has(.bb-img),
+.bbcode-preview.theme-lyne a:has(svg),
+.bbcode-preview.theme-lyne a.bb-link-img {
+  border-bottom: none !important;
+  text-decoration: none !important;
+  display: inline-block;
+  vertical-align: middle;
+}
+
+.bbcode-preview-lyne a:has(img):hover,
+.bbcode-preview-lyne a:has(.bb-img):hover,
+.bbcode-preview-lyne a:has(svg):hover,
+.bbcode-preview-lyne a.bb-link-img:hover,
+.bbcode-preview.theme-lyne a:has(img):hover,
+.bbcode-preview.theme-lyne a:has(.bb-img):hover,
+.bbcode-preview.theme-lyne a:has(svg):hover,
+.bbcode-preview.theme-lyne a.bb-link-img:hover {
+  border-bottom: none !important;
+  text-decoration: none !important;
+}
+
+.bbcode-preview-lyne a img,
+.bbcode-preview-lyne a .bb-img,
+.bbcode-preview.theme-lyne a img,
+.bbcode-preview.theme-lyne a .bb-img {
+  vertical-align: middle;
+  border: none;
+  text-decoration: none;
+}
+
 /* Forum @mentions — inherit the accent link look, slightly bolder so they
    read as handles rather than plain links. */
 .bbcode-preview-lyne a.bb-mention,
@@ -1121,3 +1173,62 @@
   background-clip: text !important;
   color: transparent !important;
 }
+
+/* ─── Lyne (SYNE) Preview Highlight Overrides ────────────────────────────── */
+
+.theme-lyne [data-bbid]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)),
+.bbcode-preview-lyne [data-bbid]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)) {
+  outline: 1.5px solid #2EE6E2 !important;
+  background-color: rgba(46, 230, 226, 0.1) !important;
+  box-shadow: 0 0 8px rgba(46, 230, 226, 0.25) !important;
+}
+
+.theme-lyne[data-hover-highlight="on"] [data-bbid]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)),
+.bbcode-preview-lyne[data-hover-highlight="on"] [data-bbid]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)),
+.theme-lyne[data-hover-highlight="on"] [data-node-id]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)),
+.bbcode-preview-lyne[data-hover-highlight="on"] [data-node-id]:hover:not(:has([data-bbid]:hover, [data-node-id]:hover)) {
+  outline: 1px dashed rgba(46, 230, 226, 0.55) !important;
+  box-shadow: 0 0 6px rgba(46, 230, 226, 0.2) !important;
+}
+
+.theme-lyne [data-node-id].cursor-highlight,
+.bbcode-preview-lyne [data-node-id].cursor-highlight,
+.theme-lyne .cursor-highlight,
+.bbcode-preview-lyne .cursor-highlight {
+  outline: 2px solid #2EE6E2 !important;
+  background-color: rgba(46, 230, 226, 0.18) !important;
+  box-shadow: 0 0 12px rgba(46, 230, 226, 0.35) !important;
+}
+
+.theme-lyne .bb-empty-line.cursor-highlight,
+.bbcode-preview-lyne .bb-empty-line.cursor-highlight {
+  background-color: rgba(46, 230, 226, 0.22) !important;
+  outline: 2px solid #2EE6E2 !important;
+  box-shadow: 0 0 8px rgba(46, 230, 226, 0.3) !important;
+}
+
+.theme-lyne[data-hover-highlight="on"] .bb-empty-line:hover,
+.bbcode-preview-lyne[data-hover-highlight="on"] .bb-empty-line:hover {
+  outline: 1px dashed rgba(46, 230, 226, 0.55) !important;
+  background-color: rgba(46, 230, 226, 0.1) !important;
+}
+
+.theme-lyne div.bb-block.cursor-highlight::after,
+.bbcode-preview-lyne div.bb-block.cursor-highlight::after {
+  box-shadow: inset 0 0 0 2px #2EE6E2, 0 0 10px rgba(46, 230, 226, 0.35) !important;
+  background-color: rgba(46, 230, 226, 0.18) !important;
+}
+
+.theme-lyne span.bb-block.cursor-highlight,
+.bbcode-preview-lyne span.bb-block.cursor-highlight {
+  outline: 2px solid #2EE6E2 !important;
+  background-color: rgba(46, 230, 226, 0.18) !important;
+  box-shadow: 0 0 8px rgba(46, 230, 226, 0.3) !important;
+}
+
+.theme-lyne ::selection,
+.bbcode-preview-lyne ::selection {
+  background-color: rgba(46, 230, 226, 0.3) !important;
+  color: #ffffff !important;
+}
+

package/src/Visuals/osu.css

@@ -33,6 +33,28 @@
   color: #94C8EA;
   border-bottom: 1px solid rgba(126,184,224,0.7);
 }
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(img),
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(.bb-img),
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(svg),
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a.bb-link-img {
+  border-bottom: none !important;
+  text-decoration: none !important;
+  display: inline-block;
+  vertical-align: middle;
+}
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(img):hover,
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(.bb-img):hover,
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a:has(svg):hover,
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a.bb-link-img:hover {
+  border-bottom: none !important;
+  text-decoration: none !important;
+}
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a img,
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) a .bb-img {
+  vertical-align: middle;
+  border: none;
+  text-decoration: none;
+}
 
 /* ─── Headings ───────────────────────────────────────── */
 
@@ -99,13 +121,22 @@
 /* ─── Spoiler ────────────────────────────────────────── */
 
 .bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) .spoiler {
-  background: #000;
-  color: #000;
-  cursor: text;
+  background: #111111;
+  color: #111111;
+  cursor: pointer;
+  padding: 0 4px;
+  border-radius: 3px;
+  user-select: text;
+  transition: background 0.15s ease, color 0.15s ease;
+}
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) .spoiler:hover,
+.bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) .spoiler:active {
+  color: #ffffff;
+  background: #333333;
 }
 .bbcode-preview:not(.bbcode-preview-lyne):not(.theme-lyne) .spoiler::selection {
-  color: #fff;
-  background: #555;
+  color: #ffffff;
+  background: #555555;
 }
 
 /* ─── Box / Spoilerbox ───────────────────────────────── */

package/src/index.ts

@@ -23,6 +23,9 @@ export type {
 
 // ── Lexer ──
 export { Lexer, type LexerOptions } from './Lexer/Lexer'
+// Which tags carry literal content. The lexer is the only authority on it;
+// exported so consumers stop keeping their own copy.
+export { BBCODE_RAW_TAGS } from './Lexer/BBCodeLexer'
 export type { Token, TokenKind, Trivia, TriviaKind } from './Types/tokens'
 
 // ── Green/Red Tree ──
@@ -33,27 +36,89 @@ export { TreeBuilder, type BuildResult } from './Syntax/TreeBuilder'
 export { NodeMatcher, type MatchResult } from './Syntax/NodeMatcher'
 
 // ── Semantic ──
-export { SemanticAnalyzer, type AnalyzeResult } from './Semantic/SemanticAnalyzer'
-export type { Diagnostic, DiagnosticSeverity, DiagnosticTag } from './Types/diagnostics'
+export { SemanticAnalyzer, type AnalyzeResult, type SemanticAnalyzerOptions, type CrossedTags, type UnknownTag } from './Semantic/SemanticAnalyzer'
+/**
+ * Whether an analysis walked the document or only the edit — see
+ * {@link AnalyzeResult.scope}.
+ *
+ * `'full'` every node was validated afresh; `'window'` only the nodes an edit
+ * could have changed were, and every other node kept the verdict it already
+ * had. The DIAGNOSTICS ARE THE SAME EITHER WAY: this says how they were
+ * arrived at, not what they are.
+ *
+ * Worth reading if you are timing the engine, deciding whether a slow frame
+ * was the analysis, or writing a test that must not silently lose the
+ * incremental path. NOT worth branching your rendering on — a consumer that
+ * treats `'window'` results as partial and merges them into what it already
+ * had will double-report, because `AnalyzeResult.diagnostics` is always the
+ * whole document's.
+ *
+ * `AnalyzeResult.window` carries the span that was re-validated on a
+ * `'window'` pass, and is `null` on a full one.
+ */
+export type { AnalyzeScope } from './Semantic/SemanticAnalyzer'
+/**
+ * `AnalyzeResult` plus the id→node index — see
+ * {@link SemanticAnalyzer.analyze}. `allNodes` is a getter that builds the
+ * index on first read, so a caller that never asks never pays for the walk.
+ */
+export type { IndexedAnalyzeResult } from './Semantic/SemanticAnalyzer'
+export type { Diagnostic, DiagnosticSeverity, DiagnosticTag, DiagnosticFix, FixOperation } from './Types/diagnostics'
 
 // ── Tag Registry ──
 export { TagRegistry, type TagDefinition, type TagHandler } from './Model/TagRegistry'
+// El texto plano de un subárbol. Se exporta porque fuera de Quasar nadie puede
+// reimplementarlo bien: `[code]` es literal y los saltos de línea son hojas
+// `spacing` sin texto propio, así que un recorrido ingenuo los pierde.
+export { extractTextContent } from './Model/TagRegistry'
 export { NodeFactory } from './Model/NodeFactory'
 
 // ── Incremental ──
 export { IncrementalParser, type EditOperation } from './Incremental/IncrementalParser'
 export { ChangeTracker, type TextChange } from './Incremental/ChangeTracker'
+/**
+ * A half-open span of the source, `[start, end)`, in the coordinates of the
+ * text whose result carries it.
+ *
+ * The same shape everywhere it appears — {@link ReparseResult.window},
+ * `AnalyzeResult.window`, `DocumentModel.lastReparseWindow` — because it
+ * always means the same thing: the part of the CURRENT text that the engine
+ * actually looked at.
+ */
+export type { SourceSpan } from './Incremental/IncrementalParser'
+/**
+ * What a reparse did, including {@link ReparseResult.window} — the span of the
+ * new text that went through the parser, or `null` after a full rebuild,
+ * where the answer is "all of it".
+ *
+ * Everything outside that span came across from the previous tree by
+ * reference, so a consumer holding per-node state (a rendered block, a
+ * measured height, a decoration) can keep it for every node the span does not
+ * touch. `DocumentModel.lastReparseWindow` is the same value for the model's
+ * last edit, which is usually the easier place to read it.
+ */
+export type { ReparseResult } from './Incremental/IncrementalParser'
+/**
+ * Why a reparse rebuilt the whole document instead of splicing a window.
+ *
+ * Useful when a document is unexpectedly slow to edit: a reason that repeats
+ * on every keystroke is a document shape the window guards will not accept —
+ * an unclosed `[` before the caret (`open-bracket-before`), a stray closing
+ * tag inside the window (`region-not-isolated`), an edit that changes what the
+ * parser leaves pending for the text after it (`pending-auto-close`).
+ */
+export type { FallbackReason } from './Incremental/IncrementalParser'
 
 // ── Diff ──
 export { TreeDiffer, type DiffOperation, type DiffKind } from './Diff/TreeDiffer'
 
 // ── Visitors ──
 export { Visitor, type VisitorContext } from './Visitors/Visitor'
-export { BBCodeExporter, MILIASTRY_ONLY_TAGS, LYNE_ONLY_TAGS, type ExportTarget } from './Visitors/BBCodeExporter'
+export { BBCodeExporter, MILIASTRY_ONLY_TAGS, LYNE_ONLY_TAGS, type ExportTarget, type BBCodeExporterOptions, type BBCodeExportOptions } from './Visitors/BBCodeExporter'
 export { BBBlocksExporter, type UIBBBlock } from './Visitors/BBBlocksExporter'
 export { HTMLRenderer, type HTMLRendererOptions } from './Visitors/HTMLRenderer'
 export { morphHTML } from './Visitors/DOMMorpher'
-export { patchBlocksInto } from './Visitors/BlockPatcher'
+export { patchBlocksInto, clearPatchCache, type PatchBlocksOptions, type PatchBlocksStats } from './Visitors/BlockPatcher'
 export { SVGRenderer } from './Visitors/SVGRenderer'
 export { MarkdownExporter } from './Visitors/MarkdownExporter'
 export { JSONExporter } from './Visitors/JSONExporter'
@@ -94,6 +159,15 @@ export { RenderTree, type RenderNode, type RenderVariant } from './RenderPipelin
 export { PluginAPI } from './Plugins/PluginAPI'
 export { PluginRegistry, type PluginManifest, type PluginContribution } from './Plugins/PluginRegistry'
 
+// ── Repair ──
+export { repairNesting, type NestingRepair, type OrphanCloser, type UnclosedOpener } from './Repair/NestingRepair'
+
+// ── Reconciler ──
+export { reconcileVisualDOMToBBCode, computeTextDelta, type SurgicalEdit as QuasarSurgicalEdit, type ReconcileResult } from './Reconciler/SurgicalReconciler'
+
+// ── BBCode Optimizer (edit plan, conflict contract, rules) ──
+export * from './Edits'
+
 // ── BBCode Bridge ──
 export { BBCodeDocumentModel } from './BBCode/BBCodeDocumentModel'
 export type { BBCodeDocumentModelOptions } from './BBCode/BBCodeDocumentModel'
@@ -139,6 +213,9 @@ export { RainbowTransformer, type RainbowOptions } from './Transformers/RainbowT
 export { GradientTransformer, type GradientOptions } from './Transformers/GradientTransformer'
 export { GrowTransformer, type GrowOptions } from './Transformers/GrowTransformer'
 
+// ── MilHibri Unified Hybrid Language ──
+export { MilHibriDocumentModel, type MilHibriDocumentModelOptions } from './MilHibri/MilHibriDocumentModel'
+
 // ── Markdown Bridge ──
 export { MarkdownDocumentModel } from './Markdown/MarkdownDocumentModel'
 export { markdownAstToGreenTree, markdownAstToRedTree } from './Markdown/MarkdownToGreenNode'
@@ -147,6 +224,61 @@ export { markdownAstToGreenTree, markdownAstToRedTree } from './Markdown/Markdow
 export { HTMLDocumentModel } from './HTML/HTMLDocumentModel'
 export { htmlStringToGreenTree } from './HTML/HTMLToGreenNode'
 
+// ── Colour Maths ──
+// Perceptual colour utilities. Previously reachable only through the `./src/*`
+// subpath, which resolves against source rather than `dist` and so breaks for
+// any consumer of the built package.
+export {
+  ease,
+  solveCubicBezierY,
+  hslToHex,
+  hexToRgb,
+  hexToHsl,
+  hexToOklab,
+  mixHex,
+  mixHexOklab,
+  mixMultiple,
+  mixMultipleStops,
+  perceptualDistance,
+} from './Utils/ColorMath'
+export type { Easing, ColorStop } from './Utils/ColorMath'
+export { isHexColor } from './Utils/ColorMath'
+
+// ── Effect math: the kernel shared by the tag handlers, the HTML
+// renderer and @miliastry/quasar-studio. ──
+export {
+  hashSeed, randAt, valueNoise, fbm,
+  validateExpression, compileExpression, EXPRESSION_VARS,
+  waveform, WAVE_KINDS, DEFAULT_WAVE_OPTIONS, clamp01,
+  blendHex, BLEND_MODES, rgbToHex, adjustHsl, posterizeHex, clampRange,
+  buildSampleTable, buildRangeScope, documentScope, axisValue, expressionVars, AXES,
+  effectiveAxis, mergeStyledSegments, normalizeHex,
+  parseColorStops, stringifyColorStops, parseEffectParams, stringifyEffectParams,
+  EFFECT_PARAM_KEYS, EFFECT_UNITS,
+  evaluateEffect, GRADIENT_DEFAULTS, RAINBOW_DEFAULTS, GROW_DEFAULTS, NEUTRAL_SIZE,
+  PAINT_DEFAULTS, SPATIAL_DEFAULTS,
+  // ── Placeable geometry, masks and paint grids ──
+  SPATIAL_AXES, DEFAULT_CELL_ASPECT, DEFAULT_SPATIAL, spatialPoint,
+  MASK_SHAPES, DEFAULT_MASK, maskValue, maskDistance,
+  spatialFromParams, maskFromParams, gridFromParams,
+  PAINT_MAX_COLORS, parsePaintGrid, samplePaintGrid,
+  stringifyPaintCells, stringifyPaintPalette,
+} from './Utils/EffectMath'
+export type {
+  WaveKind, WaveOptions, BlendMode, ExpressionVars, CompiledExpression,
+  CharSample, SampleTable, RangeScope, SampleContext, Axis,
+  EffectParams, EffectUnit, EffectKind, EffectSpan, StyledSegment,
+  SpatialOptions, SpatialPoint, MaskShape, MaskOptions, PaintGrid,
+} from './Utils/EffectMath'
+
+// ── Tag Vocabulary ──
+export {
+  attributeVocabularyFor, allAttributeVocabularies,
+  EFFECT_TYPES, ANIM_TYPES, CONTAINER_TYPES,
+  SEPARATOR_VARIANTS, TABLE_FLAGS, IMG_MODIFIERS,
+} from './Utils/TagVocabulary'
+export type { AttributeVocabulary, VocabularySyntax } from './Utils/TagVocabulary'
+
 // ── Analysis Framework ──
 export {
   Pipeline,
@@ -157,15 +289,21 @@ export {
   CharacterCountAnalyzer,
   MergeableColorAnalyzer,
   GradientAnalyzer,
+  findCollapsibleGradients,
+  formatGradientTag,
   RainbowAnalyzer,
   WaveAnalyzer,
+  SymbolAnalyzer,
+  ColorUsageAnalyzer,
   DefaultDecision,
+  PaletteRemapDecision,
   CollapseGradientTransform,
   RainbowCollapseTransform,
   WaveCollapseTransform,
   MergeColorsTransform,
 } from './Analysis/index'
 export type {
+  CollapsibleGradient,
   Pass,
   AnalyzerPass,
   DecisionPass,
@@ -187,11 +325,40 @@ export type {
   RainbowDiagnostics,
   WaveModel,
   WaveDiagnostics,
+  SymbolGlyph,
+  SymbolRunModel,
+  ColorUsageModel,
+  Palette,
+  PaletteRemapOptions,
+  RemapAction,
 } from './Analysis/index'
 
 // NOTE: `ExportTarget` from Analysis is intentionally omitted to avoid
 // naming collision with the existing `ExportTarget` from Visitors/BBCodeExporter.
 // Consumers who need the Analysis export target can import directly:
-// `import { ExportTarget } from '@miliastry/quasar/Analysis/Contracts/PipelineContext'`
+// `import { ExportTarget } from '@miliastry/quasar/src/Analysis/Contracts/PipelineContext'`
+// The `src/` segment is not optional: `./src/*` is the subpath the exports map
+// actually publishes, and the deep specifier without it resolves to nothing.
 
+// Semántica de atributos de etiqueta, compartida con quien pinte BBCode
+// fuera del HTMLRenderer (los presets del lienzo, por ejemplo).
+export {
+  nodeAttrValue,
+  parseImgAttr,
+  sanitizeColor,
+  sanitizeFontSize,
+  sanitizeFontFamily,
+} from './Syntax/nodeAttr'
+export type { ImgAttr } from './Syntax/nodeAttr'
+
+// ── Design Tokens ──
+export {
+  toTokenResolver,
+  resolveTokenValue,
+} from './Tokens/index'
+export type {
+  DocumentTokens,
+  TokenResolverFn,
+  TokenSource,
+} from './Tokens/index'