Add native documents, compiled UI, and relocatable WebScene SDK

README.md

@@ -260,3 +260,10 @@ safe renderer for arbitrary untrusted websites or scripts.
 The repository uses the terms in [LICENSE](LICENSE), including its Restricted Party
 Clause. Describe it as a custom source-available license, not unqualified MIT or an
 OSI-approved open-source license.
+
+## Native Web: compiled HTML/CSS and C++
+
+The [Native Web sample](samples/NativeWeb/README.md) compiles HTML/CSS into C++ and
+runs C++ application logic on WebScene's native DOM/layout with Foco's Cocoa/Metal
+host, without deploying V8 or runtime UI parsers. This is an initial, explicitly
+bounded compiler profile. See the [architecture and future binding note](docs/design/native-web.md).

docs/architecture/adr/0014-mixed-language-compiled-applications.md

@@ -0,0 +1,58 @@
+# ADR 0014: Mixed-language application logic over compiled views
+
+Status: Accepted design; mixed-language implementation is subsequent work.
+Date: 2026-09-10
+
+## Decision
+
+Compiled HTML/CSS does not prescribe the language of application logic. WebScene
+must support C++ and optional JavaScript/TypeScript logic together on the same
+native document. Developers can migrate an existing application incrementally,
+component by component, while retaining its compiled views and templates.
+TypeScript is compiled to JavaScript by application tooling; it is not a separate
+runtime or an automatic TypeScript-to-C++ conversion path.
+
+Use WebScene's annotation-driven interop generator for typed calls, callbacks and
+native object access in both directions. Both language paths must operate on the
+same document, node identities, events, CSS/layout engine and Canvas/WebGPU
+resources. Adding JavaScript must not create a parallel DOM, duplicate scene,
+second renderer or require runtime HTML/CSS parsing of compiled views.
+
+Application state remains outside generated views. Each state object has an
+explicit owner; generated bridges expose access and change notifications rather
+than silently copying authoritative state between languages. This also leaves a
+seam for future typed C++ view models and HTML bindings.
+
+## Required integration contracts
+
+- Preserve node identity through native handles and JavaScript wrappers.
+- Define ownership, weak references, callback disposal and runtime shutdown so
+  neither language can retain usable references to disposed native objects.
+- Respect document thread affinity; cross-thread calls require explicit dispatch.
+- Define error propagation and reentrancy for native-to-JS and JS-to-native calls.
+- Keep document mutation, event ordering and rendering behavior consistent across
+  languages. Native Canvas/WebGPU objects must be exposed through the same backend.
+- Generated view APIs use C++20 modules; interop remains a language-neutral seam
+  and does not require other languages to consume C++ module binaries.
+
+## Deployment and migration
+
+Pure-native applications continue to require no JavaScript runtime, V8 linkage,
+initialization or deployed runtime assets. The mixed-language profile opts into
+those dependencies explicitly. Interop wrappers are optional dependencies of the
+native document engine, not prerequisites for compiled view construction.
+
+A migration can retain existing JS/TS controllers, use compiled templates for
+view creation, and replace individual controllers/services with C++ behind typed
+interop contracts. Converting application logic must not require replacing the
+view or changing its document identity. Arbitrary runtime HTML construction is
+outside the compiled-view contract; dynamic native UI uses predefined templates.
+
+## Scope and verification
+
+This decision expands the platform design, not the current Kestrel acceptance
+criteria. Kestrel remains an HTML/CSS/C++ application with no JavaScript runtime
+and no runtime HTML parsing. Mixed-language support must later be verified with
+bidirectional calls, shared-node mutations, events, lifetime/cleanup tests and a
+real incremental migration example. This ADR does not claim those tests or the
+complete integration exist today.

docs/design/evidence/hybrid-kestrel/pan.json

@@ -0,0 +1,11 @@
+{
+  "actual_presentations": 719,
+  "pan_seconds": 11.999957999985781,
+  "presentation_hz": 59.91625597367178,
+  "median_interval_ms": 16.66675000160467,
+  "p95_interval_ms": 16.66683300572913,
+  "max_interval_ms": 33.33350000320934,
+  "submit_to_present_median_ms": 47.388667007908225,
+  "rss_after_pan_kib": 297872,
+  "note": "Submit-to-present is not input-to-photon latency. RSS sampled after benchmark, not peak."
+}

docs/design/evidence/hybrid-kestrel/parity.json

