@almadar/shell-web 0.1.0 → 1.1.0

package/dist/UserContext-DqWeZkUZ.d.ts

@@ -1,100 +0,0 @@
-import React__default from 'react';
-import { UserContext as UserContext$1, FieldValue } from '@almadar/core';
-
-/**
- * UserContext
- *
- * React context for providing user data throughout the application.
- * Enables @user bindings in S-expressions for role-based UI and permissions.
- *
- * Usage:
- * ```tsx
- * // In App.tsx or layout
- * <UserProvider user={{ id: '123', role: 'admin', permissions: ['read', 'write'] }}>
- *   <App />
- * </UserProvider>
- *
- * // In components - access via hook
- * const { user, hasRole, hasPermission } = useUser();
- * if (hasRole('admin')) { ... }
- * if (hasPermission('delete')) { ... }
- * ```
- *
- * @packageDocumentation
- */
-
-/**
- * User data for `@user` bindings — the canonical `UserContext` from
- * `@almadar/core`, kept under this name for existing consumers. Declaring the
- * shape locally let it drift from the type both execution paths resolve against.
- */
-type UserData = UserContext$1;
-/**
- * User context value.
- */
-interface UserContextValue {
-    /** Current user data (null if not logged in) */
-    user: UserData | null;
-    /** Check if user is logged in */
-    isLoggedIn: boolean;
-    /** Check if user has a specific role */
-    hasRole: (role: string) => boolean;
-    /** Check if user has a specific permission */
-    hasPermission: (permission: string) => boolean;
-    /** Check if user has any of the specified roles */
-    hasAnyRole: (roles: string[]) => boolean;
-    /** Check if user has all of the specified permissions */
-    hasAllPermissions: (permissions: string[]) => boolean;
-    /** Get a user field by path (for @user.field bindings) */
-    getUserField: (path: string) => FieldValue | undefined;
-}
-declare const UserContext: React__default.Context<UserContextValue | null>;
-interface UserProviderProps {
-    /** User data (null if not logged in) */
-    user?: UserData | null;
-    /** Children to render */
-    children: React__default.ReactNode;
-}
-/**
- * Provider component that provides user context to the application.
- *
- * Provides RBAC helpers and field access for @user bindings.
- */
-declare function UserProvider({ user, children, }: UserProviderProps): React__default.ReactElement;
-/**
- * Hook to access the user context.
- *
- * Returns default values if used outside of UserProvider (for resilience).
- *
- * @example
- * ```tsx
- * function AdminPanel() {
- *   const { user, hasRole, hasPermission } = useUser();
- *
- *   if (!hasRole('admin') && !hasPermission('admin:access')) {
- *     return <AccessDenied />;
- *   }
- *
- *   return <div>Welcome, {user?.name}</div>;
- * }
- * ```
- */
-declare function useUser(): UserContextValue;
-/**
- * Hook to check if user has a specific role.
- * Convenience wrapper around useUser().hasRole().
- */
-declare function useHasRole(role: string): boolean;
-/**
- * Hook to check if user has a specific permission.
- * Convenience wrapper around useUser().hasPermission().
- */
-declare function useHasPermission(permission: string): boolean;
-/**
- * Hook to get user data for @user bindings in S-expressions.
- * Returns the user data object compatible with EvaluationContext.user
- */
-declare function useUserForEvaluation(): UserData | undefined;
-
-export { UserContext as U, UserProvider as c, useHasRole as e, useUser as f, useUserForEvaluation as g, useHasPermission as u };
-export type { UserContextValue as a, UserData as b, UserProviderProps as d };

package/dist/avl-3d-context-BIRKWpaL.d.ts

