@echelon-foundry/design-system 0.4.0-main.220.2 → 0.4.0-main.222.1

package/contracts/machine-operability.json

@@ -0,0 +1,48 @@
+{
+  "name": "forma-machine-operability",
+  "version": "1.0.0",
+  "referenceAutomation": "Playwright",
+  "toolNeutral": true,
+  "principle": "Every human-operable action has a deterministic semantically discoverable machine-operable path to the same authoritative application state.",
+  "locatorPriority": [
+    "role-and-accessible-name",
+    "native-label-id-name-value-or-url-target",
+    "documented-application-owned-stable-object-identity",
+    "documented-public-state-hook-for-inspection"
+  ],
+  "completionSignals": [
+    "native-state-change",
+    "documented-public-state-change",
+    "navigation-or-url-change",
+    "live-or-status-output",
+    "authoritative-application-state-rendered-into-the-dom"
+  ],
+  "directManipulation": {
+    "coordinateGestureMayBeConvenience": true,
+    "semanticEquivalentRequiredForMeaningfulStateChanges": true,
+    "examples": [
+      "move-buttons",
+      "named-commands",
+      "keyboard-actions",
+      "form-controls",
+      "application-or-limen-command-surface"
+    ]
+  },
+  "forbiddenAsOnlyPublicPath": [
+    "hard-coded-screen-coordinates",
+    "image-recognition",
+    "hover-only-actions",
+    "pointer-only-actions",
+    "generated-css-class-locators",
+    "dom-position-or-nth-child-locators",
+    "fixed-sleep-completion",
+    "color-only-state",
+    "animation-only-state",
+    "closed-shadow-dom-hiding-required-interaction"
+  ],
+  "authority": {
+    "forma": "semantic markup, accessible naming, public structure and presentation-state hooks",
+    "applicationOrLimen": "behavior beyond native HTML and application state synchronization",
+    "ordoOrDomain": "legality, capabilities, obligations, permissions and consequential transitions"
+  }
+}

package/dist/build-metrics.json

@@ -321,7 +321,7 @@
     "patterns/skeleton.html": 354,
     "patterns/skip-link.html": 186,
     "patterns/slider.html": 403,
-    "patterns/spatial-canvas.html": 951,
+    "patterns/spatial-canvas.html": 976,
     "patterns/special-choice.html": 568,
     "patterns/spinner.html": 175,
     "patterns/split-pane.html": 348,

package/dist/patterns/spatial-canvas.html

@@ -5,8 +5,8 @@
   </header>
   <div class="ef-spatial-canvas__viewport" tabindex="0" aria-label="Scrollable system map">
     <div class="ef-spatial-canvas__surface">
-      <article class="ef-surface"><h3>Billing</h3><p>Selected node</p></article>
-      <article class="ef-surface"><h3>Chrona</h3><p>Time source</p></article>
+      <article class="ef-surface" id="billing"><h3>Billing</h3><p>Selected node</p></article>
+      <article class="ef-surface" id="chrona"><h3>Chrona</h3><p>Time source</p></article>
     </div>
   </div>
   <details class="ef-spatial-canvas__index"><summary>Objects in this view</summary><nav aria-label="Canvas objects"><a href="#billing">Billing</a><a href="#chrona">Chrona</a></nav></details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@echelon-foundry/design-system",
-  "version": "0.4.0-main.220.2",
+  "version": "0.4.0-main.222.1",
   "private": false,
   "type": "module",
   "description": "Zero-runtime HTML and CSS design system for Echelon Foundry applications.",
@@ -27,7 +27,8 @@
     "./contracts/diagram-presentation.json": "./contracts/diagram-presentation.json",
     "./workflow/forma-workflow.schema.json": "./schemas/workflow/1.0/forma-workflow.schema.json",
     "./contracts/workflow-capabilities.json": "./contracts/workflow-capabilities.json",
