refrakt.md

Docs Runes Plan Blog Changelog

Changelog

0.9.5

  • Fix sidenote rune rendering empty due to minimal density hiding body
  • Fix juxtapose label rendering and restyle toggle buttons
  • Unwrap runes from paragraph wrappers in juxtapose panels
  • Fix diagram surface and style mermaid diagrams with Lumina tokens
  • Fix mediatext wrap mode ignoring ratio attribute
  • Fix budget estimate indicator and improve examples
  • Fix sandbox dark mode on mobile browsers
  • Improve SEO and AI discoverability
    • Fix annotate rune: margin notes invisible, inline notes not inline

0.9.4

  • Fix Vite dev server warnings: deprecated svelte:component, dynamic imports, void elements
  • Fix gallery responsive behavior: reset margin, columns, and gap at breakpoints
  • Fix pipeline hooks: unwrap LoadedPackage to RunePackage for community packages
  • Fix Astro adapter: manifest JSON import, layouts compilation, sandbox rendering
  • Add syntax highlighting to Astro template
  • Derive Astro theme from config instead of hardcoding lumina
  • Remove table/pre element overrides in favor of Markdoc node schemas
  • Fix runes broken by table/codeblock wrapper divs
  • Improve form rune styling: surface background, full width, inline alignment
  • Fix figure rune image extraction
  • Align mark.svg dark mode color with Lumina palette
  • Add SVG favicon using existing mark.svg logo

0.9.3

  • Bug fixes, rune restyling, and new features since v0.9.2.
  • Add createRefraktLoader and virtual:refrakt/content to eliminate content loading boilerplate
  • Add --css flag to plan build/serve for custom style overrides
  • Fix content HMR with dev-mode cache bypass (createSiteLoader)
  • Fix create-refrakt: interactive mode, CSS imports, community package loading
  • Fix density CSS leaking into nested runes with different density
  • Fix empty aggregation rune showcases on site
  • Fix missing bottom margin on code fences in prose
  • Fix preview source panel horizontal scroll on mobile
  • Fix hint header margin and vertical spacing
  • Fix testimonial star rating and author name/role styling
  • Fix details and diff rune styling issues
  • Fix blockquote quote mark overlap
  • Fix chart rune default figure margin
  • Fix diff split mode on mobile with horizontal scroll
  • Fix codegroup title font size and tab readability
  • Fix compact density title size
  • Fix build order and implicit any types in nuxt module
  • Add missing exports fields for NodeNext module resolution
  • Restyle API, bond, budget, details, event runes with metadata dimension system
  • Unify design rune styling with consistent titles and surfaces
  • Update Lumina default palette: cerulean, frosted blue, warm parchment
  • Thin table header border, cleaner table look with better mobile column sizing
  • Use logo apricot for syntax keywords
  • Document Svelte component override props and snippet pattern
  • Update Astro adapter docs for component override support
  • Audit and fix site documentation gaps
  • Redesign milestone progress indicator as two-row layout

0.9.2

  • Add multi-framework adapter packages (Astro, Eleventy, Next.js, Nuxt, React, Vue) with ADR-008 framework-native component interfaces. Implement ADR-009 framework-agnostic theme architecture. Add vue, astro, and jinja to Shiki default languages.

0.9.1

  • Named slots with ordering for structured element placement
  • Repeated element generation for multi-instance structures
  • Element projection (hide, group, relocate) for layout control
  • Value mapping and configurable density contexts
  • Migrate postTransform uses to declarative config
  • Replace legacy Model class with createContentModelSchema across all runes (WORK-099–102)
  • Replace useSchema/Type system with inline rune identifiers (ADR-005)
  • Remove legacy Model class, decorators, createSchema, and NodeStream
  • File-derived timestamps for runes (SPEC-029)
  • Move extract command from CLI to @refrakt-md/docs package
  • Fix accordion item schema metadata duplication
  • Fix paragraph-wrapped images in juxtapose panels
  • Auto-assign IDs and detect duplicates in plan CLI
  • Inspect and contracts updated for structure slots

