@almadar/shell-web 0.1.0 → 1.1.0

package/dist/{ArbitraryClassCompiler-Mzabq-UB.d.ts → ArbitraryClassCompiler-CO_iASBn.d.ts}

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ThemeRef, OrbitalSchema } from '@almadar/core';
-import './EventBusProvider-CVwjkV_2.js';
+import { ThemeRef, UserContext as UserContext$1, FieldValue, OrbitalSchema } from '@almadar/core';
+import './EventBusProvider-BFFHfN4O.js';
 import { T as ThemeProviderProps } from './ThemeContext-DJmO59xd.js';
 
 /**
@@ -75,6 +75,101 @@ interface CurrentPagePathProviderProps {
 declare const CurrentPagePathProvider: React__default.FC<CurrentPagePathProviderProps>;
 declare const useCurrentPagePath: () => string | undefined;
 
+/**
+ * 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;
+
 /**
  * Arbitrary-value Tailwind classes (`w-[243px]`) in a schema exist only as
  * data, so build-time Tailwind never compiled them. A host that renders
@@ -96,5 +191,5 @@ declare function ArbitraryClassCompilerProvider({ compile, children }: Arbitrary
 declare function resetArbitraryClassStyles(): void;
 declare function useArbitraryClassStyles(schema: OrbitalSchema | null | undefined): void;
 
-export { ARBITRARY_CLASS_STYLE_ID as A, CurrentPagePathContext as C, DesignThemeProvider as D, OrbitalThemeProvider as O, ArbitraryClassCompilerProvider as b, CurrentPagePathProvider as d, useCurrentPagePath as g, useDesignTheme as h, resetArbitraryClassStyles as r, useArbitraryClassStyles as u };
-export type { ArbitraryClassCompiler as a, ArbitraryClassCompilerProviderProps as c, CurrentPagePathProviderProps as e, OrbitalThemeProviderProps as f };
+export { ARBITRARY_CLASS_STYLE_ID as A, CurrentPagePathContext as C, DesignThemeProvider as D, OrbitalThemeProvider as O, UserContext as U, ArbitraryClassCompilerProvider as b, CurrentPagePathProvider as d, UserProvider as i, useCurrentPagePath as k, useDesignTheme as l, useHasPermission as m, useHasRole as n, useUser as o, useUserForEvaluation as p, resetArbitraryClassStyles as r, useArbitraryClassStyles as u };
+export type { ArbitraryClassCompiler as a, ArbitraryClassCompilerProviderProps as c, CurrentPagePathProviderProps as e, OrbitalThemeProviderProps as f, UserContextValue as g, UserData as h, UserProviderProps as j };

package/dist/AvlGlyph-PIXU6QH5.js

@@ -0,0 +1,5 @@
+export { AVL_GLYPH_KINDS, AvlGlyph } from './chunk-AGVSO4WY.js';
+import './chunk-7N6ZPHQ5.js';
+import './chunk-FAKU5F62.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlStateMachine-CKGMECMG.js

@@ -0,0 +1,8 @@
+export { AvlStateMachine, BODY_CHAR, MARGIN, MAX_SCALE, MIN_SCALE, MONO_CHAR, PILL_H, metricsFor, pillWidth } from './chunk-4YJ53G7S.js';
+import './chunk-M74BCDBQ.js';
+import './chunk-PCR37T3U.js';
+import './chunk-PRLHKBXG.js';
+import './chunk-FAKU5F62.js';
+import './chunk-TZZBINQY.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlTransitionDetail-QZX6G5KJ.js

@@ -0,0 +1,10 @@
+export { AvlTransitionDetail } from './chunk-OWNG4JZI.js';
+import './chunk-ILQXJ2AR.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-M74BCDBQ.js';
+import './chunk-PCR37T3U.js';
+import './chunk-PRLHKBXG.js';
+import './chunk-FAKU5F62.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlTransitionExplainer-26WLEIC6.js

@@ -0,0 +1,11 @@
+export { AvlTransitionExplainer } from './chunk-VHC2M26B.js';
+import './chunk-OWNG4JZI.js';
+import './chunk-ILQXJ2AR.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-M74BCDBQ.js';
+import './chunk-PCR37T3U.js';
+import './chunk-PRLHKBXG.js';
+import './chunk-FAKU5F62.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/BehaviorView-JLZ4PKWY.js

@@ -0,0 +1,10 @@
+export { BehaviorView } from './chunk-YYIHRIDH.js';
+import './chunk-4YJ53G7S.js';
+import './chunk-AGXD77SL.js';
+import './chunk-M74BCDBQ.js';
+import './chunk-PCR37T3U.js';
+import './chunk-PRLHKBXG.js';
+import './chunk-FAKU5F62.js';
+import './chunk-TZZBINQY.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/{EventBusProvider-CVwjkV_2.d.ts → EventBusProvider-BFFHfN4O.d.ts}

@@ -24,6 +24,18 @@ interface VideoEmbedProps extends A11yProps {
     src?: string;
     /** Accessible name of the player */
     title?: string;