@@ -1,204 +0,0 @@
-import * as React from 'react';
-import { QuadraticBezierCurve3 } from 'three';
-
-/**
- * avl-3d-layout.ts
- *
- * Pure math utilities for 3D positioning of AVL visualization nodes.
- * The 3D equivalent of avl-layout.ts (2D positioning helpers).
- *
- * @packageDocumentation
- */
-
-interface Position3D {
-    x: number;
-    y: number;
-    z: number;
-}
-interface ExprTreeNode3D {
-    label: string;
-    type: 'operator' | 'literal' | 'binding';
-    children?: ExprTreeNode3D[];
-}
-interface TreeLayoutResult {
-    node: ExprTreeNode3D;
-    position: Position3D;
-}
-/**
- * Theme roles for the 3D scenes. three.js cannot evaluate CSS, so scenes read
- * these through `useAvl3DPalette()` (resolved against the active theme).
- */
-declare const AVL_3D_COLORS: {
-    readonly exprOperatorUnknown: "var(--color-muted-foreground)";
-    readonly exprBinding: "var(--color-accent)";
-    readonly exprLiteral: "var(--color-muted-foreground)";
-    readonly effectUi: string;
-    readonly effectData: string;
-    readonly effectCommunication: string;
-    readonly effectLifecycle: string;
-    readonly effectControl: string;
-    readonly effectAsync: string;
-    readonly effectCompute: string;
-    readonly effectSystem: string;
-    readonly effectUnknown: "var(--color-muted-foreground)";
-    readonly fieldParticle: "var(--color-foreground)";
-    readonly lightAmbient: "var(--color-info)";
-    readonly lightDirectional: string;
-    readonly lightFill: string;
-    readonly "op:arithmetic": string;
-    readonly "op:comparison": string;
-    readonly "op:logic": string;
-    readonly "op:control": string;
-    readonly "op:effect": string;
-    readonly "op:collection": string;
-    readonly "op:std-math": string;
-    readonly "op:std-str": string;
-    readonly "op:std-array": string;
-    readonly "op:std-object": string;
-    readonly "op:std-validate": string;
-    readonly "op:std-json": string;
-    readonly "op:std-csv": string;
-    readonly "op:std-time": string;
-    readonly "op:std-format": string;
-    readonly "op:std-i18n": string;
-    readonly "op:std-async": string;
-    readonly "op:std-nn": string;
-    readonly "op:std-tensor": string;
-    readonly "op:std-train": string;
-    readonly "op:std-prob": string;
-    readonly "op:std-os": string;
-    readonly "op:std-browser": string;
-    readonly "op:std-composition": string;
-    readonly "op:std-vec": string;
-    readonly "op:std-geo": string;
-    readonly "op:std-grid": string;
-    readonly "op:std-anim": string;
-    readonly "op:std-ease": string;
-    readonly "op:std-noise": string;
-    readonly "op:std-path": string;
-    readonly "op:ml-arch": string;
-    readonly "op:ml-effect": string;
-    readonly "op:ml-tensor": string;
-    readonly "op:ml-graph": string;
-    readonly "op:ml-contract": string;
-    readonly "op:ml-data": string;
-    readonly "op:std-llm": string;
-    readonly "op:std-workspace": string;
-    readonly "op:std-session": string;
-    readonly "op:std-memory": string;
-    readonly "op:std-trace": string;
-    readonly "op:std-behavior": string;
-    readonly "op:std-behavior-value": string;
-    readonly "op:std-program": string;
-    readonly "op:std-integration": string;
-    readonly orbitalSphere: "var(--color-card)";
-    readonly orbitalRim: "var(--color-info)";
-    readonly entityCore: "var(--color-warning)";
-    readonly entityCoreGlow: string;
-    readonly traitOrbit: "var(--color-info)";
-    readonly traitOrbitHighlight: "var(--color-primary)";
-    readonly stateIdle: "var(--color-muted)";
-    readonly stateEdge: "var(--color-info)";
-    readonly stateActive: "var(--color-primary)";
-    readonly transitionArc: "var(--color-muted-foreground)";
-    readonly transitionArcHover: "var(--color-primary)";
-    readonly guardPass: "var(--color-success)";
-    readonly guardFail: "var(--color-error)";
-    readonly crossWire: "var(--color-accent)";
-    readonly crossWireGlow: string;
-    readonly pagePortal: "var(--color-success)";
-    readonly background: "var(--color-background)";
-    readonly backgroundSurface: "var(--color-card)";
-    readonly fog: "var(--color-background)";
-    readonly sparkle: "var(--color-info)";
-    readonly sparkleWarm: "var(--color-warning)";
-    readonly persistencePersistent: "var(--color-info)";
-    readonly persistenceRuntime: "var(--color-success)";
-    readonly persistenceUnknown: "var(--color-muted-foreground)";
-};
-/**
- * Positions N nodes on a golden-ratio spiral in the XZ plane (y=0).
- * Used as initial positions for the force-directed layout.
- */
-declare function goldenSpiralPositions(count: number, baseRadius: number): Position3D[];
-/**
- * Distributes N points on a sphere surface using Fibonacci lattice.
- * Produces near-uniform spacing regardless of count.
- */
-declare function fibonacciSpherePositions(count: number, radius: number): Position3D[];
-/**
- * Evenly spaces N points on a tilted ring (elliptical orbit).
- * `tilt` is the ring's inclination in radians relative to the XZ plane.
- */
-declare function orbitRingPositions(count: number, radius: number, tilt: number): Position3D[];
-/**
- * Creates a QuadraticBezierCurve3 between two 3D points with a control
- * point offset perpendicular to the from-to line. The offset direction
- * is computed in 3D using a cross product with the up vector.
- */
-declare function arcCurve3D(from: [number, number, number], to: [number, number, number], offset: number): QuadraticBezierCurve3;
-/**
- * Creates a loop curve above a point for self-transitions.
- */
-declare function selfLoopCurve3D(position: [number, number, number], loopRadius: number): QuadraticBezierCurve3;
-/**
- * Recursively positions an expression tree in 3D space.
- * Root at origin, children spread horizontally, depth goes downward (negative Y).
- */
-declare function treeLayout3D(node: ExprTreeNode3D, origin: Position3D, horizontalSpacing: number, verticalSpacing?: number): TreeLayoutResult[];
-declare const CAMERA_POSITIONS: {
-    readonly application: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly orbital: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly trait: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly transition: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-};
-
-interface Avl3DModelOverrides {
-    /** GLB URL for orbital nodes (replaces sphere) */
-    orbital?: string;
-    /** GLB URL for entity core (replaces icosahedron) */
-    entity?: string;
-    /** GLB URL for state nodes (replaces sphere) */
-    state?: string;
-    /** GLB URL for guard gates (replaces octahedron) */
-    guard?: string;
-    /** GLB URL for page portals (replaces plane) */
-    page?: string;
-}
-interface Avl3DConfig {
-    /** Custom 3D model URLs to replace default primitive geometry */
-    modelOverrides: Avl3DModelOverrides;
-    /** Whether postprocessing effects are enabled */
-    effectsEnabled: boolean;
-    /**
-     * AVL_3D_COLORS resolved against the active theme, for three.js materials
-     * and lights (which cannot evaluate `var()`/`color-mix()` themselves).
-     * Null until the viewer has resolved every token — descendants render only
-     * once the Canvas that provides this context is mounted, so they can treat
-     * a non-null palette as guaranteed.
-     */
-    palette: Readonly<Record<keyof typeof AVL_3D_COLORS, string>> | null;
-}
-declare const Avl3DContext: React.Context<Avl3DConfig>;
-/**
- * Access the current AVL 3D configuration.
- * Returns model overrides and effect settings.
- */
-declare function useAvl3DConfig(): Avl3DConfig;
-/** The theme-resolved AVL_3D_COLORS palette for three.js materials and lights. */
-declare function useAvl3DPalette(): Readonly<Record<keyof typeof AVL_3D_COLORS, string>> | null;
-
-export { CAMERA_POSITIONS as C, Avl3DContext as a, useAvl3DPalette as c, AVL_3D_COLORS as d, arcCurve3D as e, fibonacciSpherePositions as f, goldenSpiralPositions as g, orbitRingPositions as o, selfLoopCurve3D as s, treeLayout3D as t, useAvl3DConfig as u };
-export type { Avl3DConfig as A, Position3D as P, Avl3DModelOverrides as b };

