refrakt-md 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.vscodeignore ADDED
@@ -0,0 +1,9 @@
1
+ **/*
2
+ !dist/extension.js
3
+ !dist/server.js
4
+ !syntaxes/**
5
+ !snippets/**
6
+ !language-configuration.json
7
+ !package.json
8
+ !README.md
9
+ !LICENSE
package/CHANGELOG.md ADDED
@@ -0,0 +1,88 @@
1
+ # refrakt-md
2
+
3
+ ## 0.5.0
4
+
5
+ ### Minor Changes
6
+
7
+ - ### Theme Development Toolkit
8
+
9
+ - **`refrakt scaffold --theme`** generates a complete custom theme with layout, CSS tokens, manifest, test infrastructure, and kitchen sink content
10
+ - **`refrakt inspect`** command for theme developers — rune coverage audit, CSS audit, structure contracts
11
+ - **`refrakt inspect --contracts`** generates HTML structure contracts (`structures.json`) for all 74 runes
12
+ - Theme scaffold produces full `SvelteTheme` runtime integration (manifest, layouts, components, elements)
13
+ - CSS entry points: `base.css` (tokens-only), `svelte/tokens.css` (dev bridge), `styles/runes/*.css` (tree-shakable)
14
+
15
+ ### Behaviors Library
16
+
17
+ - **`@refrakt-md/behaviors`** — vanilla JS progressive enhancement via `data-rune` attributes
18
+ - Tabs, accordion/reveal, datatable, form, copy-to-clipboard, and preview behaviors
19
+ - Framework-agnostic: works with any renderer, no Svelte dependency
20
+
21
+ ### Theme Base Package
22
+
23
+ - **`@refrakt-md/theme-base`** — extracted universal rune config, interactive components, and structural CSS
24
+ - 74 rune configurations in identity transform engine
25
+ - Enables multi-theme support with shared component registry
26
+
27
+ ### Identity Transform Expansion
28
+
29
+ - Moved 8+ Svelte components to pure CSS/identity transform + behaviors
30
+ - `styles`, `staticModifiers`, `postTransform` engine capabilities
31
+ - Context-aware BEM modifiers
32
+ - Design runes (palette, typography, spacing) moved to identity layer
33
+ - Blockquote as CSS-only implementation
34
+ - Migrated all components to `--rf-*` prefixed tokens (removed `aliases.css`)
35
+
36
+ ### New Runes
37
+
38
+ - **`symbol`** — code construct documentation (functions, classes, interfaces)
39
+ - **`preview`** — component showcase with theme toggle, code/preview tabs, responsive viewports
40
+ - **`sandbox`** — live HTML playground with iframe isolation
41
+ - **`map`** — interactive location visualizations
42
+ - **`design-context`** — token extraction and sandbox injection
43
+ - Standalone design runes: swatch, palette, typography, spacing
44
+
45
+ ### Preview Rune Enhancements
46
+
47
+ - Three-tab source panel (Markdoc, Rune, HTML)
48
+ - Auto-inferred source mode
49
+ - Responsive bleed with container queries
50
+ - Theme toggle with dark mode support
51
+
52
+ ### VS Code Extension
53
+
54
+ - Language server with completion, hover, and diagnostics
55
+ - Rune Inspector tree view
56
+ - Sandbox and preview snippets
57
+ - Bundled for distribution
58
+
59
+ ### Build & Performance
60
+
61
+ - Build-time CSS tree-shaking via content analysis
62
+ - Configurable Shiki syntax highlight themes
63
+ - Form field HTML generation moved into rune schemas
64
+
65
+ ### CLI Enhancements
66
+
67
+ - Multi-file generation in `refrakt write`
68
+ - Gemini Flash provider as free cloud AI option
69
+ - Improved CLI feedback and scaffolding versions
70
+
71
+ ### Mobile & Layout
72
+
73
+ - Mobile navigation for Lumina theme (hamburger toggle, scroll lock, breadcrumbs)
74
+ - Blog layout with post listing and index page
75
+ - Layout CSS extracted from Svelte components into standalone files
76
+
77
+ ### Bug Fixes
78
+
79
+ - Fix preview content leaking between pages on navigation
80
+ - Fix codegroup title placement and pre border
81
+ - Fix tab list decoration dots and duplicate copy button
82
+ - Fix form fields rendering empty
83
+ - Fix map rune streaming init and geocoding fallback
84
+ - Fix timeline dots, lines, and title display
85
+ - Fix duplicate step numbers in Steps rune
86
+ - Fix feature rune dt/dd bug and split/mirror API
87
+ - Fix mobile nav hidden links and panel positioning
88
+ - Fix TS2307 on Cloudflare with dynamic import
package/README.md ADDED
@@ -0,0 +1,41 @@
1
+ # refrakt.md for VS Code
2
+
3
+ Syntax highlighting, snippets, and editor support for [refrakt.md](https://github.com/refrakt-md/refrakt) content authoring with Markdoc runes.
4
+
5
+ ## Features
6
+
7
+ ### Syntax Highlighting
8
+
9
+ Rune tags (`{% hint %}`, `{% /hint %}`) are highlighted within Markdown files with distinct colors for:
10
+
11
+ - Tag delimiters (`{%`, `%}`)
12
+ - Rune names (`hint`, `hero`, `pricing`)
13
+ - Attribute names and values (`type="warning"`, `columns=3`)
14
+ - Boolean and numeric literals
15
+
16
+ ### Snippets
17
+
18
+ Type `rune:` to see all available rune snippets. Each snippet expands with smart tabstops and attribute choices:
19
+
20
+ - `rune:hint` -- callout with type selector (note, warning, caution, check)
21
+ - `rune:hero` -- hero section with headline and CTA
22
+ - `rune:tabs` -- tabbed interface with heading-based tabs
23
+ - `rune:pricing` -- pricing table with tier structure
24
+ - `rune:recipe` -- recipe with prep time, cook time, and servings
25
+ - `rune:api` -- API endpoint with method, path, and parameter table
26
+ - ...and 40+ more for every rune in the library
27
+
28
+ Also includes `frontmatter` and `frontmatter:blog` snippets for YAML front matter.
29
+
30
+ ### Bracket Matching & Folding
31
+
32
+ - `{% tag %}` and `{% /tag %}` are matched as bracket pairs
33
+ - Rune blocks can be folded using the gutter fold icons
34
+
35
+ ## Requirements
36
+
37
+ No dependencies. This extension is purely declarative (TextMate grammar + snippets).
38
+
39
+ ## Extension Settings
40
+
41
+ No configuration required. The extension activates automatically for all Markdown files.