Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,12 @@ okf_version: '0.2'
- [Project README](../README.md) β€” product overview, API preview, implementation order, and local setup.
- [Project brief](planning/project-brief.md) β€” product outcome, scope, non-goals, and success criteria.
- [Canonical roadmap](roadmap/roadmap.md) β€” implementation sequence, issue-sized milestones, dependencies, and exit gates.
- [Merged v0 runtime and bake API](planning/api-shapes.md) β€” migration fixture for the implemented, unreleased package boundaries and explicitly deferred additions.
- [Merged v0 runtime and bake API](planning/api-shapes.md) β€” superseded migration fixture; it describes the merged v0 surface that the Rust render-plan cutover deleted.
- [Three.js text API](planning/three-api.md) β€” authoritative Three-native loader, explicit `TextGroup` batching, reusable text across group disposal, retained non-throwing errors, ordering, and lifecycle contract.
- [Core text API](planning/core-api.md) β€” authoritative API for ordered font stacks, batch-owned paragraph handles, identity-preserving capacity changes, fixed-capacity failure, synchronized updates, and renderer-ready glyph batches.
- [Engine integration contract](planning/engine-integration-contract.md) β€” exact storage, batching, submission, ownership, staging, and frame-publication boundary for custom renderers.
- [Raster technique and engine resource API](planning/raster-technique-api.md) β€” portable artifact loading, CPU raster data, glyph-resource binding, reusable shader-backend programs, and engine target ownership.
- [Rust layout engine contract](planning/rust-layout-engine.md) β€” authoritative engine ABI, render-plan policy, and publication boundary for custom renderers.
- [Engine integration contract](planning/engine-integration-contract.md) β€” superseded historical record; the Rust command buffer replaced this storage and batching contract.
- [Raster technique and engine resource API](planning/raster-technique-api.md) β€” superseded historical record; the Rust render-plan cutover replaced these TypeScript binding and packing interfaces.
- [TypeGPU-first shader authority](planning/typegpu-first-shader-authority.md) β€” exploratory TypeGPU-first shader/program architecture, Three and gpucat bridge limits, fallback authority models, and proof gates.
- [Merged v0 raster and baker plugin guide](planning/raster-baker-plugin.md) β€” build against the implemented combined runtime/renderer module before the target v1 extraction replaces it.
- [External gpucat integration fitness plan](planning/gpucat-integration.md) β€” source-validated proof plan for consuming the target v1 core without private imports or core changes.
Expand Down
8 changes: 4 additions & 4 deletions docs/planning/api-shapes.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,13 +40,13 @@ generated:

# Merged v0 runtime and bake API fixture

Status: merged v0 surfaces are implemented but unreleased; sections labeled deferred remain proposals
Status: superseded; the merged v0 surface described here was deleted by the Rust render-plan cutover
Scope: baked-first loading, lazy Worker baking, HarfRust Wasm shaping, JavaScript paragraph layout, and explicit raster loading

> [!NOTE]
> This page is retained for migration and regression comparison. The root [README](../../README.md),
> [core text API](core-api.md), and [engine integration contract](engine-integration-contract.md) define the
> authoritative extraction API.
> This page is retained for migration and regression comparison only. The root [README](../../README.md),
> [core text API](core-api.md), and [Rust layout engine contract](rust-layout-engine.md) define the
> authoritative API.

## Milestone 0.1 acceptance evidence

Expand Down
7 changes: 4 additions & 3 deletions docs/planning/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,12 @@
## Product, API, and execution

- [Project brief](project-brief.md) β€” product intent, merged v0, target v1, and later horizon.
- [Merged v0 runtime and bake API](api-shapes.md) β€” public and internal TypeScript migration fixture.
- [Merged v0 runtime and bake API](api-shapes.md) β€” superseded migration fixture; describes the merged v0 surface deleted by the Rust render-plan cutover.
- [Three.js text API](three-api.md) β€” authoritative `FontLoader`, `TextGroup`, and `Text` surface, including late binding, group disposal/rebinding, font leases, retained non-throwing errors, ordering, and render-loop synchronization.
- [Core text API](core-api.md) β€” authoritative API and rationale for ordered font stacks, batch-owned paragraph handles, identity-preserving capacity changes, font leases, fixed-capacity failure, physical batching, and cascading disposal.
- [Engine integration contract](engine-integration-contract.md) β€” exact prepared glyph-batch/run, variant, target storage, transform, draw compilation, staging, attachment ownership, and disposal contract.
- [Raster technique and engine resource API](raster-technique-api.md) β€” authoritative split between portable baker/artifact/CPU technique data, reusable backend technique shaders, variant-aware programs, and engine GPU targets.
- [Rust layout engine contract](rust-layout-engine.md) β€” authoritative engine ABI, render-plan policy, and publication boundary for custom renderers.
- [Engine integration contract](engine-integration-contract.md) β€” superseded historical record; the Rust command buffer replaced this storage and batching contract.
- [Raster technique and engine resource API](raster-technique-api.md) β€” superseded historical record; the Rust render-plan cutover replaced these TypeScript binding and packing interfaces.
- [TypeGPU raster programs and text engine](typegpu-api.md) β€” complete direct TypeGPU API for typed technique shaders, programs, variants, caller-owned render passes, transforms, synchronization, and disposal.
- [TypeGPU-first shader authority](typegpu-first-shader-authority.md) β€” exploratory package shape and falsifiable proof ladder for sharing complete raster kernels with direct WebGPU hosts, Three.js, and gpucat without changing core.
- [Three material authority for text draws](three-material-authority.md) β€” **work in progress.** Fixes the Rust `material_id` route and shared-storage/draw-split contract while leaving the exact Three material-factory types for a later design pass.
Expand Down
Loading