@cynodia/axiom-compiler 0.5.0-alpha.1 → 0.5.2-alpha.1

package/README.md

@@ -9,11 +9,14 @@ Validates an Application Graph, normalizes it into a runtime-ready IR, and emits
 self-contained HTML page with the runtime inlined.
 
 Normalization resolves presentation once — renderer defaults, theme, inheritance, semantic
-inference, node declarations and responsive overrides — and puts the result in the IR,
-still as roles and tokens rather than CSS. `createThemeStylesheet` is the web renderer's
+inference, node declarations and responsive overrides — and puts the result in the IR, still
+as roles and tokens rather than CSS. `createThemeStylesheet` is the web renderer's
 translation of a theme into CSS custom properties and rules, and is the only place in the
 framework that decides a role is a colour.
 
+Main exports: `compileToIR`, `compileToHtml`, `createThemeStylesheet`,
+`GraphValidationError`.
+
 ## Installation
 
 ```bash
@@ -26,6 +29,13 @@ Most applications should install the facade package instead, which re-exports th
 npm install @cynodia/axiom@alpha
 ```
 
+
+## Documentation
+
+The canonical operational contract lives in the `docs/` directory of the
+[`@cynodia/axiom`](https://www.npmjs.com/package/@cynodia/axiom) package, and in
+[the repository](https://github.com/cynodia/axiom). Start with `docs/AGENT_REFERENCE.md`.
+
 ## License
 
 MIT

package/dist/normalize.js

@@ -1,4 +1,4 @@
-import { actionGuards, inferLocationType, locationFieldIds, locationRootStateId, resolvePresentationMap, semanticContextFromGraph, validateGraph, } from '@cynodia/axiom-core';
+import { actionGuards, inferExpressionType, inferLocationType, itemTypeOf, locationFieldIds, locationRootStateId, resolvePresentationMap, semanticContextFromGraph, validateGraph, } from '@cynodia/axiom-core';
 import { isUINode } from '@cynodia/axiom-core';
 export class GraphValidationError extends Error {
     problems;
@@ -112,6 +112,24 @@ export function compileToIR(graph, options = {}) {
             ? graph.getField(addressed)?.field.required === true
             : resolved !== undefined && resolved.kind !== 'optional';
     }
+    // Which field distinguishes the members of each repeat, so the renderer can give every
+    // rendered instance a stable identity without inferring anything itself.
+    const repeatIdentityFields = {};
+    for (const node of Object.values(uiNodes)) {
+        if (node.kind !== 'repeat') {
+            continue;
+        }
+        const sourceType = inferExpressionType(node.source, semantics);
+        const item = itemTypeOf(sourceType);
+        const resolved = item?.kind === 'optional' ? item.valueType : item;
+        if (resolved?.kind !== 'entity') {
+            continue;
+        }
+        const identity = graph.getNode(resolved.entityId)?.identityFieldId;
+        if (identity) {
+            repeatIdentityFields[node.id] = identity;
+        }
+    }
     // Presentation is normalized here, once: renderer defaults, theme, inheritance,
     // semantic inference, node declarations and responsive overrides are all decided before
     // a renderer sees them. What lands in the IR is still semantic — roles and tokens, not
@@ -135,6 +153,7 @@ export function compileToIR(graph, options = {}) {
         locationTypes,
         locationRoots,
         locationRequired,
+        repeatIdentityFields,
         theme,
         presentation,
     };

package/dist/stylesheet.js

@@ -308,7 +308,7 @@ body {
 .axiom-input-description { color: var(--axiom-color-text-muted); font-size: ${theme.typography.roles.caption.size}px; }
 .axiom-required-marker { color: var(--axiom-color-destructive); margin-left: 2px; }
 
-.axiom-control {
+input.axiom-control, select.axiom-control, textarea.axiom-control, .axiom-control {
   font: inherit;
   color: var(--axiom-color-text);
   background: var(--axiom-color-surface);
@@ -327,24 +327,33 @@ input[type="checkbox"].axiom-control { width: 1.15em; height: 1.15em; min-height
 .axiom-control:disabled { opacity: 0.6; }
 .axiom-control[aria-invalid="true"] { border-color: var(--axiom-color-destructive); }
 
-.axiom-button {
+button.axiom-button {
   font: inherit;
   font-weight: 560;
+  /* The internal arrangement comes from the theme's button metrics, so no application
+     has to restate layout and padding on every control. */
   display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: ${space('xsmall')};
+  flex-direction: ${theme.buttons.layout === 'vertical' ? 'column' : 'row'};
+  align-items: ${ALIGN_VALUES[theme.buttons.align]};
+  justify-content: ${JUSTIFY_VALUES[theme.buttons.justify]};
+  gap: ${space(theme.buttons.gap)};
   min-height: var(--axiom-control-height);
-  padding: 0 calc(var(--axiom-control-padding-x) * 1.15);
+  padding: 0 calc(var(--axiom-control-padding-x) * ${theme.buttons.paddingScale});
   border: var(--axiom-control-border) solid transparent;
   border-radius: var(--axiom-control-radius);
   background: var(--axiom-color-surface);
   color: var(--axiom-color-text);
   cursor: pointer;
   white-space: nowrap;
+  text-align: center;
 }
-.axiom-button:hover { filter: brightness(0.96); }
-.axiom-button:active { transform: translateY(1px); }
+button.axiom-button:hover { filter: brightness(0.96); }
+button.axiom-button:active { transform: translateY(1px); }
+/* A button's own contents are laid out by the theme; a layout token on the node refines
+   the direction without giving up the control's metrics. */
+button.axiom-button.axiom-layout-vertical { flex-direction: column; }
+button.axiom-button.axiom-layout-horizontal { flex-direction: row; }
+.axiom-button > .axiom-button-label { white-space: nowrap; }
 
 :focus-visible { outline: var(--axiom-focus-width) solid var(--axiom-color-focus); outline-offset: 1px; }
 
@@ -352,6 +361,8 @@ input[type="checkbox"].axiom-control { width: 1.15em; height: 1.15em; min-height
 .axiom-ux-empty-state { text-align: center; }
 .axiom-ux-form-section + .axiom-ux-form-section { padding-top: ${space('small')}; border-top: 1px solid var(--axiom-color-border); }
 
+.axiom-diagnostic[data-empty="true"] { display: none; }
+.axiom-diagnostic-entry { color: inherit; }
 .axiom-no-route { padding: ${space('large')}; background: var(--axiom-color-surface); border-radius: var(--axiom-radius-medium); }
 .axiom-diagnostics { list-style: none; margin: 0; padding: 0; }
 `.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cynodia/axiom-compiler",
-  "version": "0.5.0-alpha.1",
+  "version": "0.5.2-alpha.1",
   "description": "Normalizes an Axiom application graph and emits a self-contained page.",
   "license": "MIT",
   "author": "AskTech AS",
@@ -31,8 +31,8 @@
     }
   },
   "dependencies": {
-    "@cynodia/axiom-core": "0.5.0-alpha.1",
-    "@cynodia/axiom-runtime": "0.5.0-alpha.1"
+    "@cynodia/axiom-core": "0.5.2-alpha.1",
+    "@cynodia/axiom-runtime": "0.5.2-alpha.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.test.json",