-    "./workflow/examples/*": "./examples/workflows/forma/workflows/*"
+    "./workflow/examples/*": "./examples/workflows/forma/workflows/*",
+    "./contracts/machine-operability.json": "./contracts/machine-operability.json"
   },
   "files": [
     "dist",
@@ -42,7 +43,8 @@
     "contracts/workflow-capabilities.json",
     "examples/workflows/forma/workflows",
     "examples/workflows/fixtures.json",
-    "docs/workflow"
+    "docs/workflow",
+    "contracts/machine-operability.json"
   ],
   "scripts": {
     "clean": "node tools/clean.mjs",
@@ -71,7 +73,7 @@
     "test:marketing": "node --test tests/marketing-tokens.test.mjs tests/marketing-distribution.test.mjs tests/marketing-structure.test.mjs tests/site-css-policy.test.mjs",
     "example:install": "mkdir -p build/example && cp examples/echelon-marketing-site/forma.lock build/example/forma.lock && bash actions/install-presentation/install.sh --lock build/example/forma.lock --source dist/marketing --update --output examples/echelon-marketing-site/assets/forma",
     "policy:check": "dotnet run --project tools/SiteCssPolicy/SiteCssPolicy.fsproj --",
-    "release:check": "npm run build && npm run test:tokens && npm run test:brands && npm run test:runtime && npm run test:motion && npm run test:marketing && npm run test:character-grid && npm run test:css && npm run test:package && playwright test tests/browser/marketing.spec.mjs && npm run site:check",
+    "release:check": "npm run build && npm run test:tokens && npm run test:brands && npm run test:runtime && npm run test:motion && npm run test:marketing && npm run test:character-grid && npm run test:css && npm run test:package && npm run test:machine && playwright test tests/browser/marketing.spec.mjs && npm run site:check",
     "test:figma": "node --test tests/figma-contract.test.mjs",
     "catalog:check": "node tools/catalog/validate.mjs && node tools/catalog/inventory.mjs --check",
     "catalog:inventory": "node tools/catalog/inventory.mjs",
@@ -80,7 +82,8 @@
     "workflow:validate": "dotnet run --project src/workflow/Forma.Workflow.Cli -c Release -- validate examples/workflows/forma/workflows/*.forma-workflow.json",
     "test:workflow-package": "node --test tests/workflow-package.test.mjs",
     "test:workflow-browser": "playwright test tests/browser/workflow-static.spec.mjs tests/browser/workflow-embed.spec.mjs",
-    "workflow:check": "npm run workflow:test && npm run workflow:build && npm run test:workflow-package && npm run test:workflow-browser"
+    "workflow:check": "npm run workflow:test && npm run workflow:build && npm run test:workflow-package && npm run test:workflow-browser",
+    "test:machine": "playwright test tests/browser/machine-operability.spec.mjs"
   },
   "devDependencies": {
     "@axe-core/playwright": "4.13.0",
@@ -100,6 +103,7 @@
     "zero-runtime",
     "marketing-presentation",
     "accessibility",
-    "workflow"
+    "workflow",
+    "machine-operability"
   ]
 }

package/patterns/spatial-canvas.html

@@ -5,8 +5,8 @@
   </header>
   <div class="ef-spatial-canvas__viewport" tabindex="0" aria-label="Scrollable system map">
     <div class="ef-spatial-canvas__surface">
-      <article class="ef-surface"><h3>Billing</h3><p>Selected node</p></article>
-      <article class="ef-surface"><h3>Chrona</h3><p>Time source</p></article>
+      <article class="ef-surface" id="billing"><h3>Billing</h3><p>Selected node</p></article>
+      <article class="ef-surface" id="chrona"><h3>Chrona</h3><p>Time source</p></article>
     </div>
   </div>
   <details class="ef-spatial-canvas__index"><summary>Objects in this view</summary><nav aria-label="Canvas objects"><a href="#billing">Billing</a><a href="#chrona">Chrona</a></nav></details>