@drawmotive/textgraph 0.2.0 → 0.2.1

package/README.md

@@ -8,12 +8,12 @@ Render TextGraph diagrams as PNG images and validate diagram source.
 ## Installation
 
 ```bash
-npm install @drawmotive/textgraph@0.2.0
+npm install @drawmotive/textgraph@0.2.1
 ```
 
 Requires Node.js 22+ or a modern browser.
 
-Version `0.2.0` is the first stable release. Install the exact version above or use `@latest` for the current stable release.
+Version `0.2.1` defaults React PNG rendering to scale `1`, matching the base SDK. Version `0.2.0` was the first stable release. The exact installation command above becomes available after `0.2.1` is published; `@latest` selects the current published stable release.
 
 ## Quickstart
 
@@ -36,7 +36,7 @@ try {
 }
 ```
 
-PNG output defaults to bytes, scale `2`, padding `10`, and a white background. Reuse an instance for multiple diagrams, then call `dispose()`.
+PNG output defaults to bytes, scale `1`, padding `10`, and a white background. Reuse an instance for multiple diagrams, then call `dispose()`.
 
 ## Higher resolution
 
@@ -65,6 +65,7 @@ const textgraph = await initializeTextGraph({
 });
 const result = await textgraph.renderPng("A -> B", {
   encoding: "base64",
+  scale: 2,
   maxWidth: 1200,
 });
 
@@ -72,12 +73,18 @@ if (result.success) {
   const image = document.createElement("img");
   image.src = `data:image/png;base64,${result.png}`;
   image.alt = "A connects to B";
+  image.width = result.displayWidth ?? result.width / 2;
+  image.height = result.displayHeight ?? result.height / 2;
+  image.style.maxWidth = "100%";
+  image.style.height = "auto";
   document.body.append(image);
 }
 
 await textgraph.dispose();
 ```
 
+Scale `2` supplies more pixels for sharper web images; `displayWidth` and `displayHeight` keep the diagram at its logical size, including when `maxWidth` lowers the raster density. PNG DPI metadata does not control its CSS size. Older runtimes omit display dimensions; dividing pixel dimensions by the requested scale is a fallback that cannot recover logical size after `maxWidth` clamps the output.
+
 The npm package includes WASM, .NET runtime modules, fonts, and themes. Bundlers do not automatically deploy these dynamically loaded files. Re-copy assets after SDK updates and use an asset URL matching your deployment base path. Node loads assets from the installed package without this copy step.
 
 ## React
