@cynodia/axiom-compiler 0.6.0-alpha.1 → 0.6.2-alpha.1

package/README.md

@@ -20,13 +20,13 @@ Main exports: `compileToIR`, `compileToHtml`, `createThemeStylesheet`,
 ## Installation
 
 ```bash
-npm install @cynodia/axiom-compiler@alpha
+npm install @cynodia/axiom-compiler
 ```
 
 Most applications should install the facade package instead, which re-exports this one:
 
 ```bash
-npm install @cynodia/axiom@alpha
+npm install @cynodia/axiom
 ```
 
 

package/dist/codegen.d.ts

@@ -1,7 +1,23 @@
 import type { ApplicationGraph, ApplicationIR, Appearance } from '@cynodia/axiom-core';
 import type { CompileOptions } from './normalize.js';
+/**
+ * How a generated page reaches its authority.
+ *
+ * `true` means the standard semantic endpoint on the current origin, which is what the
+ * reference host serves — so an application with server-authoritative state needs no
+ * endpoint string and no gateway code of its own.
+ */
+export type RemoteOption = boolean | {
+    endpoint?: string;
+    timeoutMs?: number;
+};
 export interface HtmlOptions extends CompileOptions {
     title?: string;
+    /**
+     * Configure the page to talk to an authority. Omitted, it defaults to `true` whenever the
+     * IR contains a remote action, because such a page cannot work without one.
+     */
+    remote?: RemoteOption;
     /**
      * Pins the appearance of the emitted page. Omitted, the theme decides — and a theme set
      * to `system` follows the reader's own preference.

package/dist/codegen.js

@@ -21,6 +21,24 @@ export function compileIRToHtml(ir, options = {}) {
     const title = options.title ?? ir.name;
     const stylesheet = createThemeStylesheet(ir.theme);
     const appearance = options.appearance ?? (ir.theme.appearance === 'system' ? undefined : ir.theme.appearance);
+    // A page with remote actions is not usable without a gateway, so one is configured by
+    // default rather than left for an author to discover.
+    const needsRemote = (ir.remoteActionIds ?? []).length > 0;
+    const remote = options.remote ?? needsRemote;
+    const remoteConfig = remote === false
+        ? null
+        : {
+            endpoint: (remote === true ? undefined : remote.endpoint) ?? '/axiom',
+            ...(remote !== true && remote.timeoutMs !== undefined ? { timeoutMs: remote.timeoutMs } : {}),
+        };
+    const bootstrap = remoteConfig
+        ? [
+            `const __axiomRemote = createHttpRemoteGateway(${JSON.stringify(remoteConfig)});`,
+            'const __axiomApp = createAxiomRuntime({ ir: __AXIOM_IR__, rootElement: __axiomRoot, host: createBrowserHost(), remote: __axiomRemote });',
+        ]
+        : [
+            'const __axiomApp = createAxiomRuntime({ ir: __AXIOM_IR__, rootElement: __axiomRoot, host: createBrowserHost() });',
+        ];
     return [
         '<!DOCTYPE html>',
         `<html lang="en"${appearance ? ` data-axiom-appearance="${appearance}"` : ''}>`,
@@ -38,8 +56,10 @@ export function compileIRToHtml(ir, options = {}) {
         runtimeSource,
         `const __AXIOM_IR__ = ${payload};`,
         'const __axiomRoot = document.getElementById("app");',
-        'const __axiomApp = createAxiomRuntime({ ir: __AXIOM_IR__, rootElement: __axiomRoot, host: createBrowserHost() });',
+        ...bootstrap,
         'globalThis.__AXIOM_APP__ = __axiomApp;',
+        // `start()` is the whole startup sequence: it renders synchronously and then loads
+        // authoritative state when a gateway is configured.
         '__axiomApp.start();',
         '  </script>',
         '</body>',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cynodia/axiom-compiler",
-  "version": "0.6.0-alpha.1",
+  "version": "0.6.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.6.0-alpha.1",
-    "@cynodia/axiom-runtime": "0.6.0-alpha.1"
+    "@cynodia/axiom-core": "0.6.2-alpha.1",
+    "@cynodia/axiom-runtime": "0.6.2-alpha.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.test.json",