@almadar/ui 5.76.7 → 5.78.0

package/dist/components/learning/atoms/LearningCanvas.d.ts

@@ -0,0 +1,80 @@
+/**
+ * LearningCanvas
+ *
+ * A pure, declarative HTML5 canvas atom for math and science visualizations.
+ * Accepts a list of primitive shapes (line, arrow, circle, rect, polygon, path,
+ * text, axis, grid) and renders them. Optional interactivity emits click/hover
+ * events, and optional animation drives a continuous render loop.
+ *
+ * This is the foundational atom for the `learning/` behavior family.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { UiError } from '../../core/atoms/types';
+export type LearningShapeType = 'line' | 'arrow' | 'circle' | 'rect' | 'polygon' | 'path' | 'text' | 'axis' | 'grid';
+export interface LearningPoint {
+    x: number;
+    y: number;
+}
+export interface LearningShape {
+    type: LearningShapeType;
+    /** Optional stable id for interaction payloads. */
+    id?: string;
+    x?: number;
+    y?: number;
+    x1?: number;
+    y1?: number;
+    x2?: number;
+    y2?: number;
+    radius?: number;
+    width?: number;
+    height?: number;
+    points?: LearningPoint[];
+    path?: string;
+    text?: string;
+    label?: string;
+    fontSize?: number;
+    align?: 'left' | 'center' | 'right';
+    axis?: 'x' | 'y';
+    min?: number;
+    max?: number;
+    step?: number;
+    color?: string;
+    fill?: string;
+    lineWidth?: number;
+    opacity?: number;
+}
+export interface LearningCanvasProps {
+    /** Additional CSS classes. */
+    className?: string;
+    /** Canvas width in CSS pixels. */
+    width?: number;
+    /** Canvas height in CSS pixels. */
+    height?: number;
+    /** Background color (default transparent). */
+    backgroundColor?: string;
+    /** Declarative shapes to draw. */
+    shapes?: LearningShape[];
+    /** Enable pointer interaction (click/hover). */
+    interactive?: boolean;
+    /** Enable continuous redraw loop. */
+    animate?: boolean;
+    /** Clicked shape payload: { id?, type?, index }. */
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    /** Hovered shape payload: { id?, type?, index }. */
+    onShapeHover?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    /** Loading state. */
+    isLoading?: boolean;
+    /** Error state. */
+    error?: UiError | null;
+}
+export declare const LearningCanvas: React.FC<LearningCanvasProps>;

package/dist/components/learning/molecules/BiologyCanvas.d.ts