@@ -100,7 +107,7 @@ export function App() {
 }
 ```
 
-Changing `source` updates the image. The provider shares one lazy runtime across diagrams and disposes it on unmount. See [React integration](docs/react.md) for loading, errors, rendering options, and server rendering.
+The component defaults to scale `1`, displays at logical size, and shrinks to fit its container. Set `scale: 2` explicitly for higher raster density. Changing `source` updates the image. The provider shares one lazy runtime across diagrams and disposes it on unmount. See [React integration](docs/react.md) for loading, errors, rendering options, and server rendering.
 
 ## Runnable samples
 

package/docs/api-v1.md

@@ -20,12 +20,12 @@ Initialization resolves after manifest and real bridge agree on ABI, protocol an
 
 ## PNG rendering
 
-`renderPng(source, options?)` returns `{ success: true, png, width, height, diagnostics }` or `{ success: false, diagnostics }`. Diagram failures resolve with diagnostics and contain no image data. Successful results and diagnostics are frozen; byte output is a detached, caller-owned `Uint8Array`. Output uses a white background.
+`renderPng(source, options?)` returns `{ success: true, png, width, height, displayWidth?, displayHeight?, diagnostics }` or `{ success: false, diagnostics }`. `width` and `height` are raster pixels. The optional display dimensions are positive numbers representing logical size: raster dimensions divided by the effective scale after any `maxWidth` reduction. Older runtimes omit both fields. Diagram failures resolve with diagnostics and contain no image data. Successful results and diagnostics are frozen; byte output is a detached, caller-owned `Uint8Array`. Output uses a white background.
 
 | Option | Default | Meaning |
 | --- | --- | --- |
 | `encoding` | `"bytes"` | `"bytes"` returns `Uint8Array`; `"base64"` returns a string without a data-URL prefix. |
-| `scale` | `2` | Positive finite render scale. |
+| `scale` | `1` | Positive finite raster density relative to logical diagram size. |
 | `padding` | `10` | Non-negative finite padding in diagram units. |
 | `maxWidth` | Omitted | Positive safe integer maximum output width in pixels; preserves proportions and only reduces output size. |
 | `signal` | Omitted | Cancels queued work or discards completed work after cancellation. |
@@ -34,6 +34,8 @@ Literal encodings infer their corresponding PNG type in TypeScript; union encodi
 
 Scale and padding must remain finite when represented as 32-bit floats; scale must also remain greater than zero. Invalid arguments reject with `INVALID_ARGUMENT`.
 
+For web display, use scale `2` and the returned display dimensions as image dimensions, with `max-width: 100%; height: auto`. Increasing density then improves sharpness without enlarging the diagram. DPI metadata does not change CSS sizing. When an older runtime omits display dimensions, dividing raster dimensions by the requested scale works only when `maxWidth` did not reduce the effective density.
+
 After applying `maxWidth`, output is limited to 16,384 pixels per side and 16,777,216 pixels in total. Larger images return the `TG_RENDER_SIZE_LIMIT` diagnostic. PNG dimensions and signature are checked against the response metadata; malformed responses reject with `INVALID_RESPONSE`.
 
 ## Fonts and language packs
@@ -61,6 +63,10 @@ Existing `loadRuntime`, `readonly` and `mutate` hooks remain for development com
 
 Root condition precedence is worker/browser/node/default. Explicit entries avoid bundler ambiguity. Browser/Worker source graphs exclude Node imports.
 
+The repository development command can set `DRAWMOTIVE_TEXTGRAPH_RUNTIME` to an absolute generated directory for Node and inherited Node Workers. The default Node loader then reads that directory's `wasm-manifest.json` and resolves native modules, fonts, and themes there; existing manifest validation and asset integrity checks still apply. Missing or invalid local artifacts reject initialization or rendering without falling back to packaged assets. A supplied `resolveAsset` receives the selected local URL as its default; an explicit `loadRuntime` remains authoritative. Browser and browser Worker loaders ignore this environment variable.
+
+Keep this selection scoped to the development command. With it absent, package loading is unchanged; `info.packageVersion` identifies the JavaScript wrapper and capabilities reflect the intersection of the selected manifest and native bridge. Native manifests marked `privateSource.development: true` are rejected by release verification.
+
 ## Assets, CSP and offline operation
 
 Defaults resolve relative to the installed module. `resolveAsset(asset, defaultUrl)` may return an absolute URL or URL object for each asset. Deploy the complete `generated/wasm` directory: bundlers must preserve/copy these files and configure the resolver for their deployed location. It covers both JS and data. Instance query parameters isolate mutable .NET ESM state; servers should serve identical module bytes regardless of that query.
@@ -83,6 +89,6 @@ ABI 1.0.0 retains GetAbiVersion/GetPackageKind/CountParseDiagnostics and adds Ge
 
 Assets have relative path, media type, byte count and SHA-256. Packaging checks reject missing/extra assets, debug files, hash/projection/version drift. Runtime data assets are hash-checked before native startup. Bundled fonts and themes are loaded and hash-checked lazily before the first render; license files require no runtime I/O. These checks establish distribution consistency, not authenticated runtime signatures. `privateSource.commit` identifies committed private C# and bridge inputs. Toolchain changes may change bytes; cross-toolchain byte-for-byte reproducibility is not promised.
 
-The rendering wire uses one `Execute(requestJson)` export. Configuration is performed once before the first render with `{ protocolVersion: 1, operation: "configure", theme, fonts: [{ family, data }], fallbackFamilies }`, where `data` is base64 font data. Its response is `{ protocolVersion: 1, success, diagnostics }`. A render request is `{ protocolVersion: 1, operation: "render", source, export: { format: "png", scale, padding, maxWidth? } }`. Native success returns base64 `png`, `width`, `height`, and diagnostics; failures contain only `success: false` and diagnostics beside the protocol version. The JavaScript wrapper converts image data to the requested encoding.
+The rendering wire uses one `Execute(requestJson)` export. Configuration is performed once before the first render with `{ protocolVersion: 1, operation: "configure", theme, fonts: [{ family, data }], fallbackFamilies }`, where `data` is base64 font data. Its response is `{ protocolVersion: 1, success, diagnostics }`. A render request is `{ protocolVersion: 1, operation: "render", source, export: { format: "png", scale, padding, maxWidth? } }`. Native success returns base64 `png`, `width`, `height`, and diagnostics, plus an additive optional `displayWidth`/`displayHeight` pair; failures contain only `success: false` and diagnostics beside the protocol version. The JavaScript wrapper validates the display dimensions when present and converts image data to the requested encoding.
 
 For rendering-capable bridges, disposal sends `{ protocolVersion: 1, operation: "dispose" }` and validates the same success/diagnostics envelope as configuration. This request releases native resources without loading fonts or shutting down the host runtime. Legacy validation-only bridges release wrapper references directly.

package/docs/react.md

@@ -18,8 +18,7 @@ export function Diagram({ source }: { source: string }) {
   return (
     <TextGraphProvider options={options}>
       <TextGraph source={source} alt="Process flow"
-        renderOptions={{ scale: 2, maxWidth: 1200 }}
-        style={{ maxWidth: '100%', height: 'auto' }} />
+        renderOptions={{ maxWidth: 1200 }} />
     </TextGraphProvider>
   );
 }
@@ -37,12 +36,16 @@ Use your deployed base path instead of `/` for subdirectory hosting. The [React/
 | --- | --- |
 | `source` | Required DSL string; changes trigger rendering. |
 | `alt` | Image description; defaults to `TextGraph diagram`. |
-| `renderOptions` | `scale`, `padding`, and `maxWidth`, with SDK defaults. |
+| `renderOptions` | Defaults to `scale: 1`; `padding` and `maxWidth` use SDK defaults. Set `scale: 2` explicitly for higher raster density. |
 | `loading` | React content shown with `role="status"`; defaults to `Rendering diagram…`. |
 | Other image attributes | Passed to the successful `<img>`, including `className`, `style`, `width`, and `height`. |
 
 The component owns `src`, encoding, and cancellation. While new input renders, old images are replaced by loading content. A stale result cannot replace newer input. DSL diagnostics and operational failures appear as escaped text with `role="alert"`; corrected input renders again. Changing only `alt` or image styles does not rerun layout.
 
+Images use the render result's logical `displayWidth` and `displayHeight`, so increasing `scale` adds pixels without enlarging the diagram. `maxWidth` limits raster pixels rather than CSS width. Styles default to `maxWidth: '100%'` and `height: 'auto'`; supplied styles merge over these defaults, and explicit image dimensions override the logical dimensions.
+
+Older runtimes omit display dimensions. The component then divides raster dimensions by the requested scale; this preserves logical size unless `maxWidth` has lowered the effective density. Deploy matching updated runtime assets for accurate sizing in that case. PNG DPI metadata does not control CSS size.
+
 An ordinary React render uses the browser main thread. Native layout already running cannot be preempted by cancellation; for heavy interactive workloads use the [Worker sample](https://github.com/drawmotive/textgraph/tree/main/samples/worker) to move SDK execution off the UI thread. The React component does not automatically create a Worker.
 
 ## Server rendering

package/docs/releases.md

@@ -7,7 +7,8 @@ Releases are selected deliberately and published by `.github/workflows/release.y
 | Version | npm dist-tag | Installation |
 | --- | --- | --- |
 | `0.1.0-alpha.1` | `alpha` | `npm install @drawmotive/textgraph@alpha` |
