Name:v1.0.0Status:active

v1.0.0 — Editor Integration & Package Ecosystem

Milestone burndown: 15 open work items remaining; peak 31, started Mar 2407142128Mar 24Apr 29
Open work items Ideal burndown
Progress 1/16 work items
History 1
  1. 2637549
    Created (active)by Björn Andersson
    chore(plan): create v1.0.0 milestone, complete v0.9.0, fix acceptance cr
  • Editor package awareness and registry autocomplete
  • Community package pipeline hooks (learning)
  • CSS fallback resolution for community packages
  • Pipeline incremental builds
  • Create-Refrakt project type defaults
  • Framework adapters: Astro, Nuxt, Next.js, Eleventy (SPEC-030)
  • Shared utility extraction from @refrakt-md/svelte (SPEC-030 Phase 0)
  • Create-Refrakt multi-framework scaffolding with interactive mode
  • Plan CLI resolution parsing and display
  • Structure slots and declarative flexibility (SPEC-033): value mapping, density contexts, named slots, repeated elements, element projection

Work Items

Ready 13
WORK-052 main
Create-Refrakt Project Type Defaults
medium simple
0/6 criteria
WORK-053 main
CSS Fallback Resolution for Third-Party Packages
medium moderate
0/6 criteria
WORK-055 main
Learning Package Pipeline Hooks
high complex
0/11 criteria
WORK-056 main
Editor Background Entity Registry
medium complex
0/10 criteria
WORK-057 main
Editor Registry-Powered Autocomplete
medium moderate
0/7 criteria
WORK-058 main
Pipeline Incremental Build Optimization
low complex
0/9 criteria
WORK-094 main
Create @refrakt-md/vite plugin — Level 1 static transform
Build the core Vite plugin that intercepts .md files and emits JS modules with rendered HTML, frontmatter, SEO data, and serialized tree. This is the Level 1 (static, per-file) integration — no cross-page awareness.
high moderate
0/13 criteria
WORK-095 main
Vite plugin — virtual CSS module and tree-shaking
Implement virtual:refrakt/styles module that imports theme tokens, per-rune CSS, and package CSS. Supports tree-shaking to include only CSS for runes actually used in content.
high simple
0/9 criteria
WORK-096 main
Vite plugin — dev server HMR
Implement hot module replacement for .md file changes during development. When a markdown file is saved, re-transform it and trigger a page update.
medium simple
0/6 criteria
WORK-097 main
Vite plugin — Level 2 cross-page pipeline
Implement the level: 'pipeline' mode that runs the full four-phase cross-page pipeline at build time, enabling breadcrumbs, nav, glossary auto-linking, and other entity-dependent features.
medium moderate
0/11 criteria
WORK-098 main
Vite plugin — behavior init helper export
Export a thin initBehaviors() wrapper from @refrakt-md/vite/behaviors that frameworks can call after navigation to re-initialize interactive rune behaviors (accordion, tabs, datatable, etc.).
low trivial
0/6 criteria
WORK-115 main
Migrate community package postTransform uses to declarative config
With WORK-110 through WORK-114 complete, convert the 5 postTransform uses identified in SPEC-033 to their declarative equivalents. Validate identical HTML output before and after each migration.
medium moderate
0/7 criteria
WORK-116 main
Update inspect and contracts tooling for structure slots features
Update refrakt inspect and refrakt contracts to surface the new SPEC-033 features: slot assignments, projection effects, and repeated elements.
medium moderate
0/7 criteria
In Progress 2
WORK-051 main
Editor Package Awareness
high complex
3/8 criteria
WORK-089 main
Create @refrakt-md/astro adapter package
Build the Astro framework adapter — the first non-SvelteKit target. Astro is MPA-first and SSG-focused, making it the simplest adapter to build and validate.
high moderate
11/12 criteria
Done 1
WORK-126 main
Parse Resolution sections in the plan scanner
Extend the plan scanner to extract ## Resolution sections from work item and bug files into a structured resolution field on PlanEntity.
high moderate
0/8 criteria