0.9.0

  • Metadata dimensions system: density, section anatomy, media slots, checklist, sequential items, and interactive state dimensions added to rune configs and identity transform engine
  • Universal dimension CSS in Lumina theme with generic metadata styling
  • Shared split layout CSS with two-mode mobile collapse for marketing and storytelling runes
  • Rune output standardization: recipe, howto, playlist, character, realm, and faction runes refactored to consistent 3-section structure
  • @refrakt-md/plan community rune package for project planning with spec, work, bug, decision, and milestone runes
  • Markdoc partials support with LSP and VS Code integration
  • xref rune for inline cross-referencing via entity registry
  • Sandbox directory source support for multi-file sandboxes
  • labelHidden option to hide self-explanatory metadata labels
  • Rename intro header to preamble to disambiguate from chrome header
  • Lumina design refresh: soft gray page background, borderless surfaces, bordered pill badges, transparent banners
  • --audit-dimensions and --audit-meta flags for refrakt inspect CLI
  • Fix tint-mode CSS stripped in production builds
  • Fix preview rune light mode toggle when OS is in dark mode
  • Fix sandbox ignoring tint-mode by reading data-color-scheme attribute
  • Fix overflow:hidden on media zones clipping preview bleed
  • Fix Feature config: sections/mediaSlots key should be 'media' not 'image'
  • Fix docs layout 3-track grid leaking into rune articles
  • Fix media/scene positioning in storytelling runes
  • Fix missing dimensions CSS in production build
  • Fix storytelling pipeline TypeScript narrowing errors
  • Fix theme CSS resolution to load full theme instead of tokens only
  • Many Lumina CSS refinements: recipe cover ratio, CTA alignment, hero centering, testimonial borders, blog post hover shadows

0.8.5

  • Add blog rune for listing posts with filtering and sorting. Expose frontmatter and page data as content-level Markdoc variables. Redesign juxtapose rune with --- delimiter and overlay labels. Auto-discover runes in VS Code extension and editor. Fix map rune collapsed border and add spacing support. Fix juxtapose tint mode.

0.8.4

  • Fix scaffolded sites not loading community packages or applying identity transform. Fix preview rune code toggle broken by data-field/data-name mismatch. Add smarter heading-level detection in sections content model for preamble support. Restore ordered-list-based steps authoring pattern.

0.8.3

  • Add draggable popover and clickable prose blocks
  • Redesign prose editor with popover tabs and hover inline editing
  • Group consecutive prose elements into editable prose blocks
  • Fix Content tab cursor reset on Enter/Backspace in prose editor
  • Fix prose sections not rendering in block editor
  • Add editor compatibility to all rune packages: core, marketing, docs, learning, business, places, storytelling, design, and media runes
  • Redesign recipe, steps, howto, tabs, preview, pullquote, event, organization, and plot runes
  • Polish playlist, track, audio, and storytelling runes
  • Add scene images and split layouts to storytelling runes (realm, faction)
  • Fix cast rune layout, budget rune currency, dark mode text in preview
  • Add TabPanel engine config entry with BEM class
  • Sync language server and VS Code extension with current runes
  • Polish datatable rune and unify table wrapper class

0.8.2

  • Bug fixes and editor improvements including CodeMirror code editing, mobile search fix, structure tab enhancements, and block editor UI refinements.

0.8.1

  • Add @refrakt-md/html pure HTML renderer, content-model-driven Structure tab in editor, inline editing popovers, accessible tab structure for tabs/codegroup, feature rune redesign with granular field editing, and editor hover tooltips with edit hint controls.

0.8.0

  • Declarative content model: migrated 50+ runes from imperative Model classes to createContentModelSchema
  • Cross-page pipeline: EntityRegistry, breadcrumb auto-resolution, aggregated data
  • New media runes: playlist, track, audio with full schema.org RDFa annotations
  • Section header BEM classes with pill-badge eyebrow styling
  • Automatic RunePackage version sync on release
  • Production CSS tree-shaking: kebab→PascalCase key mismatch
  • Audio player: idempotency guard, playlist interaction, autoplay race condition
  • Editor serializing numerical attributes as strings
  • Metadata hiding in rune CSS breaking nested runes
  • Showcase centering and place attribute in split layout
  • Type safety: replace string booleans with proper boolean types
  • style attribute renamed to variant across all runes
  • typeof/property renamed to data-rune/data-field across the pipeline