-| `0.2.0` | `latest` | `npm install @drawmotive/textgraph` |
+| `0.2.0` (published) | `latest` | `npm install @drawmotive/textgraph` |
+| `0.2.1` (next target) | `latest` after publication | `npm install @drawmotive/textgraph@0.2.1` after publication |
 
 An exact prerelease version also works: `npm install @drawmotive/textgraph@0.1.0-alpha.1`. npm assigns `latest` on a first publication even when another tag is specified. This default is accepted: `0.1.0-alpha.1` initially owned both `alpha` and `latest`. Subsequent alpha releases update `alpha` and preserve the existing default. A stable release updates `latest`.
 
@@ -35,10 +36,10 @@ Trusted publishing requires npm 11.5.1+ and Node.js 22.14.0+. Publication from a
 Native builds belong to the private DrawMotive repository. Commit native source, resource, and bridge changes first, then run there:
 
 ```bash
-npm run release:textgraph -- 0.2.0
+npm run release:textgraph -- 0.2.1
 ```
 
-This updates the package and lock versions, builds Release assets from the recorded private source commit, generates matching JSON/ESM manifests, updates the root workspace lock, and verifies asset hashes. It does not commit, push, tag, or publish. The `just release-textgraph 0.2.0` alias runs the same command.
+This updates the package and lock versions, builds Release assets from the recorded private source commit, generates matching JSON/ESM manifests, updates the root workspace lock, and verifies asset hashes. It does not commit, push, tag, or publish. The `just release-textgraph 0.2.1` alias runs the same command.
 
 For a JavaScript-only release reusing already verified native bytes, run in this package:
 
@@ -82,8 +83,8 @@ If npm requires a one-time code, run with `NPM_CONFIG_OTP` set in the local term
 After preparation, tests, and review, create the tag on the verified package commit:
 
 ```bash
-git tag -a textgraph-v0.2.0 -m "Release 0.2.0"
-git push origin textgraph-v0.2.0
+git tag -a textgraph-v0.2.1 -m "Release 0.2.1"
+git push origin textgraph-v0.2.1
 ```
 
 The release workflow resolves the tag to a commit, runs Node.js and three-browser tests on Ubuntu, packs the tested checkout, and passes the artifact to the `npm` environment for publication. All CI and release jobs use `ubuntu-latest`; the browser suite covers Chromium, Firefox, and WebKit. Stable releases select `latest` automatically. Never pass a custom dist-tag to bypass the release policy.
@@ -92,14 +93,14 @@ The release workflow resolves the tag to a commit, runs Node.js and three-browse
 
 ```bash
 npm view @drawmotive/textgraph dist-tags --json
-npm view @drawmotive/textgraph@0.2.0 dist.integrity
-npm install @drawmotive/textgraph@0.2.0
+npm view @drawmotive/textgraph@0.2.1 dist.integrity
+npm install @drawmotive/textgraph@0.2.1
 ```
 
 If a workflow fails before publishing, fix the configuration and rerun the same tag. For a manual dispatch, select the release tag as the workflow ref and supply the same tag as input; dispatching from `main` is rejected so OIDC and provenance identify the correct commit. For example:
 
 ```bash
-gh workflow run release.yml --ref textgraph-v0.2.0 -f tag=textgraph-v0.2.0
+gh workflow run release.yml --ref textgraph-v0.2.1 -f tag=textgraph-v0.2.1
 ```
 
 If publication succeeded but a later check failed, the script accepts an identical registry artifact with the correct channel and refuses different bytes at the same version. Keep the original workflow artifact for diagnosing integrity differences.

package/generated/wasm/dotnet.boot.js