+    /** Text shown when no video is selected */
+    noVideoLabel?: string;
+    /** Text for a YouTube API loading failure */
+    apiUnavailableMessage?: string;
+    /** Text for YouTube error code 2 */
+    invalidVideoMessage?: string;
+    /** Text for YouTube error code 5 or an unknown code */
+    playbackFailedMessage?: string;
+    /** Text for YouTube error code 100 */
+    notFoundMessage?: string;
+    /** Text for YouTube error codes 101 and 150 */
+    notEmbeddableMessage?: string;
     /** Start playback as soon as the player is ready (YouTube ids only) */
     autoplay?: boolean;
     /** Show the player's own controls (YouTube ids only) */

package/dist/{FileTree-BCFnBEuQ.d.ts → FileTree-B3GDAjaQ.d.ts}

@@ -1,8 +1,135 @@
 import React__default from 'react';
-import { A11yProps, EventEmit, JsonObject, EntityPersistence, OrbitalSchema } from '@almadar/core';
-import { T as TraitLevelData, F as FieldInfo, O as OrbitalTraitInfo, a as OrbitalPageInfo, E as ExternalLink } from './avl-schema-parser-CtJxJ9KU.js';
+import { EntityPersistence, JsonObject, SExpr, OrbitalSchema, Trait, A11yProps, EventEmit } from '@almadar/core';
 import { Node, Edge } from '@xyflow/react';
 
+/**
+ * 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;
+
 /**
  * Author-supplied explanations for AVL diagrams: a note per state, per
  * transition event and per effect type, shown in a popover on hover/focus.
@@ -250,5 +377,5 @@ interface FileTreeProps extends Omit<React__default.AriaAttributes, keyof A11yPr
 }
 declare const FileTree: React__default.FC<FileTreeProps>;
 
-export { BehaviorView as B, ModuleCard as M, AvlStateMachine as d, FileTree as g, schemaToFlowGraph as s };
-export type { AvlAnnotations as A, FileTreeItem as F, AvlNodeData as a, AvlNote as b, AvlEdgeData as c, AvlStateMachineProps as e, BehaviorViewProps as f, FileTreeNode as h, FileTreeProps as i, ModuleCardProps as j };
+export { BehaviorView as B, ModuleCard as M, AvlStateMachine as g, parseOrbitalLevel as i, parseTraitLevel as j, parseTransitionLevel as k, FileTree as m, parseApplicationLevel as p, schemaToFlowGraph as s, traitLevelFromTrait as t };
+export type { AvlAnnotations as A, CrossLink as C, FileTreeItem as F, OrbitalLevelData as O, SerializedEffect as S, TraitLevelData as T, AvlNodeData as a, TraitTransitionInfo as b, TransitionLevelData as c, AvlNote as d, ApplicationLevelData as e, AvlEdgeData as f, AvlStateMachineProps as h, BehaviorViewProps as l, FileTreeNode as n, FileTreeProps as o, ModuleCardProps as q };

package/dist/FlowCanvas-RPII4V24.js

@@ -0,0 +1,23 @@
+export { FlowCanvas } from './chunk-MS4K3K2R.js';
+import './chunk-57DC34LY.js';
+import './chunk-4YJ53G7S.js';
+import './chunk-AGVSO4WY.js';
+import './chunk-7N6ZPHQ5.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-M74BCDBQ.js';
+import './chunk-PCR37T3U.js';
+import './chunk-PRLHKBXG.js';
+import './chunk-FAKU5F62.js';
+import './chunk-2WGR4TDJ.js';
+import './chunk-TZZBINQY.js';
+import './chunk-ZDRDJKYB.js';
+import './chunk-PRXQGGCO.js';
+import './chunk-VO2TTLS5.js';
+import './chunk-AE7VCQB6.js';
+import './chunk-3BBUBJFF.js';
+import './chunk-YHMRX6YA.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-A2LR6VQQ.js';
+import './chunk-P4ZFUQFF.js';
+import './chunk-G7DCAZ22.js';