0.7.2

  • Add cross-page pipeline infrastructure with EntityRegistry, runPipeline(), and PackagePipelineHooks. Includes nav auto mode, pipeline build output, design token context propagation, and editor preview/autocomplete support for community runes.
  • Fix duplicate BEM classes on runes nested inside data-name elements. Make autoLabel recursive in the identity transform engine so eyebrow, headline, and blurb children inside <header> wrappers receive BEM classes. Add pageSectionAutoLabel to all marketing and core page-section runes.
  • Add pill-badge eyebrow variant: an eyebrow paragraph containing a link renders as a rounded pill with a border, muted prose text, and primary-colored link. The entire pill is clickable via a CSS ::before overlay.
  • Add mockup rune to @refrakt-md/design for wrapping content in device frames.
  • Fix multiple preview runtime issues: structuredClone errors, DataCloneError when sending routeRules via postMessage, and cache not invalidating on source changes. Remove ComponentType and PropertyNodes from the schema system.

0.7.1

  • Fix production builds excluding CSS for runes from @refrakt-md/* rune packages. The CSS tree-shaker now uses the assembled config (core + package runes) instead of only the core theme config when determining which rune CSS files to include.

0.7.0

  • Introduce 8 official @refrakt-md/* rune packages: marketing, docs, storytelling, places, business, design, learning, and media. 33 runes migrated from core @refrakt-md/runes into domain-specific installable packages. Rune schema interfaces moved from @refrakt-md/types to owning packages. Added package tooling (validate command, fixture discovery, AI prompt extensions). Site docs reorganized to reflect official rune packages.

0.6.0

  • WYSIWYG block editor with stacked previews, Shadow DOM isolation, and rail navigation
  • Three-mode editor toggle: Visual, Code, and Preview with unified header bar
  • Category-based sidenav that groups content by route rules from refrakt.config.json
  • Positioned popovers for page/folder/category creation near trigger buttons
  • Rune palette with attribute autocomplete and Markdoc tag highlighting
  • Layout editor with visual navigation editing
  • Frontmatter editor with raw YAML mode
  • Live Svelte preview runtime with full-fidelity layout rendering
  • File watching via SSE for external editor coexistence
  • Responsive viewport selector (desktop/tablet/mobile)
  • Preview link navigation — clicking links in preview navigates the editor
  • Client-side syntax highlighting via Shiki
  • File operations: create, rename, duplicate, delete, toggle draft
  • Migrated Diagram, Sandbox, Map, and Comparison runes from Svelte components to framework-neutral web components
  • Added postTransform hooks to identity transform engine for component-free interactive runes
  • Python symbol extraction pipeline (refrakt extract)
  • Theme distribution: complete export package with CLI install command
  • Icon rune system with Lucide icon set and per-project custom icons via refrakt.config.json
  • AI-powered theme generation with design expression prompts
  • Per-rune CSS override editor with CodeMirror
  • Undo/redo history with keyboard shortcuts
  • Fixture picker with configurable rune previews and coverage indicator
  • Visual design token editors
  • Export panel with CSS preview, copy, and ZIP download
  • localStorage persistence
  • Layout transform engine for computed content in layouts
  • Semantic rune usage throughout documentation
  • Dedicated CLI documentation section

v0.5.1

  • Fix scaffolded dependency versions to derive from package version at runtime instead of hardcoding. Previously, the template hardcoded ^0.4.0 which with 0.x semver resolved to <0.5.0, causing newly scaffolded sites to install incompatible older packages. Also fixes invalid rune attribute usage in the kitchen sink template.

0.5.0

  • refrakt scaffold --theme generates a complete custom theme with layout, CSS tokens, manifest, test infrastructure, and kitchen sink content
  • refrakt inspect command for theme developers — rune coverage audit, CSS audit, structure contracts
  • refrakt inspect --contracts generates HTML structure contracts (structures.json) for all 74 runes
  • Theme scaffold produces full SvelteTheme runtime integration (manifest, layouts, components, elements)
  • CSS entry points: base.css (tokens-only), svelte/tokens.css (dev bridge), styles/runes/*.css (tree-shakable)
  • @refrakt-md/behaviors — vanilla JS progressive enhancement via data-rune attributes
  • Tabs, accordion/reveal, datatable, form, copy-to-clipboard, and preview behaviors
  • Framework-agnostic: works with any renderer, no Svelte dependency
  • @refrakt-md/theme-base — extracted universal rune config, interactive components, and structural CSS
  • 74 rune configurations in identity transform engine
  • Enables multi-theme support with shared component registry
  • Moved 8+ Svelte components to pure CSS/identity transform + behaviors
  • styles, staticModifiers, postTransform engine capabilities
  • Context-aware BEM modifiers
  • Design runes (palette, typography, spacing) moved to identity layer
  • Blockquote as CSS-only implementation
  • Migrated all components to --rf-* prefixed tokens (removed aliases.css)
  • symbol — code construct documentation (functions, classes, interfaces)
  • preview — component showcase with theme toggle, code/preview tabs, responsive viewports
  • sandbox — live HTML playground with iframe isolation
  • map — interactive location visualizations
  • design-context — token extraction and sandbox injection
  • Standalone design runes: swatch, palette, typography, spacing
  • Three-tab source panel (Markdoc, Rune, HTML)
  • Auto-inferred source mode
  • Responsive bleed with container queries
  • Theme toggle with dark mode support
  • Language server with completion, hover, and diagnostics
  • Rune Inspector tree view
  • Sandbox and preview snippets
  • Bundled for distribution
  • Build-time CSS tree-shaking via content analysis
  • Configurable Shiki syntax highlight themes
  • Form field HTML generation moved into rune schemas
  • Multi-file generation in refrakt write
  • Gemini Flash provider as free cloud AI option
  • Improved CLI feedback and scaffolding versions
  • Mobile navigation for Lumina theme (hamburger toggle, scroll lock, breadcrumbs)
  • Blog layout with post listing and index page
  • Layout CSS extracted from Svelte components into standalone files
  • Fix preview content leaking between pages on navigation
  • Fix codegroup title placement and pre border
  • Fix tab list decoration dots and duplicate copy button
  • Fix form fields rendering empty
  • Fix map rune streaming init and geocoding fallback
  • Fix timeline dots, lines, and title display
  • Fix duplicate step numbers in Steps rune
  • Fix feature rune dt/dd bug and split/mirror API
  • Fix mobile nav hidden links and panel positioning
  • Fix TS2307 on Cloudflare with dynamic import

0.4.0

  • @refrakt-md/highlight — Shiki-based syntax highlighting with Markdoc grammar support, CSS variables integration, and copy-to-clipboard
  • @refrakt-md/transform — Identity transform engine extracted into its own package (BEM classes, structural injection, meta consumption)
  • form — Form component with field validation
  • comparison — Comparison matrices and tables
  • storyboard — Story visualization
  • reveal — Progressive disclosure
  • conversation — Chat-style content
  • bento — Grid layout component
  • annotate — Annotated content
  • Merged @refrakt-md/theme-lumina into @refrakt-md/lumina/svelte as a subpath export
  • SvelteKit plugin now derives theme adapter dynamically from config.theme + config.target
  • Theme packages now serve framework adapters via subpath exports — no separate packages per framework
  • Replaced Editor rune with dedicated CodeGroup component for multi-file code blocks
  • Added Recipe, HowTo, Event, Person, Organization, and Dataset schema.org extractors
  • Unified actions pattern across Hero and CTA runes
  • Blog layout added to Lumina theme
  • Copy-to-clipboard for code blocks
  • Test coverage expanded from ~299 to 370 tests

0.3.0

  • New runes and bug fixes
  • recipe — Ingredients, steps, chef's tips with prep/cook time metadata howto — Step-by-step instructions with tools/materials list event — Event info with date, location, registration URL cast (alias: team) — People directory with name/role parsing organization (alias: business) — Structured business information
  • datatable (alias: data-table) — Interactive table with sortable/searchable attributes api (alias: endpoint) — API endpoint documentation with method badges diff — Side-by-side or unified diff between two code blocks 0chart — Bar/line/pie/area charts from Markdown tables diagram — Mermaid.js diagram rendering
  • Other: sidenote (aliases: footnote, marginnote) — Margin notes, footnotes, and tooltips

0.2.0

  • Added SEO layer