@@ -1,7 +1,7 @@
 export const config = /*json-start*/{
   "mainAssemblyName": "DrawMotive.TextGraph.Bridge.dll",
   "resources": {
-    "hash": "sha256-PGiRaG/pfoWwih92sz6gwc2P1RT5QwTMhOSnxnWLpSA=",
+    "hash": "sha256-W/6+iMFbhpPEh5Ge4iiu9DhMaqbvbX7w57YbSQ+ZM+s=",
     "jsModuleNative": [
       {
         "name": "dotnet.native.js"
@@ -15,7 +15,7 @@ export const config = /*json-start*/{
     "wasmNative": [
       {
         "name": "dotnet.native.wasm",
-        "hash": "sha256-evCMArcOcHUoHR7s7+ihcz/fys1AKza6uTkIdh7b8A8="
+        "hash": "sha256-R8kDiIGfkO/Q9HySbzLdTbKJgeXehFSNF6B+5/SOPQI="
       }
     ],
     "coreAssembly": [
@@ -34,12 +34,12 @@ export const config = /*json-start*/{
       {
         "virtualPath": "Grpc.Core.Api.wasm",
         "name": "Grpc.Core.Api.wasm",
-        "hash": "sha256-oLpcVhhNuqbeuFAh2ahqB0SX4T4eYENMnMQgWV4P49U="
+        "hash": "sha256-TPziK3Q3YPY1qXINfLKVIGxpqRKKuasyiUBX9v1FNw4="
       },
       {
         "virtualPath": "HarfBuzzSharp.wasm",
         "name": "HarfBuzzSharp.wasm",
-        "hash": "sha256-bgBsRhRWX+7YWOuhGi7X82c4XHAdUJtSMViX3J3TClY="
+        "hash": "sha256-drB7TZkNPTKdrFS/IcKY3/XSIN1i+BAVvGv1fa4fozw="
       },
       {
         "virtualPath": "MagicOnion.Abstractions.wasm",
@@ -134,7 +134,7 @@ export const config = /*json-start*/{
       {
         "virtualPath": "Polly.Core.wasm",
         "name": "Polly.Core.wasm",
-        "hash": "sha256-oXQJ0yv9FY6pZ4DFnvm69o4OS8C0GSg+yqDQrTrkapM="
+        "hash": "sha256-mMPGuighials8LGc/l3qseOcJZIivgwgucVnM2MHlLQ="
       },
       {
         "virtualPath": "R3.wasm",
@@ -149,7 +149,7 @@ export const config = /*json-start*/{
       {
         "virtualPath": "SkiaSharp.wasm",
         "name": "SkiaSharp.wasm",
-        "hash": "sha256-w96HZLzJxJ/OU+hiO2Hs2qQa08c5gPSB5AWc8gEGdKE="
+        "hash": "sha256-oSfaMRAPX6qLBtENPhOBzOBN5Ax4EanYCohFCi1qPSA="
       },
       {
         "virtualPath": "SkiaSharp.HarfBuzz.wasm",
@@ -169,22 +169,22 @@ export const config = /*json-start*/{
       {
         "virtualPath": "Graphics.Core.wasm",
         "name": "Graphics.Core.wasm",
-        "hash": "sha256-C3ClD/i04+bQo86EkeS3s7PbITUJVdgZWXIuQCNXBTk="
+        "hash": "sha256-QqYwwcamvWBKufMUd18Wi5MWzOKtnTnSY/jNnDFyC+g="
       },
       {
         "virtualPath": "Math.Core.wasm",
         "name": "Math.Core.wasm",
-        "hash": "sha256-KLAM6wWV6HDvtnpROED/ygHGbv/XTewJHccRAtpbYTk="
+        "hash": "sha256-+48yhPwcX3nmLHVPxdFG8LN0LBMMlO4pOvBNwDiS+4o="
       },
       {
         "virtualPath": "RBush.wasm",
         "name": "RBush.wasm",
-        "hash": "sha256-Ioj84guwsd/4wbdcnV5F2vfGBQhRCUNYHl5tRihWK4g="
+        "hash": "sha256-0TmcGlWNXgKGDK6A8JeAQfx32iggploPWQKkiUqeDrI="
       },
       {
         "virtualPath": "DrawMotive.TextGraph.Bridge.wasm",
         "name": "DrawMotive.TextGraph.Bridge.wasm",
-        "hash": "sha256-bu8seI0tPCzVwacci3YcIr+a3g+DZX+SMTrnrH7t6YQ="
+        "hash": "sha256-X7Iw2ugi+nxw0sxpLvFJsIQrunBZAlv4eR2ntEfAixQ="
       },
       {
         "virtualPath": "System.Collections.Concurrent.wasm",

package/generated/wasm/dotnet.native.js

@@ -30,11 +30,11 @@ Module['ready'] = new Promise((resolve, reject) => {
 
 // --pre-jses are emitted after the Module integration code, so that they can
 // refer to Module (if they choose; they can also define Module)
-// include: /home/mason/dotnet/packs/Microsoft.NETCore.App.Runtime.Mono.browser-wasm/10.0.12/runtimes/browser-wasm/native/src/es6/dotnet.es6.pre.js
+// include: /home/admin/.dotnet/packs/Microsoft.NETCore.App.Runtime.Mono.browser-wasm/10.0.12/runtimes/browser-wasm/native/src/es6/dotnet.es6.pre.js
 if (_nativeModuleLoaded) throw new Error("Native module already loaded");
 _nativeModuleLoaded = true;
 createDotnetRuntime = Module = moduleArg(Module);
-// end include: /home/mason/dotnet/packs/Microsoft.NETCore.App.Runtime.Mono.browser-wasm/10.0.12/runtimes/browser-wasm/native/src/es6/dotnet.es6.pre.js
+// end include: /home/admin/.dotnet/packs/Microsoft.NETCore.App.Runtime.Mono.browser-wasm/10.0.12/runtimes/browser-wasm/native/src/es6/dotnet.es6.pre.js
 
 
 // Sometimes an existing Module object exists with properties

package/generated/wasm-manifest.js

@@ -1,7 +1,7 @@
 export default {
   "schemaVersion": 1,
   "packageName": "@drawmotive/textgraph",
-  "packageVersion": "0.2.0",
+  "packageVersion": "0.2.1",
   "abiVersion": "1.0.0",
   "protocolVersion": 1,
   "runtimeModule": "wasm/dotnet.js",
@@ -27,7 +27,7 @@ export default {
   },
   "targetFramework": "net10.0",
   "privateSource": {
-    "commit": "b6fbbac04592b53d125930103681a953aa4f0110",
+    "commit": "f5a5e5d027072d1faa79ac9b25d5899d1380fdfd",
     "project": "DrawMotive.TextGraph.Bridge"
   },
   "entryAssembly": "wasm/DrawMotive.TextGraph.Bridge.wasm",
@@ -49,8 +49,8 @@ export default {
     {
       "path": "wasm/DrawMotive.TextGraph.Bridge.wasm",
       "mediaType": "application/wasm",
-      "bytes": 73493,
-      "sha256": "6eef2c788d2d3c2cd5c1a71c8b761c22bf9ade0f83657f92313ae7ac7eede984"
+      "bytes": 77077,
+      "sha256": "5fb230dae822fa7c70d2cc692ef149b0842bba7059025bf8791da7b447c08b14"
     },
     {
       "path": "wasm/FuzzyBubbles-LICENSE.txt",
@@ -67,20 +67,20 @@ export default {
     {
       "path": "wasm/Graphics.Core.wasm",
       "mediaType": "application/wasm",
-      "bytes": 3118361,
-      "sha256": "0b70a50ff8b4e3e6d0a3ce8491e4b7b3b3db21350955d81959722e4023570539"
+      "bytes": 3119385,
+      "sha256": "42a630c1c6a6bd604ab9f314775f168b9316cce2ad9d39d263f8cd9c31720be8"
     },
     {
       "path": "wasm/Grpc.Core.Api.wasm",
       "mediaType": "application/wasm",
       "bytes": 7957,
-      "sha256": "a0ba5c56184dbaa6deb85021d9a86a074497e13e1e60434c9cc420595e0fe3d5"
+      "sha256": "4cfce22b743760f635a9720d7cb295206c69a9128ab9ab32894057f6fd45370e"
     },
     {
       "path": "wasm/HarfBuzzSharp.wasm",
       "mediaType": "application/wasm",
       "bytes": 29461,
-      "sha256": "6e006c4614565feed858eba11a2ed7f367385c701d509b52315897dc9dd30a56"
+      "sha256": "76b07b4d990d3d329dac54bf21c298dff5d220dd62f81015bc6bf57dae1fa33c"
     },
     {
       "path": "wasm/MagicOnion.Abstractions.wasm",
@@ -110,7 +110,7 @@ export default {
       "path": "wasm/Math.Core.wasm",
       "mediaType": "application/wasm",
       "bytes": 3241241,
-      "sha256": "28b00ceb0595e870efb67a513840ffca01c66effd74dec091dc71102da5b6139"
+      "sha256": "fb8f3284fc1c5f79e62c754fc5d146f0b3742c130c94ee293af04dc03892fb8a"
     },
     {
       "path": "wasm/MemoryPack.Core.wasm",
@@ -206,7 +206,7 @@ export default {
       "path": "wasm/Polly.Core.wasm",
       "mediaType": "application/wasm",
       "bytes": 62741,
-      "sha256": "a17409d32bfd158ea96780c59ef9baf68e0e4bc0b419283ecaa0d0ad3ae46a93"
+      "sha256": "98c3c6ba282189a96cf0b19cfe5deab1e39c259222be0c20b9c56733630794b4"
     },
     {
       "path": "wasm/Polly.wasm",
@@ -230,7 +230,7 @@ export default {
       "path": "wasm/RBush.wasm",
       "mediaType": "application/wasm",
       "bytes": 24341,
-      "sha256": "2288fce20bb0b1dff8c1b75c9d5e45daf7c60508510943581e5e6d4628562b88"
+      "sha256": "d1399c1a558d5e02860cae80f0978041fc77da2820a65a0f5902a4894a9e0eb2"
     },
     {
       "path": "wasm/SkiaSharp.HarfBuzz.wasm",
@@ -242,7 +242,7 @@ export default {
       "path": "wasm/SkiaSharp.wasm",
       "mediaType": "application/wasm",
       "bytes": 90389,
-      "sha256": "c3de8764bcc9c49fce53e8623b61ecdaa41ad3c73980f481e4059cf2010674a1"
+      "sha256": "a127da31100f5faa8b06d10d3e1381cce04de40c7811a9d80a88450a2d6a3d20"
     },
     {
       "path": "wasm/Stateless.wasm",
@@ -524,7 +524,7 @@ export default {
       "path": "wasm/dotnet.boot.js",
       "mediaType": "text/javascript",
       "bytes": 17141,
-      "sha256": "2d481a77cf01dca539bb82866395c027f4b91b3e397b01f06c9ef38aa10e7f47"
+      "sha256": "38a942cbb9bd0df00af223fa0b1b0f4080a2de476c5367c7b10c7b435e1f1a52"
     },
     {
       "path": "wasm/dotnet.js",
@@ -535,14 +535,14 @@ export default {
     {
       "path": "wasm/dotnet.native.js",
       "mediaType": "text/javascript",
-      "bytes": 248268,
-      "sha256": "bca7e71c9e0c78fc4e7ebeca840786f7386c6feade4ce8b7b5771d718a2edaeb"
+      "bytes": 248270,
+      "sha256": "d53e77206394560939d72a9d57269a38b611a3cf9cd32d5c6403a802f3346bd4"
     },
     {
       "path": "wasm/dotnet.native.wasm",
       "mediaType": "application/wasm",
-      "bytes": 6020214,
-      "sha256": "7af08c02b70e7075281d1eecefe8a1733fdfcacd402b36bab93908761edbf00f"
+      "bytes": 6020218,
+      "sha256": "47c90388819f90efd0f47c926f32dd4db28981e5de84548d17a07ee7f48e3d02"
     },
     {
       "path": "wasm/dotnet.runtime.js",

package/generated/wasm-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "packageName": "@drawmotive/textgraph",
-  "packageVersion": "0.2.0",
+  "packageVersion": "0.2.1",
   "abiVersion": "1.0.0",
   "protocolVersion": 1,
   "runtimeModule": "wasm/dotnet.js",
@@ -27,7 +27,7 @@
   },
   "targetFramework": "net10.0",
   "privateSource": {
-    "commit": "b6fbbac04592b53d125930103681a953aa4f0110",
+    "commit": "f5a5e5d027072d1faa79ac9b25d5899d1380fdfd",
     "project": "DrawMotive.TextGraph.Bridge"
   },
   "entryAssembly": "wasm/DrawMotive.TextGraph.Bridge.wasm",
@@ -49,8 +49,8 @@
     {
       "path": "wasm/DrawMotive.TextGraph.Bridge.wasm",
       "mediaType": "application/wasm",
-      "bytes": 73493,
-      "sha256": "6eef2c788d2d3c2cd5c1a71c8b761c22bf9ade0f83657f92313ae7ac7eede984"
+      "bytes": 77077,
+      "sha256": "5fb230dae822fa7c70d2cc692ef149b0842bba7059025bf8791da7b447c08b14"
     },
     {
       "path": "wasm/FuzzyBubbles-LICENSE.txt",
@@ -67,20 +67,20 @@
     {
       "path": "wasm/Graphics.Core.wasm",
       "mediaType": "application/wasm",
-      "bytes": 3118361,
-      "sha256": "0b70a50ff8b4e3e6d0a3ce8491e4b7b3b3db21350955d81959722e4023570539"
+      "bytes": 3119385,
+      "sha256": "42a630c1c6a6bd604ab9f314775f168b9316cce2ad9d39d263f8cd9c31720be8"
     },
     {
       "path": "wasm/Grpc.Core.Api.wasm",
       "mediaType": "application/wasm",
       "bytes": 7957,
-      "sha256": "a0ba5c56184dbaa6deb85021d9a86a074497e13e1e60434c9cc420595e0fe3d5"
+      "sha256": "4cfce22b743760f635a9720d7cb295206c69a9128ab9ab32894057f6fd45370e"
     },
     {
       "path": "wasm/HarfBuzzSharp.wasm",
       "mediaType": "application/wasm",
       "bytes": 29461,
-      "sha256": "6e006c4614565feed858eba11a2ed7f367385c701d509b52315897dc9dd30a56"
+      "sha256": "76b07b4d990d3d329dac54bf21c298dff5d220dd62f81015bc6bf57dae1fa33c"
     },
     {
       "path": "wasm/MagicOnion.Abstractions.wasm",
@@ -110,7 +110,7 @@
       "path": "wasm/Math.Core.wasm",
       "mediaType": "application/wasm",
       "bytes": 3241241,
-      "sha256": "28b00ceb0595e870efb67a513840ffca01c66effd74dec091dc71102da5b6139"
+      "sha256": "fb8f3284fc1c5f79e62c754fc5d146f0b3742c130c94ee293af04dc03892fb8a"
     },
     {
       "path": "wasm/MemoryPack.Core.wasm",
@@ -206,7 +206,7 @@
       "path": "wasm/Polly.Core.wasm",
       "mediaType": "application/wasm",
       "bytes": 62741,
-      "sha256": "a17409d32bfd158ea96780c59ef9baf68e0e4bc0b419283ecaa0d0ad3ae46a93"
+      "sha256": "98c3c6ba282189a96cf0b19cfe5deab1e39c259222be0c20b9c56733630794b4"
     },
     {
       "path": "wasm/Polly.wasm",
@@ -230,7 +230,7 @@
       "path": "wasm/RBush.wasm",
       "mediaType": "application/wasm",
       "bytes": 24341,
-      "sha256": "2288fce20bb0b1dff8c1b75c9d5e45daf7c60508510943581e5e6d4628562b88"
+      "sha256": "d1399c1a558d5e02860cae80f0978041fc77da2820a65a0f5902a4894a9e0eb2"
     },
     {
       "path": "wasm/SkiaSharp.HarfBuzz.wasm",
@@ -242,7 +242,7 @@
       "path": "wasm/SkiaSharp.wasm",
       "mediaType": "application/wasm",
       "bytes": 90389,
-      "sha256": "c3de8764bcc9c49fce53e8623b61ecdaa41ad3c73980f481e4059cf2010674a1"
+      "sha256": "a127da31100f5faa8b06d10d3e1381cce04de40c7811a9d80a88450a2d6a3d20"
     },
     {
       "path": "wasm/Stateless.wasm",
@@ -524,7 +524,7 @@
       "path": "wasm/dotnet.boot.js",
       "mediaType": "text/javascript",
       "bytes": 17141,
-      "sha256": "2d481a77cf01dca539bb82866395c027f4b91b3e397b01f06c9ef38aa10e7f47"
+      "sha256": "38a942cbb9bd0df00af223fa0b1b0f4080a2de476c5367c7b10c7b435e1f1a52"
     },
     {
       "path": "wasm/dotnet.js",
@@ -535,14 +535,14 @@
     {
       "path": "wasm/dotnet.native.js",
       "mediaType": "text/javascript",
-      "bytes": 248268,
-      "sha256": "bca7e71c9e0c78fc4e7ebeca840786f7386c6feade4ce8b7b5771d718a2edaeb"
+      "bytes": 248270,
+      "sha256": "d53e77206394560939d72a9d57269a38b611a3cf9cd32d5c6403a802f3346bd4"
     },
     {
       "path": "wasm/dotnet.native.wasm",
       "mediaType": "application/wasm",
-      "bytes": 6020214,
-      "sha256": "7af08c02b70e7075281d1eecefe8a1733fdfcacd402b36bab93908761edbf00f"
+      "bytes": 6020218,
+      "sha256": "47c90388819f90efd0f47c926f32dd4db28981e5de84548d17a07ee7f48e3d02"
     },
     {
       "path": "wasm/dotnet.runtime.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawmotive/textgraph",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "TextGraph DSL and headless DrawMotive file toolkit",
   "type": "module",
   "types": "./src/index.d.ts",

package/schemas/render.schema.json

@@ -76,6 +76,14 @@
       "type": "integer",
       "minimum": 1,
       "maximum": 2147483647
+    },
+    "displayWidth": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "displayHeight": {
+      "type": "number",
+      "exclusiveMinimum": 0
     }
   },
   "required": [
@@ -145,6 +153,22 @@
               "properties": {
                 "height": {}
               }
+            },
+            {
+              "required": [
+                "displayWidth"
+              ],
+              "properties": {
+                "displayWidth": {}
+              }
+            },
+            {
+              "required": [
+                "displayHeight"
+              ],
+              "properties": {
+                "displayHeight": {}
+              }
             }
           ]
         },
@@ -163,5 +187,13 @@
         }
       }
     }
-  ]
+  ],
+  "dependentRequired": {
+    "displayWidth": [
+      "displayHeight"
+    ],
+    "displayHeight": [
+      "displayWidth"
+    ]
+  }
 }

package/src/index.d.ts

@@ -114,7 +114,7 @@ export type TextGraphPngEncoding = 'bytes' | 'base64';
 export interface TextGraphRenderPngOptions<Encoding extends TextGraphPngEncoding = TextGraphPngEncoding> {
   /** Defaults to bytes. Base64 contains no data-URL prefix. */
   encoding?: Encoding;
-  /** Positive render scale. Defaults to 2. */
+  /** Positive raster density relative to logical diagram size. Defaults to 1. */
   scale?: number;
   /** Non-negative padding in diagram units. Defaults to 10. */
   padding?: number;
@@ -125,7 +125,9 @@ export interface TextGraphRenderPngOptions<Encoding extends TextGraphPngEncoding
 }
 
 export type TextGraphRenderPngResult<Png extends Uint8Array | string = Uint8Array | string> =
-  | { readonly success: true; readonly png: Png; readonly width: number; readonly height: number; readonly diagnostics: readonly TextGraphRenderDiagnostic[] }
+  | { readonly success: true; readonly png: Png; readonly width: number; readonly height: number;
+      /** Logical display dimensions before density scaling; omitted by older runtimes. */
+      readonly displayWidth?: number; readonly displayHeight?: number; readonly diagnostics: readonly TextGraphRenderDiagnostic[] }
   | { readonly success: false; readonly diagnostics: readonly TextGraphRenderDiagnostic[] };
 
 export interface TextGraphRuntimeInfo extends TextGraphRuntimeManifest {

package/src/platform/node.d.ts

@@ -1,3 +1,5 @@
 export * from '../index.js';
 
+/** The workspace development command may select local native assets through
+ * DRAWMOTIVE_TEXTGRAPH_RUNTIME; ordinary Node loading uses packaged assets. */
 export declare const platform: 'node';

package/src/platform/node.js

@@ -6,7 +6,10 @@ import { DrawMotiveError } from '../runtime/errors.js';
 
 export async function initializeTextGraph(options = {}) {
   if (!options || typeof options !== 'object') throw new DrawMotiveError('INVALID_ARGUMENT', 'Initialization options must be an object');
-  return initialize({ ...options, loadRuntime: options.loadRuntime ?? (context => loadNodeRuntime(context, manifest)) });
+  // The workspace development command opts in explicitly; imports and browser
+  // loaders never consult a local build directory or replace packaged assets.
+  const directory = process.env.DRAWMOTIVE_TEXTGRAPH_RUNTIME;
+  return initialize({ ...options, loadRuntime: options.loadRuntime ?? (context => loadNodeRuntime(context, manifest, directory)) });
 }
 
 export const platform = 'node';

package/src/react/index.d.ts

@@ -11,6 +11,7 @@ export interface TextGraphProviderProps {
 export interface TextGraphProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'srcSet' | 'children' | 'loading'> {
   source: string;
   alt?: string;
+  /** Defaults to scale 1; the image displays at logical size. */
   renderOptions?: Omit<TextGraphRenderPngOptions, 'encoding' | 'signal'>;
   loading?: ReactNode;
 }

package/src/react/index.js

@@ -15,10 +15,10 @@ export function TextGraphProvider({ options = defaultOptions, children }) {
 
 /** Renders DSL as an image; only the latest committed input may publish a result. */
 export function TextGraph({ source, alt = 'TextGraph diagram', renderOptions = defaultOptions,
-  loading = 'Rendering diagram…', ...imageProps }) {
+  loading = 'Rendering diagram…', style, ...imageProps }) {
   const shared = useContext(RuntimeContext);
   const resource = useMemo(() => shared ?? createRuntimeResource(defaultOptions), [shared]);
-  const { scale, padding, maxWidth } = renderOptions;
+  const { scale = 1, padding, maxWidth } = renderOptions;
   const request = useMemo(() => ({ source, scale, padding, maxWidth, resource }),
     [source, scale, padding, maxWidth, resource]);
   const [state, setState] = useState(null);
@@ -51,6 +51,9 @@ export function TextGraph({ source, alt = 'TextGraph diagram', renderOptions = d
     return createElement('span', { role: 'alert' }, message || 'Could not render diagram');
   }
   const result = state.result;
-  return createElement('img', { width: result.width, height: result.height, ...imageProps,
+  // Density improves sharpness without enlarging the diagram. Native dimensions
+  // also preserve logical size when maxWidth lowers the actual render density.
+  return createElement('img', { width: result.displayWidth ?? result.width / scale, height: result.displayHeight ?? result.height / scale, ...imageProps,
+    style: { maxWidth: '100%', ...(imageProps.height == null ? { height: 'auto' } : {}), ...style },
     src: `data:image/png;base64,${result.png}`, alt });
 }

package/src/runtime/dotnet.js

@@ -83,7 +83,9 @@ export async function startTextGraphRuntime(options, manifest, readAsset) {
 export function createBridgeRuntime({ manifest, options, readAsset, bridge, info }) {
   const renders = manifest.capabilities.includes(renderingCapability);
   return {
-    abiVersion: info.abiVersion, capabilities: info.capabilities,
+    // A bridge may support operations intentionally omitted by the selected
+    // manifest; advertise only the intersection that this loader exposes.
+    abiVersion: info.abiVersion, capabilities: info.capabilities.filter(capability => manifest.capabilities.includes(capability)),
     validate: source => bridge[manifest.bridge.validate](source),
     ...(renders ? { execute: createRenderingExecutor({ manifest, options, readAsset, execute: request => bridge[manifest.bridge.execute](request) }) } : {}),
     async dispose() {

package/src/runtime/node.js

@@ -1,9 +1,30 @@
 import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { startTextGraphRuntime } from './dotnet.js';
 import { DrawMotiveError } from './errors.js';
 
 /** Node file loading is isolated from the browser module graph. */
-export function loadNodeRuntime(options, manifest) {
+export async function loadNodeRuntime(options, manifest, directory) {
+  if (directory !== undefined) {
+    if (!path.isAbsolute(directory)) throw new DrawMotiveError('INVALID_ARGUMENT', 'DRAWMOTIVE_TEXTGRAPH_RUNTIME must be an absolute generated directory');
+    const manifestPath = path.join(directory, 'wasm-manifest.json');
+    let json;
+    try { json = await readFile(manifestPath, { encoding: 'utf8', signal: options.signal }); }
+    catch (cause) {
+      if (cause?.name === 'AbortError') throw cause;
+      throw new DrawMotiveError('RESOURCE_NOT_FOUND', 'Could not read the selected local runtime manifest', { cause, details: { manifest: manifestPath } });
+    }
+    try { manifest = JSON.parse(json); }
+    catch (cause) { throw new DrawMotiveError('INVALID_MANIFEST', 'The selected local runtime manifest is not valid JSON', { cause }); }
+    const resolveAsset = options.resolveAsset;
+    // Use the selected manifest and directory together for every native module,
+    // theme and font. A missing local artifact must never load packaged bytes.
+    options = { ...options, resolveAsset: asset => {
+      const defaultUrl = pathToFileURL(path.join(directory, asset.path));
+      return resolveAsset ? resolveAsset(asset, defaultUrl) : defaultUrl;
+    } };
+  }
   return startTextGraphRuntime(options, manifest, async (item, context) => {
     try {
       if (item.url.protocol === 'file:') {

package/src/runtime/rendering.js

@@ -7,7 +7,7 @@ const stages = ['parse', 'semantic', 'layout', 'render', 'font'];
 export function normalizeRenderOptions(source, options) {
   const invalid = message => { throw new DrawMotiveError('INVALID_ARGUMENT', message); };
   if (typeof source !== 'string' || !options || typeof options !== 'object' || Array.isArray(options)) invalid('Rendering requires a source string and options object');
-  const { encoding = 'bytes', scale = 2, padding = 10, maxWidth, signal } = options;
+  const { encoding = 'bytes', scale = 1, padding = 10, maxWidth, signal } = options;
   if (!['bytes', 'base64'].includes(encoding)) invalid('encoding must be bytes or base64');
   // The native geometry contract uses float32; reject values lost at that boundary.
   if (!Number.isFinite(scale) || !Number.isFinite(Math.fround(scale)) || Math.fround(scale) <= 0) invalid('scale must be positive and representable as a finite float32');
@@ -34,17 +34,25 @@ export function decodeRender(json, encoding) {
     const diagnostics = decodeDiagnostics(value.diagnostics, stages);
     if (value.success === diagnostics.some(item => item.severity === 'error')) throw new Error('Inconsistent success');
     if (!value.success) {
-      if (['png', 'width', 'height'].some(key => Object.hasOwn(value, key))) throw new Error('Failure contains image data');
+      if (['png', 'width', 'height', 'displayWidth', 'displayHeight'].some(key => Object.hasOwn(value, key))) throw new Error('Failure contains image data');
       return Object.freeze({ success: false, diagnostics });
     }
     if (![value.width, value.height].every(n => Number.isSafeInteger(n) && n > 0 && n <= 0x7fffffff)) throw new Error('Invalid dimensions');
+    // Only the native exporter knows the effective density after maxWidth clamps
+    // the raster. Older runtimes may omit this additive pair entirely.
+    const displayDimensions = {};
+    if (Object.hasOwn(value, 'displayWidth') || Object.hasOwn(value, 'displayHeight')) {
+      if (![value.displayWidth, value.displayHeight].every(n => Number.isFinite(n) && n > 0)) throw new Error('Invalid display dimensions');
+      displayDimensions.displayWidth = value.displayWidth;
+      displayDimensions.displayHeight = value.displayHeight;
+    }
     const bytes = decodeBase64(value.png);
     const signature = [137, 80, 78, 71, 13, 10, 26, 10];
     if (bytes.length < 33 || !signature.every((byte, index) => bytes[index] === byte)) throw new Error('Invalid PNG signature');
     const header = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     if (header.getUint32(8) !== 13 || header.getUint32(12) !== 0x49484452
         || header.getUint32(16) !== value.width || header.getUint32(20) !== value.height) throw new Error('PNG dimensions disagree');
-    return Object.freeze({ success: true, png: encoding === 'base64' ? value.png : bytes, width: value.width, height: value.height, diagnostics });
+    return Object.freeze({ success: true, png: encoding === 'base64' ? value.png : bytes, width: value.width, height: value.height, ...displayDimensions, diagnostics });
   } catch (cause) {
     throw new DrawMotiveError('INVALID_RESPONSE', 'The rendering response violates protocol 1', { cause });
   }