feat: target-v1 core API, Three integration, and layout performance

.claude/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "dev",
+      "runtimeExecutable": "pnpm",
+      "runtimeArgs": ["run", "dev"],
+      "port": 5173
+    }
+  ]
+}

README.md

@@ -8,7 +8,7 @@ engine integrations below are implemented and pass their portability gates.
 ## Render text with React Three Fiber
 
 ```tsx
-import { Text, TextGroup, useFont } from '@pmndrs/text-r3f';
+import { Text, TextGroup, useFont } from '@pmndrs/text/r3f';
 import { mtsdf } from '@pmndrs/text/raster/mtsdf';
 
 function Labels() {
@@ -28,7 +28,7 @@ function Labels() {
 ## Render text with Three.js
 
 ```ts
-import { FontLoader, Text, TextGroup } from '@pmndrs/text-three';
+import { FontLoader, Text, TextGroup } from '@pmndrs/text/three';
 import { mtsdf } from '@pmndrs/text/raster/mtsdf';
 
 const loader = new FontLoader();
@@ -49,7 +49,7 @@ Both integrations load fonts explicitly and add one same-technique text batch to
 
 ```ts
 import { createFontStack } from '@pmndrs/text';
-import { FontLoader, Text, TextGroup, span, txt, type SpanStyle } from '@pmndrs/text-three';
+import { FontLoader, Text, TextGroup, span, txt, type SpanStyle } from '@pmndrs/text/three';
 import { mtsdf } from '@pmndrs/text/raster/mtsdf';
 
 const loader = new FontLoader();

apps/benchmarks/scripts/measure-package-sizes.mts

@@ -35,7 +35,7 @@ interface BundleResult {
 
 const root = fileURLToPath(new URL('..', import.meta.url));
 const diagnosticModuleFragments = ['/packages/text/dist/internal/raster-baker-profile.js'];
-const diagnosticCodeFragments = ['createProfiledDirectRasterBakerFromInstance', 'profiled MTSDF baker'];
+const diagnosticCodeFragments = ['createProfiledDirectRasterBakerFromInstance', 'profiled MSDF baker'];
 
 function isTextPeerDependency(id: string): boolean {
   return id === 'three' || id.startsWith('three/') || id === 'react' || id.startsWith('@react-three/fiber');
@@ -253,7 +253,7 @@ async function measureWasm(id: string, label: string, source: URL): Promise<Meas
   };
 }
 
-async function measureAdmittedMtsdfGenerator(): Promise<MeasuredEntry> {
+async function measureAdmittedMsdfGenerator(): Promise<MeasuredEntry> {
   const evidence = JSON.parse(
     await readFile(
       new URL('../../../packages/text/rust/mtsdf-admission/evidence/simd-v0.json', import.meta.url),
@@ -281,11 +281,11 @@ async function measureAdmittedMtsdfGenerator(): Promise<MeasuredEntry> {
     scalar.gzipBytes === undefined ||
     scalar.brotliBytes === undefined
   ) {
-    throw new Error('admitted scalar MTSDF generator size evidence is incomplete');
+    throw new Error('admitted scalar MSDF generator size evidence is incomplete');
   }
   return {
     id: 'mtsdf-generator-wasm',
-    label: 'MTSDF admitted generator kernel',
+    label: 'MSDF admitted generator kernel',
     status: 'measured',
     format: 'wasm',
     sha256: scalar.optimizedSha256,
@@ -309,10 +309,11 @@ const entries: SizeEntry[] = [
       excludedInitial: [
         '/packages/text/dist/runtime-bake.js',
         '/packages/text/dist/runtime-bake-worker.js',
-        '/packages/text/dist/react.js',
-        '/packages/text/dist/raster/bitmap.js',
+        '/packages/text/dist/r3f.js',
+        '/packages/text/dist/three.js',
+        '/packages/text/dist/raster/bitmap-technique.js',
         '/packages/text/dist/raster/msdf.js',
-        '/packages/text/dist/raster/slug.js',
+        '/packages/text/dist/raster/slug-technique.js',
         '/packages/text/dist/bakers/msdf.js',
         '/packages/text/dist/node/',
         '/packages/font-baker/dist/index.js',
@@ -360,32 +361,14 @@ const entries: SizeEntry[] = [
     false,
     true,
     true,
-    {
-      expectedDynamic: [],
-      excludedInitial: [
-        '/packages/text/dist/raster/slug.js',
-        '/packages/text/dist/internal/slug-shaders/',
-        '/packages/text/dist/bakers/slug.js',
-        '/packages/text/dist/runtime-bakers/slug',
-      ],
-    },
   ),
   await measureJavaScript(
     'mtsdf-runtime-js',
-    'MTSDF runtime JS graph',
+    'MSDF runtime JS graph',
     new URL('../size-entries/mtsdf-runtime.ts', import.meta.url),
     false,
     true,
     true,
-    {
-      expectedDynamic: [],
-      excludedInitial: [
-        '/packages/text/dist/raster/slug.js',
-        '/packages/text/dist/internal/slug-shaders/',
-        '/packages/text/dist/bakers/slug.js',
-        '/packages/text/dist/runtime-bakers/slug',
-      ],
-    },
   ),
   await measureJavaScript(
     'slug-runtime-js',
@@ -412,18 +395,18 @@ const entries: SizeEntry[] = [
   ),
   await measureJavaScript(
     'mtsdf-generator-js',
-    'MTSDF generator host JS',
+    'MSDF generator host JS',
     new URL('../size-entries/mtsdf-generator.ts', import.meta.url),
   ),
-  await measureAdmittedMtsdfGenerator(),
+  await measureAdmittedMsdfGenerator(),
   await measureWasm(
     'mtsdf-baker-wasm',
-    'MTSDF fixed baker Wasm',
+    'MSDF fixed baker Wasm',
     new URL('../../../packages/text/dist/mtsdf_baker.wasm', import.meta.url),
   ),
   await measureJavaScript(
     'mtsdf-baker-js',
-    'MTSDF fixed baker host JS',
+    'MSDF fixed baker host JS',
     new URL('../size-entries/mtsdf-baker.ts', import.meta.url),
     false,
     true,

apps/benchmarks/scripts/run-headless.mts

@@ -42,6 +42,10 @@ const conformanceCases: readonly BenchmarkCase[] = [
     targetId: 'advanced-shaping-conformance',
     scenarioId: 'advanced-shaping-conformance',
   },
+  {
+    targetId: 'rich-text-spans-conformance',
+    scenarioId: 'rich-text-spans-conformance',
+  },
 ];
 
 const readinessTimeoutMs = 30_000;