package/dist/avl-schema-parser-CtJxJ9KU.d.ts

@@ -1,132 +0,0 @@
-import { EntityPersistence, JsonObject, SExpr, OrbitalSchema, Trait } from '@almadar/core';
-
-/**
- * AVL Schema Parser
- *
- * Pure functions that transform an OrbitalSchema into structured data
- * for each zoom level of the Cosmic Zoom visualization.
- *
- * Imports all types from @almadar/core.
- *
- * @packageDocumentation
- */
-
-interface SerializedEffect extends JsonObject {
-    type: string;
-    args: SExpr[];
-}
-interface ApplicationOrbitalData {
-    name: string;
-    entityName: string;
-    fieldCount: number;
-    persistence: EntityPersistence;
-    traitNames: string[];
-    pageNames: string[];
-    position: {
-        x: number;
-        y: number;
-    };
-}
-interface CrossLink {
-    emitterOrbital: string;
-    listenerOrbital: string;
-    eventName: string;
-    emitterTrait: string;
-    listenerTrait: string;
-}
-interface ApplicationLevelData {
-    orbitals: ApplicationOrbitalData[];
-    crossLinks: CrossLink[];
-}
-interface FieldInfo extends JsonObject {
-    name: string;
-    type: string;
-    required: boolean;
-    hasDefault: boolean;
-}
-interface OrbitalTraitInfo extends JsonObject {
-    name: string;
-    stateCount: number;
-    eventCount: number;
-    transitionCount: number;
-    emits: string[];
-    listens: string[];
-}
-interface OrbitalPageInfo extends JsonObject {
-    name: string;
-    route: string;
-}
-interface ExternalLink extends JsonObject {
-    targetOrbital: string;
-    eventName: string;
-    direction: string;
-    traitName: string;
-}
-interface OrbitalLevelData {
-    name: string;
-    entity: {
-        name: string;
-        fields: FieldInfo[];
-        persistence: EntityPersistence;
-    };
-    traits: OrbitalTraitInfo[];
-    pages: OrbitalPageInfo[];
-    externalLinks: ExternalLink[];
-}
-interface TraitStateInfo extends JsonObject {
-    name: string;
-    isInitial: boolean | null;
-    isTerminal: boolean | null;
-}
-interface TraitTransitionInfo extends JsonObject {
-    from: string;
-    to: string;
-    event: string;
-    /** `.orb` config data omits the key instead of carrying null. */
-    guard: SExpr | null;
-    effects: SerializedEffect[];
-    index: number;
-}
-interface TraitLevelData extends JsonObject {
-    name: string;
-    linkedEntity: string;
-    states: TraitStateInfo[];
-    transitions: TraitTransitionInfo[];
-    emittedEvents: string[];
-    listenedEvents: string[];
-}
-interface ExprTreeNode {
-    label: string;
-    type: 'operator' | 'literal' | 'binding';
-    children?: ExprTreeNode[];
-}
-interface SlotTarget {
-    name: string;
-    pattern: string;
-}
-interface TransitionLevelData {
-    from: string;
-    to: string;
-    event: string;
-    guard: ExprTreeNode | null;
-    effects: ExprTreeNode[];
-    slotTargets: SlotTarget[];
-}
-/**
- * Parse the application-level view: all orbitals with cross-orbital links.
- */
-declare function parseApplicationLevel(schema: OrbitalSchema): ApplicationLevelData;
-/**
- * Parse a single orbital's detail view.
- */
-declare function parseOrbitalLevel(schema: OrbitalSchema, orbitalName: string): OrbitalLevelData | null;
-declare function parseTraitLevel(schema: OrbitalSchema, orbitalName: string, traitName: string): TraitLevelData | null;
-/** One trait's state machine as AVL trait data; null when the trait has no state machine. */
-declare function traitLevelFromTrait(trait: Trait, linkedEntity: string): TraitLevelData | null;
-/**
- * Parse a single transition for the detail view.
- */
-declare function parseTransitionLevel(schema: OrbitalSchema, orbitalName: string, traitName: string, transitionIndex: number): TransitionLevelData | null;
-
-export { parseOrbitalLevel as e, parseTraitLevel as f, parseTransitionLevel as g, parseApplicationLevel as p, traitLevelFromTrait as t };
-export type { ApplicationLevelData as A, CrossLink as C, ExternalLink as E, FieldInfo as F, OrbitalTraitInfo as O, SerializedEffect as S, TraitLevelData as T, OrbitalPageInfo as a, OrbitalLevelData as b, TransitionLevelData as c, TraitTransitionInfo as d };