@@ -0,0 +1,29 @@
+[
+  {
+    "width": 1280,
+    "height": 800,
+    "theme": "dark",
+    "tab": "Home",
+    "parsed_nodes": 376,
+    "compiled_nodes": 376,
+    "differences": []
+  },
+  {
+    "width": 980,
+    "height": 620,
+    "theme": "dark",
+    "tab": "Text",
+    "parsed_nodes": 298,
+    "compiled_nodes": 298,
+    "differences": []
+  },
+  {
+    "width": 1440,
+    "height": 900,
+    "theme": "light",
+    "tab": "Drafting",
+    "parsed_nodes": 311,
+    "compiled_nodes": 311,
+    "differences": []
+  }
+]

docs/design/evidence/hybrid-kestrel/smoke.json

@@ -0,0 +1,183 @@
+{
+  "checks": [
+    {
+      "ribbon": "Home",
+      "buttons": 30
+    },
+    {
+      "ribbon": "Insert",
+      "buttons": 17
+    },
+    {
+      "ribbon": "Annotate",
+      "buttons": 18
+    },
+    {
+      "ribbon": "Model",
+      "buttons": 27
+    },
+    {
+      "ribbon": "View",
+      "buttons": 25
+    },
+    {
+      "ribbon": "Manage",
+      "buttons": 19
+    },
+    {
+      "ribbon": "Drafting",
+      "buttons": 22
+    },
+    {
+      "ribbon": "Solids",
+      "buttons": 30
+    },
+    {
+      "ribbon": "Parametric",
+      "buttons": 17
+    },
+    {
+      "ribbon": "Assembly",
+      "buttons": 10
+    },
+    {
+      "ribbon": "Blocks",
+      "buttons": 11
+    },
+    {
+      "ribbon": "Text",
+      "buttons": 19
+    },
+    {
+      "ribbon": "Exchange",
+      "buttons": 10
+    },
+    {
+      "ribbon": "Productivity",
+      "buttons": 10
+    },
+    {
+      "command": "layers",
+      "ok": true,
+      "title": "Layer manager"
+    },
+    {
+      "command": "new-layer",
+      "ok": true,
+      "title": "Create layer"
+    },
+    {
+      "command": "units",
+      "ok": true,
+      "title": "Drawing units & precision"
+    },
+    {
+      "command": "help",
+      "ok": true,
+      "title": "Welcome to Kestrel CAD"
+    },
+    {
+      "command": "diagnostics",
+      "ok": true,
+      "title": "Renderer diagnostics"
+    },
+    {
+      "command": "palette",
+      "ok": true,
+      "title": "Renderer diagnostics"
+    },
+    {
+      "command": "group",
+      "ok": false,
+      "error": "Error: Select at least 2 editable objects first."
+    },
+    {
+      "command": "text",
+      "ok": true,
+      "title": "Create text"
+    },
+    {
+      "command": "dimension",
+      "ok": true,
+      "title": "Create text"
+    },
+    {
+      "command": "hatch",
+      "ok": true,
+      "title": "Create text"
+    },
+    {
+      "command": "array",
+      "ok": false,
+      "error": "Error: Select an editable object first."
+    },
+    {
+      "command": "transform3d",
+      "ok": false,
+      "error": "Error: Select an editable object first."
+    },
+    {
+      "command": "dwg-setup",
+      "ok": true,
+      "title": "DWG codec status"
+    },
+    {
+      "command": "mtext",
+      "ok": true,
+      "title": "Create rich MTEXT"
+    },
+    {
+      "command": "dimstyles",
+      "ok": true,
+      "title": "Dimension styles"
+    },
+    {
+      "command": "leader",
+      "ok": true,
+      "title": "Create leader"
+    },
+    {
+      "command": "table",
+      "ok": true,
+      "title": "Create table"
+    },
+    {
+      "command": "stretch",
+      "ok": true,
+      "title": "Stretch crossing vertices"
+    },
+    {
+      "command": "layout-manager",
+      "ok": true,
+      "title": "Scaled paper layouts"
+    },
+    {
+      "command": "ucs-manager",
+      "ok": true,
+      "title": "User coordinate system"
+    }
+  ],
+  "startup": {
+    "entities": 265,
+    "nodes": 781,
+    "backend": "Canvas 2D \u00b7 Compatibility"
+  },
+  "strict": true,
+  "mtext_preview": {
+    "nodes": 4,
+    "report": "2 lines, 120.00 \u00d7 16.67 mm. "
+  },
+  "history": {
+    "n": 265,
+    "added": 266,
+    "undone": 265,
+    "redone": 266
+  },
+  "worker_available": true,
+  "dxf_export": {
+    "length": 53542,
+    "eof": true
+  },
+  "caught_failures": [],
+  "errors": []
+}