WORK-088
ID:WORK-088Status:done

Extract shared utilities from @refrakt-md/svelte to @refrakt-md/transform

Prerequisite for all framework adapters. Two modules in @refrakt-md/svelte are framework-agnostic and needed by every adapter package.

Priority:highComplexity:simpleMilestone:v1.0.0Source:ADR-001,ADR-002,SPEC-030
main View source

Criteria completion

Criteria completion: 1 of 7 (14%) checked; history from Apr 1 to Apr 20%25%50%75%100%Apr 1Apr 2

Relationships

Implements 3
Related 5
Branches 3
main current done
claude/file-naming-convention-LJdwR donechangeset-release/main doneclaude/align-sidenav-styling-4MuxV done
History 5
  1. e900a90
    Created (done)by bjornolofandersson
  2. f262d7b
    Content editedby Claude
  3. e5a255f
    • ☑ Build succeeds in dependency order (types → transform → svelte)
    by Claude
  4. 11e81a8
    Content editedby Claude
  5. ead9531
    Created (ready)by Claude
    Add work items WORK-088 through WORK-092 for framework adapter system

Acceptance Criteria

  • serialize() and serializeTree() moved to packages/transform/src/serialize.ts
  • matchRouteRule() moved to packages/transform/src/route-rules.ts
  • Both are exported from @refrakt-md/transform public API (packages/transform/src/index.ts)
  • @refrakt-md/svelte re-exports both modules — no breaking change for existing consumers
  • @refrakt-md/transform adds @markdoc/markdoc as a dependency (needed by serialize())
  • All existing tests pass without modification
  • Build succeeds in dependency order (types → transform → svelte)

Approach

  1. Copy packages/svelte/src/serialize.ts → packages/transform/src/serialize.ts
  2. Copy packages/svelte/src/route-rules.ts → packages/transform/src/route-rules.ts
  3. Update imports in both files if needed (type imports should already point at @refrakt-md/types)
  4. Export from packages/transform/src/index.ts
  5. Replace original files in packages/svelte/src/ with re-exports from @refrakt-md/transform
  6. Update any internal imports within packages/svelte/ that reference these modules directly

References

  • SPEC-030 (Phase 0)
  • ADR-001, ADR-002 (both identify this as a shared prerequisite)

Resolution

Completed: 2026-04-02

Branch: claude/implement-spec-030-F0LFn

What was done

  • Moved serialize() and serializeTree() from packages/svelte/src/serialize.ts to packages/transform/src/serialize.ts
  • matchRouteRule() was already in packages/transform/src/route-rules.ts (previously extracted)
  • Added @markdoc/markdoc as dependency to @refrakt-md/transform
  • Exported both serialize and serializeTree from transform's public API
  • Updated @refrakt-md/svelte serialize.ts to re-export from transform
  • All 167 test files (1877 tests) pass, build succeeds

Notes

  • Route rules extraction was already done in a prior session — only serialize needed moving