package/dist/avl-zoom-state-CKMVuBFg.d.ts

@@ -1,17 +0,0 @@
-/**
- * AVL Cosmic Zoom State Machine
- *
- * useReducer-based state machine managing which zoom level is displayed,
- * what is selected, and animation state.
- *
- * Shared by AvlOrbitalsCosmicZoom (2D) and Avl3DViewer (3D). The 3D
- * viewer drills through every level (`application → orbital → trait →
- * transition`); the 2D cosmic view skips the `'orbital'` level after
- * COSMIC-1 (no Orbital-View screen) by dispatching `JUMP_TO_TRAIT_CIRCUIT`
- * to land directly at `'trait'`.
- *
- * @packageDocumentation
- */
-type ZoomLevel = 'application' | 'orbital' | 'trait' | 'transition';
-
-export type { ZoomLevel as Z };

package/dist/chunk-2QOH2HWM.js

@@ -1,95 +0,0 @@
-import { TraitValueMountContext, OrbitalPluginHost, MountedInit } from './chunk-FIW6WN23.js';
-import { LoadingState, ErrorState, UISlotComponent, OrbPreview } from './chunk-GYTPOFVC.js';
-import { UISlotProvider } from './chunk-AILY3XPS.js';
-import { useContext, useMemo, useRef, useState, useEffect } from 'react';
-import { OrbitalSchemaSchema, defaultPage, isInlineTrait } from '@almadar/core';
-import { jsx, jsxs } from 'react/jsx-runtime';
-
-function bridgeInbound(schema, listens, busEventOf = (event) => event) {
-  const rows = [];
-  for (const event of listens) {
-    for (const orbital of schema.orbitals) {
-      for (const trait of orbital.traits) {
-        if (!isInlineTrait(trait)) continue;
-        if (!trait.stateMachine?.transitions.some((t) => t.event === event)) continue;
-        rows.push({ busEvent: busEventOf(event), orbital: orbital.name, trait: trait.name, trigger: event });
-      }
-    }
-  }
-  return rows;
-}
-function mountCarried(behavior, resolved) {
-  let json;
-  try {
-    json = JSON.parse(resolved);
-  } catch (error) {
-    return { ok: false, error: `behavior ${behavior}: its resolved program is not JSON: ${String(error)}` };
-  }
-  const parsed = OrbitalSchemaSchema.safeParse(json);
-  if (!parsed.success) return { ok: false, error: `behavior ${behavior}: its resolved program is not a program: ${parsed.error.message}` };
-  const first = defaultPage(parsed.data)?.page.path;
-  if (first === void 0) return { ok: false, error: `behavior ${behavior} has no page to open` };
-  return { ok: true, mounted: { schema: parsed.data, firstPage: first } };
-}
-function BehaviorValueFrame({ value }) {
-  const host = useContext(TraitValueMountContext);
-  const key = useMemo(() => JSON.stringify(value), [value]);
-  const latest = useRef(value);
-  latest.current = value;
-  const [state, setState] = useState({ status: "loading" });
-  useEffect(() => {
-    const current = latest.current;
-    if (current.resolved !== void 0) {
-      const carried = mountCarried(current.behavior, current.resolved);
-      setState(carried.ok ? { status: "ready", mounted: carried.mounted } : { status: "error", message: carried.error });
-      return;
-    }
-    const mountBehavior = host?.mountBehavior;
-    if (mountBehavior === void 0) {
-      setState({ status: "error", message: `This host cannot run behavior ${current.behavior}` });
-      return;
-    }
-    let live = true;
-    setState({ status: "loading" });
-    void mountBehavior(current).then((result) => {
-      if (!live) return;
-      if (!result.ok) {
-        const detail = (result.errors ?? []).map((e) => `${e.code}: ${e.message}`).join("\n");
-        setState({ status: "error", message: detail.length > 0 ? `${result.error}
-${detail}` : result.error });
-        return;
-      }
-      setState({ status: "ready", mounted: result.mounted });
-    });
-    return () => {
-      live = false;
-    };
-  }, [host, key]);
-  if (state.status === "loading") return /* @__PURE__ */ jsx(LoadingState, {});
-  if (state.status === "error") return /* @__PURE__ */ jsx(ErrorState, { message: state.message });
-  if (value.bridge !== void 0) {
-    const initEvent = `BEHAVIOR_VALUE_MOUNTED:${key}`;
-    const plugin = {
-      id: key,
-      schema: state.mounted.schema,
-      inbound: [...bridgeInbound(state.mounted.schema, value.bridge.listens), ...bridgeInbound(state.mounted.schema, ["INIT"], () => initEvent)],
-      outbound: value.bridge.emits
-    };
-    return /* @__PURE__ */ jsx(UISlotProvider, { children: /* @__PURE__ */ jsxs(OrbitalPluginHost, { plugins: [plugin], mode: host?.mode ?? "mock", transport: host?.transport, children: [
-      /* @__PURE__ */ jsx(MountedInit, { event: initEvent }),
-      /* @__PURE__ */ jsx(UISlotComponent, { slot: "main" })
-    ] }) });
-  }
-  return /* @__PURE__ */ jsx(
-    OrbPreview,
-    {
-      schema: state.mounted.schema,
-      initialPagePath: state.mounted.firstPage,
-      isolated: true,
-      ...host?.behaviorTransport !== void 0 ? { transport: host.behaviorTransport } : {}
-    }
-  );
-}
-var BehaviorValueFrame_default = BehaviorValueFrame;
-
-export { BehaviorValueFrame, BehaviorValueFrame_default };