@@ -0,0 +1,47 @@
+/**
+ * BiologyCanvas
+ *
+ * A field-scoped learning molecule for biology. Renders cells, organelles,
+ * membranes, and connections on top of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface BiologyNode {
+    id?: string;
+    x: number;
+    y: number;
+    radius?: number;
+    color?: string;
+    label?: string;
+    kind?: 'cell' | 'organelle' | 'molecule' | 'organism';
+}
+export interface BiologyEdge {
+    from: string;
+    to: string;
+    color?: string;
+    label?: string;
+}
+export interface BiologyCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    nodes?: BiologyNode[];
+    edges?: BiologyEdge[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const BiologyCanvas: React.FC<BiologyCanvasProps>;

package/dist/components/learning/molecules/ChemistryCanvas.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ChemistryCanvas
+ *
+ * A field-scoped learning molecule for chemistry. Renders atoms, bonds, and
+ * reaction arrows on top of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface ChemistryAtom {
+    id?: string;
+    x: number;
+    y: number;
+    element?: string;
+    radius?: number;
+    color?: string;
+}
+export interface ChemistryBond {
+    from: string;
+    to: string;
+    type?: 'single' | 'double' | 'triple';
+    color?: string;
+}
+export interface ChemistryArrow {
+    x: number;
+    y: number;
+    angle?: number;
+    length?: number;
+    color?: string;
+    label?: string;
+}
+export interface ChemistryCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    atoms?: ChemistryAtom[];
+    bonds?: ChemistryBond[];
+    arrows?: ChemistryArrow[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const ChemistryCanvas: React.FC<ChemistryCanvasProps>;

package/dist/components/learning/molecules/MathCanvas.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MathCanvas
+ *
+ * A field-scoped learning molecule for mathematics. Renders a coordinate plane
+ * with axes, grid, curves (sampled points), scatter points, and vectors on top
+ * of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape, LearningPoint } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface MathCurve {
+    label?: string;
+    color?: string;
+    /** Sampled {x,y} points in math coordinates. */
+    samples: LearningPoint[];
+}
+export interface MathPoint {
+    x: number;
+    y: number;
+    label?: string;
+    color?: string;
+    radius?: number;
+}
+export interface MathVector {
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    color?: string;
+    label?: string;
+}
+export interface MathCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    xMin?: number;
+    xMax?: number;
+    yMin?: number;
+    yMax?: number;
+    showAxes?: boolean;
+    showGrid?: boolean;
+    gridStep?: number;
+    curves?: MathCurve[];
+    points?: MathPoint[];
+    vectors?: MathVector[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const MathCanvas: React.FC<MathCanvasProps>;

package/dist/components/learning/molecules/PhysicsCanvas.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PhysicsCanvas
+ *
+ * A field-scoped learning molecule for physics. Renders bodies, constraints,
+ * velocity arrows, and force arrows on top of the declarative `LearningCanvas`
+ * atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface LearningPhysicsBody {
+    id?: string;
+    x: number;
+    y: number;
+    radius?: number;
+    color?: string;
+    label?: string;
+    vx?: number;
+    vy?: number;
+    fx?: number;
+    fy?: number;
+}
+export interface LearningPhysicsConstraint {
+    from: string;
+    to: string;
+    color?: string;
+}
+export interface PhysicsCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    bodies?: LearningPhysicsBody[];
+    constraints?: LearningPhysicsConstraint[];
+    showVelocity?: boolean;
+    showForces?: boolean;
+    velocityScale?: number;
+    forceScale?: number;
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const PhysicsCanvas: React.FC<PhysicsCanvasProps>;

package/dist/components/marketing/atoms/MarketingStatCard.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 export type StatCardSize = "sm" | "md" | "lg";
-export interface StatCardProps {
+export interface MarketingStatCardProps {
     /** The stat value to display prominently */
     value: string;
     /** Label describing the value */
@@ -10,4 +10,4 @@ export interface StatCardProps {
     /** Additional class names */
     className?: string;
 }
-export declare const MarketingStatCard: React.FC<StatCardProps>;
+export declare const MarketingStatCard: React.FC<MarketingStatCardProps>;

package/dist/hooks/useGitHub.d.ts

@@ -25,7 +25,7 @@ export interface GitHubRepo {
 /**
  * Hook to get GitHub connection status
  */
-export declare function useGitHubStatus(): import("@tanstack/react-query").UseQueryResult<NoInfer<GitHubStatus>, Error>;
+export declare function useGitHubStatus(): import("@tanstack/react-query").UseQueryResult<GitHubStatus, Error>;
 /**
  * Hook to connect GitHub (initiate OAuth flow)
  */
@@ -39,20 +39,20 @@ export declare function useDisconnectGitHub(): import("@tanstack/react-query").U
 /**
  * Hook to list GitHub repositories
  */
-export declare function useGitHubRepos(page?: number, perPage?: number): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+export declare function useGitHubRepos(page?: number, perPage?: number): import("@tanstack/react-query").UseQueryResult<{
     repos: GitHubRepo[];
     page: number;
     perPage: number;
-}>, Error>;
+}, Error>;
 /**
  * Hook to get repository details
  */
-export declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+export declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
     repo: GitHubRepo;
-}>, Error>;
+}, Error>;
 /**
  * Hook to list repository branches
  */
-export declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+export declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
     branches: string[];
-}>, Error>;
+}, Error>;

package/dist/marketing/index.cjs

@@ -28,7 +28,7 @@ function _interopNamespace(e) {
 var React11__default = /*#__PURE__*/_interopDefault(React11);
 var LucideIcons2__namespace = /*#__PURE__*/_interopNamespace(LucideIcons2);
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -43,7 +43,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/marketing/index.js

@@ -4,7 +4,7 @@ import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X } from 'lucide-react';
 
-// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+// node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -19,7 +19,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/providers/EventBusProvider.d.ts

@@ -43,5 +43,5 @@ interface EventBusProviderProps {
      */
     isolated?: boolean;
 }
-export declare function EventBusProvider({ children, isolated }: EventBusProviderProps): React.JSX.Element;
+export declare function EventBusProvider({ children, isolated }: EventBusProviderProps): import("react/jsx-runtime").JSX.Element;
 export type { EventBusContextType };

package/dist/providers/SelectionProvider.d.ts

@@ -50,7 +50,7 @@ interface SelectionProviderProps {
  * }
  * ```
  */
-export declare function SelectionProvider({ children, debug, compareEntities, }: SelectionProviderProps): React.JSX.Element;
+export declare function SelectionProvider({ children, debug, compareEntities, }: SelectionProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access selection state.
  *

package/dist/providers/ServerBridge.d.ts

@@ -98,5 +98,5 @@ export interface ServerBridgeProviderProps {
     transport?: ServerBridgeTransport;
     children: ReactNode;
 }
-export declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): import("react").JSX.Element;
+export declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};