@xenosystem/blocks 0.1.0 → 0.2.0

package/dist/auth/index.d.ts

@@ -3,6 +3,7 @@ import { ReactNode } from 'react';
 import { PanelModule, PanelManifest } from '@xenosystem/panel-sdk';
 import { XenoAccountStatus, XenoAccountIdentity, XenoAccountActionKind } from '@xenosystem/panel-account';
 export * from '@xenosystem/panel-account';
+import { BlockDeclaration } from '@xenosystem/block-sdk';
 
 interface CreateAuthGatePanelOptions {
     /** What renders behind the gate once it is `open`. A product passes its app; the harness a fixture. */
@@ -116,6 +117,107 @@ interface AuthGateViewProps {
     heroSrc?: string;
     now?: () => number;
 }
-declare function AuthGateView({ controller, productName, children, heroSrc, now }: AuthGateViewProps): react.JSX.Element;
+declare function AuthGateView$1({ controller, productName, children, heroSrc, now }: AuthGateViewProps): react.JSX.Element;
 
-export { AUTH_GATE_INITIAL, AUTH_GATE_PANEL_ID, AuthGateController, type AuthGateHostBridge, AuthGateView, type AuthGateViewProps, type CreateAuthGatePanelOptions, PHASE_INTENTS, type XenoAuthGateIntent, type XenoAuthGateIntentKind, type XenoAuthGatePhase, type XenoAuthGateState, type XenoLicenceState, authGateManifest, authGatePanel, createAuthGatePanel, deriveAuthGatePhase, formatSince, hostContradiction, intentOffered };
+/**
+ * The auth gate AS A DECLARATION — the first block written the way `xeno-apps/SPEC.md` §8d says every
+ * block is: components + bindings + the manifest, with ONE behaviour (`auth/authGateView`) for the only
+ * logic it has. The code view (`AuthGateView`) and this declaration render the same door from the same
+ * behaviour; `test/auth-gate.declaration.test.tsx` holds them equal in every phase.
+ *
+ * Inputs: `state` (the host's `XenoAuthGateState` push). Output: `intent` ({ kind }). Config:
+ * `productName`. The door opens (renders the app behind it) when `view.open` — a host that mounts the
+ * declaration passes its app as the composition's `children` slot.
+ */
+
+declare const AUTH_GATE_DECLARATION: BlockDeclaration;
+
+/**
+ * `authGateView` — the gate's ONE behaviour: host state + product → the view model the door renders.
+ * Pure. Used by the code view (`AuthGateView`) AND by the declaration (`AUTH_GATE_DECLARATION`,
+ * `behaviour: 'auth/authGateView'`), so there is exactly one derivation of copy and offered actions.
+ * `xeno-apps/SPEC.md` §8d: "code only where a block genuinely needs a behaviour" — this is that code.
+ */
+
+interface AuthGateAction {
+    id: string;
+    label: string;
+    variant: 'primary' | 'quiet';
+    disabled?: boolean;
+}
+interface AuthGateView {
+    phase: XenoAuthGatePhase;
+    open: boolean;
+    closed: boolean;
+    productName: string;
+    rootAttributes: Record<string, string>;
+    label: string;
+    hero: {
+        headline: string;
+        lead: string;
+        stats: {
+            value: string;
+            label: string;
+        }[];
+    };
+    tag?: string;
+    title: string;
+    body: string;
+    note?: string;
+    warning?: string;
+    identity?: string;
+    actions: AuthGateAction[];
+}
+declare function authGateView(state: XenoAuthGateState, productName: string, now?: number): AuthGateView;
+declare function plateCopy(phase: XenoAuthGatePhase, product: string, message: string | undefined, since: string | null): {
+    tag?: string;
+    title: string;
+    body: string;
+    note?: string;
+};
+/** The registry entry a host merges in: `behaviour: 'auth/authGateView'` → (inputs, config) → view. */
+declare const BEHAVIOURS: {
+    'auth/authGateView': (inputs: Record<string, unknown>, config: Readonly<Record<string, unknown>>) => AuthGateView;
+};
+
+/**
+ * `mountXenoAuthGate` — the per-product plug, exactly as `XENO AUTH - AUTH GATE DELTA.md` §4 specifies:
+ *
+ *   mountXenoAuthGate(root, {
+ *     product:  { slug: 'canvas', name: 'XENO Canvas' },
+ *     bridge:   window.xenoAuthGate,          // preload-exposed: subscribe(state) + send(intent)
+ *     children: () => renderTheApp(),         // called ONLY once phase === 'open'
+ *   })
+ *
+ * A product is NOT a workbench host, so it does not go through `createAuthGatePanel` (a PanelModule
+ * that needs a PanelHost). This mounts the same controller + view directly over a two-verb bridge:
+ * the host pushes state, the gate emits intents, nothing else crosses. The gate holds no token and
+ * calls no SDK (LICENCE-ENFORCEMENT §1: main process, never the renderer).
+ *
+ * Not per product: the design, the copy, the phase derivation. A product that edits those has found a
+ * gate defect, fixed once here — MOVE, never port.
+ */
+
+interface XenoAuthGateBridge {
+    /** Receive every state push; returns the unsubscribe. The host pushes the current state on subscribe. */
+    subscribe: (listener: (state: XenoAuthGateState) => void) => () => void;
+    /** Route an intent to the host (main process). */
+    send: (intent: XenoAuthGateIntent) => void;
+}
+interface MountXenoAuthGateOptions {
+    product: {
+        slug: string;
+        name: string;
+    };
+    bridge: XenoAuthGateBridge;
+    /** Rendered ONLY when the phase is `open`. */
+    children: () => ReactNode;
+    heroSrc?: string;
+}
+interface MountedXenoAuthGate {
+    controller: AuthGateController;
+    unmount: () => void;
+}
+declare function mountXenoAuthGate(root: HTMLElement, options: MountXenoAuthGateOptions): MountedXenoAuthGate;
+
+export { AUTH_GATE_DECLARATION, AUTH_GATE_INITIAL, AUTH_GATE_PANEL_ID, type AuthGateAction, AuthGateController, type AuthGateHostBridge, AuthGateView$1 as AuthGateView, type AuthGateView as AuthGateViewModel, type AuthGateViewProps, BEHAVIOURS, type CreateAuthGatePanelOptions, type MountXenoAuthGateOptions, type MountedXenoAuthGate, PHASE_INTENTS, type XenoAuthGateBridge, type XenoAuthGateIntent, type XenoAuthGateIntentKind, type XenoAuthGatePhase, type XenoAuthGateState, type XenoLicenceState, authGateManifest, authGatePanel, authGateView, createAuthGatePanel, deriveAuthGatePhase, formatSince, hostContradiction, intentOffered, mountXenoAuthGate, plateCopy };

package/dist/auth/index.js

@@ -127,15 +127,12 @@ var authGateManifest = {
 // src/auth/gate/react/AuthGateView.tsx
 import { useEffect, useState } from "react";
 import { AuthDoor, SignInForm } from "@xenosystem/components/auth";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-function AuthGateView({ controller, productName, children, heroSrc, now = () => Date.now() }) {
-  const [, force] = useState(0);
-  useEffect(() => controller.subscribe(() => force((n) => n + 1)), [controller]);
-  const phase = controller.getPhase();
-  if (phase === "open") return /* @__PURE__ */ jsx(Fragment, { children });
-  const state = controller.getState();
-  const copy = plateCopy(phase, productName, state.message, formatSince(state.lastVerifiedAt, now()));
-  const action = (id, label, variant = "primary") => controller.offers(id) ? [{ id, label, variant, onClick: () => controller.intend(id) }] : [];
+
+// src/auth/gate/behaviour.ts
+function authGateView(state, productName, now = Date.now()) {
+  const phase = deriveAuthGatePhase(state);
+  const copy = plateCopy(phase, productName, state.message, formatSince(state.lastVerifiedAt, now));
+  const action = (id, label, variant = "primary") => intentOffered(state, id) ? [{ id, label, variant }] : [];
   const actions = [
     ...phase === "sign-in" && state.pending ? [{ id: "pending", label: "Finish in your browser\u2026", variant: "primary", disabled: true }] : [],
     ...action("signIn", "Sign in to XENO"),
@@ -145,41 +142,26 @@ function AuthGateView({ controller, productName, children, heroSrc, now = () =>
     ...action("refresh", phase === "unlicensed" || phase === "expired-offline" ? "Check again" : "Try again", phase === "unlicensed" ? "quiet" : "primary"),
     ...action("signOut", "Sign out", "quiet")
   ];
-  const identity = state.identity && phase !== "sign-in" ? state.identity.email ?? state.identity.name ?? state.identity.sub : void 0;
-  return /* @__PURE__ */ jsx(
-    AuthDoor,
-    {
-      label: `${productName} sign-in`,
-      rootAttributes: { "data-xeno-auth-gate": phase },
-      hero: {
-        imageSrc: heroSrc,
-        headline: /* @__PURE__ */ jsxs(Fragment, { children: [
-          "One account.",
-          /* @__PURE__ */ jsx("br", {}),
-          "Every XENO product."
-        ] }),
-        lead: `Sign in once and ${productName} \u2014 and every other XENO app \u2014 runs under your plan, your credits and your files.`,
-        stats: [
-          { value: "1", label: "Account" },
-          { value: "Yours", label: "Files stay put" },
-          { value: "Browser", label: "Sign-in, never in-app" }
-        ]
-      },
-      children: /* @__PURE__ */ jsx(
-        SignInForm,
-        {
-          phase,
-          tag: copy.tag,
-          title: copy.title,
-          body: copy.body,
-          actions,
-          note: phase === "sign-in" && !state.pending ? `Your browser opens at xenostudio.ai, where you can continue with Google, GitHub or email. ${productName} never sees your password.` : void 0,
-          warning: copy.note,
-          identity
-        }
-      )
-    }
-  );
+  return {
+    phase,
+    open: phase === "open",
+    closed: phase !== "open",
+    productName,
+    rootAttributes: { "data-xeno-auth-gate": phase },
+    label: `${productName} sign-in`,
+    hero: {
+      headline: "One account.\nEvery XENO product.",
+      lead: `Sign in once and ${productName} \u2014 and every other XENO app \u2014 runs under your plan, your credits and your files.`,
+      stats: [{ value: "1", label: "Account" }, { value: "Yours", label: "Files stay put" }, { value: "Browser", label: "Sign-in, never in-app" }]
+    },
+    tag: copy.tag,
+    title: copy.title,
+    body: copy.body,
+    note: phase === "sign-in" && !state.pending ? `Your browser opens at xenostudio.ai, where you can continue with Google, GitHub or email. ${productName} never sees your password.` : void 0,
+    warning: copy.note,
+    identity: state.identity && phase !== "sign-in" ? state.identity.email ?? state.identity.name ?? state.identity.sub : void 0,
+    actions
+  };
 }
 function plateCopy(phase, product, message, since) {
   switch (phase) {
@@ -199,6 +181,41 @@ function plateCopy(phase, product, message, since) {
       return { title: "", body: "" };
   }
 }
+var BEHAVIOURS = {
+  "auth/authGateView": (inputs, config) => authGateView(inputs.state ?? { account: "unknown", licence: "checking", sdk: "ready" }, typeof config.productName === "string" && config.productName ? config.productName : "XENO")
+};
+
+// src/auth/gate/react/AuthGateView.tsx
+import { Fragment, jsx } from "react/jsx-runtime";
+function AuthGateView({ controller, productName, children, heroSrc, now = () => Date.now() }) {
+  const [, force] = useState(0);
+  useEffect(() => controller.subscribe(() => force((n) => n + 1)), [controller]);
+  const phase = controller.getPhase();
+  if (phase === "open") return /* @__PURE__ */ jsx(Fragment, { children });
+  const v = authGateView(controller.getState(), productName, now());
+  const actions = v.actions.map((a) => ({ ...a, onClick: a.disabled ? void 0 : () => controller.intend(a.id) }));
+  return /* @__PURE__ */ jsx(
+    AuthDoor,
+    {
+      label: v.label,
+      rootAttributes: { "data-xeno-auth-gate": phase },
+      hero: { imageSrc: heroSrc, headline: v.hero.headline, lead: v.hero.lead, stats: v.hero.stats },
+      children: /* @__PURE__ */ jsx(
+        SignInForm,
+        {
+          phase,
+          tag: v.tag,
+          title: v.title,
+          body: v.body,
+          actions,
+          note: v.note,
+          warning: v.warning,
+          identity: v.identity
+        }
+      )
+    }
+  );
+}
 
 // src/auth/gate/panel.ts
 function createAuthGatePanel(options = {}) {
@@ -256,19 +273,95 @@ function createAuthGatePanel(options = {}) {
 }
 var authGatePanel = createAuthGatePanel();
 
+// src/auth/gate/declaration.ts
+var AUTH_GATE_DECLARATION = {
+  format: "xeno.block@1",
+  manifest: authGateManifest,
+  behaviour: "auth/authGateView",
+  composition: {
+    component: "fragment",
+    children: [
+      { component: "slot", when: { input: "view.open" } },
+      {
+        component: "auth/AuthDoor",
+        when: { input: "view.closed" },
+        props: {
+          label: { input: "view.label" },
+          rootAttributes: { input: "view.rootAttributes" },
+          hero: { input: "view.hero" }
+        },
+        children: [
+          {
+            component: "auth/SignInForm",
+            props: {
+              phase: { input: "view.phase" },
+              tag: { input: "view.tag" },
+              title: { input: "view.title" },
+              body: { input: "view.body" },
+              note: { input: "view.note" },
+              warning: { input: "view.warning" },
+              identity: { input: "view.identity" },
+              actions: { input: "view.actions" },
+              animate: { value: false }
+            },
+            on: {
+              onAction: { emit: "intent", value: { arg: "" } }
+            }
+          }
+        ]
+      }
+    ]
+  }
+};
+
+// src/auth/gate/mount.ts
+import { createElement as createElement2 } from "react";
+import { createRoot as createRoot2 } from "react-dom/client";
+function mountXenoAuthGate(root, options) {
+  const controller = new AuthGateController({ emit: (_port, value) => options.bridge.send(value) });
+  const reactRoot = createRoot2(root);
+  const draw = () => reactRoot.render(
+    createElement2(AuthGateView, {
+      controller,
+      productName: options.product.name,
+      heroSrc: options.heroSrc,
+      children: createElement2(Behind, { render: options.children })
+    })
+  );
+  const unsubscribe = options.bridge.subscribe((state) => controller.setState(state));
+  const stop = controller.subscribe(draw);
+  draw();
+  return {
+    controller,
+    unmount: () => {
+      stop();
+      unsubscribe();
+      reactRoot.unmount();
+    }
+  };
+}
+function Behind({ render }) {
+  return render();
+}
+
 // src/auth/index.ts
 export * from "@xenosystem/panel-account";
 export {
+  AUTH_GATE_DECLARATION,
   AUTH_GATE_INITIAL,
   AUTH_GATE_PANEL_ID,
   AuthGateController,
   AuthGateView,
+  BEHAVIOURS,
   PHASE_INTENTS,
   authGateManifest,
   authGatePanel,
+  authGateView,
   createAuthGatePanel,
   deriveAuthGatePhase,
   formatSince,
   hostContradiction,
-  intentOffered
+  intentOffered,
+  mountXenoAuthGate,
+  plateCopy
 };

package/dist/index.d.ts

@@ -4,6 +4,6 @@
  * `/agent`. This root re-exports nothing on purpose: import the family you mount, so a product
  * carries only it. Naming rule: `XENO PACKAGE NAMING - STANDARD.md`.
  */
-declare const BLOCKS_VERSION = "0.1.0";
+declare const BLOCKS_VERSION = "0.2.0";
 
 export { BLOCKS_VERSION };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var BLOCKS_VERSION = "0.1.0";
+var BLOCKS_VERSION = "0.2.0";
 export {
   BLOCKS_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenosystem/blocks",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "XENO Blocks — rung 3 of the front ladder: components composed into a contract-bearing unit (manifest: ports, intents, commands, agent surface), rendered by @xenosystem/workbench. ONE package, one subpath per family (/auth, /edit, /data, /time, /ops, /trust, /agent), one named export per block — XENO PACKAGE NAMING - STANDARD.md.",
   "license": "UNLICENSED",
   "type": "module",
@@ -26,26 +26,31 @@
     "test": "vitest run"
   },
   "peerDependencies": {
-    "@xenosystem/components": "^0.1.0",
+    "@xenosystem/components": "^0.6.0",
     "@xenosystem/elements-react": ">=0.0.1",
     "@xenosystem/panel-account": "^0.1.0",
     "@xenosystem/panel-sdk": "^1.1.0",
+    "@xenosystem/workbench": "^1.0.0",
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "@xenosystem/block-sdk": "^0.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@xenosystem/components": "^0.1.0",
+    "@xenosystem/components": "^0.6.0",
     "@xenosystem/elements-react": "0.0.1",
     "@xenosystem/panel-account": "^0.1.0",
     "@xenosystem/panel-sdk": "^1.1.0",
+    "@xenosystem/workbench": "^1.0.0",
+    "jsdom": "^26.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.0",
+    "@xenosystem/block-sdk": "^0.1.0"
   },
   "publishConfig": {
     "access": "public"