@almadar/ui 5.23.0 → 5.25.0

package/dist/components/core/molecules/AssetPicker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AssetPicker Molecule Component
+ *
+ * Catalog-driven asset chooser built on the GridPicker base. Maps an
+ * AssetCatalog into picker cells and renders a kind-aware thumbnail: an
+ * <img> for visual kinds, an Icon affordance for audio/model/other. Pure
+ * presentational — the host supplies the catalog and owns the selected url.
+ */
+import React from 'react';
+import type { AssetCatalog } from '@almadar/core';
+export interface AssetPickerProps {
+    /** Browsable asset catalog supplied by the host. */
+    assets: AssetCatalog;
+    /** Currently selected asset url (controlled highlight). */
+    value?: string;
+    /** Fired with the chosen asset's url. */
+    onChange: (url: string) => void;
+    /** Additional CSS classes applied to the root. */
+    className?: string;
+}
+export declare const AssetPicker: React.FC<AssetPickerProps>;

package/dist/components/core/molecules/CodeViewer.d.ts

@@ -13,6 +13,7 @@
  */
 import React from "react";
 import type { UiError } from '../atoms/types';
+import type { CodeLanguage } from "./markdown/CodeBlock";
 export type CodeViewerMode = "code" | "diff";
 export interface DiffLine {
     type: "add" | "remove" | "context";
@@ -28,7 +29,7 @@ export interface CodeViewerAction {
 export interface CodeViewerFile {
     label: string;
     code: string;
-    language?: string;
+    language?: CodeLanguage;
 }
 export interface CodeViewerProps {
     /** Viewer title */
@@ -36,7 +37,7 @@ export interface CodeViewerProps {
     /** Code content */
     code?: string;
     /** Language for display label */
-    language?: string;
+    language?: CodeLanguage;
     /** Diff lines (for diff mode) */
     diff?: readonly DiffLine[];
     /** Old value (for generating diff) */

package/dist/components/core/molecules/DocCodeBlock.d.ts

@@ -1,8 +1,9 @@
+import type { CodeLanguage } from './markdown/CodeBlock';
 export interface DocCodeBlockProps {
     /** Code content to display */
     code: string;
     /** Programming language label */
-    language?: string;
+    language?: CodeLanguage;
     /** Optional title/filename shown in the header bar */
     title?: string;
     /** Show line numbers in the gutter */

package/dist/components/core/molecules/GridPicker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GridPicker Molecule Component
+ *
+ * Reusable emoji-picker-style chooser: a search box, a row of category filter
+ * chips, and a scrollable CSS-grid of fixed-size cells. Pure presentational —
+ * the host owns the item list and the selected value; the molecule just filters,
+ * highlights, and reports clicks via `onChange`.
+ */
+import React from 'react';
+/**
+ * Presentational item shape for a single grid cell. This is a UI-presentation
+ * type, intentionally local — it is NOT a domain/asset type from @almadar/core.
+ */
+export interface PickerItem {
+    /** Stable identity; emitted via `onChange`. */
+    id: string;
+    /** Human label — search term, cell title, and aria-label. */
+    label: string;
+    /** Category key used by the filter chips. */
+    category: string;
+}
+export type GridPickerCellSize = 16 | 32 | 48;
+export interface GridPickerProps {
+    /** Items to render as grid cells. */
+    items: PickerItem[];
+    /** Currently selected item id (controlled highlight). */
+    value?: string;
+    /** Fired with the clicked/selected item's id. */
+    onChange: (value: string) => void;
+    /**
+     * Category keys for the filter chip row. When omitted, the categories are
+     * derived from the items. An "All" chip is always prepended.
+     */
+    categories?: string[];
+    /** Placeholder for the search input. */
+    searchPlaceholder?: string;
+    /** Renders the visual content of a cell (e.g. an emoji glyph or an image). */
+    renderThumbnail: (item: PickerItem) => React.ReactNode;
+    /** Cell edge length in px. */
+    cellSize?: GridPickerCellSize;
+    /** Additional CSS classes applied to the root. */
+    className?: string;
+}
+export declare const GridPicker: React.FC<GridPickerProps>;

package/dist/components/core/molecules/IconPicker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IconPicker Molecule Component
+ *
+ * Searchable grid of every lucide icon, built on `GridPicker`. The item set is
+ * enumerated once at module scope from the lucide-react exports and kebab-cased
+ * to match the canonical names `Icon` resolves, so each cell renders its real
+ * glyph via the family-aware `Icon` atom.
+ */
+import React from 'react';
+export interface IconPickerProps {
+    /** Currently selected icon name (kebab-case). */
+    value?: string;
+    /** Fired with the chosen icon's kebab-case name. */
+    onChange: (name: string) => void;
+    /** Additional CSS classes applied to the root. */
+    className?: string;
+}
+export declare const IconPicker: React.FC<IconPickerProps>;

package/dist/components/core/molecules/PropertyInspector.d.ts

@@ -1,11 +1,12 @@
 import React from 'react';
-import type { DeclaredTraitConfig, TraitConfig, TraitConfigValue } from '@almadar/core';
+import type { DeclaredTraitConfig, TraitConfig, TraitConfigValue, AssetCatalog } from '@almadar/core';
 import type { DisplayStateProps } from '../organisms/types';
 /**
  * PropertyInspector — Storybook-style controls panel for a trait's `config`.
  *
  * Derives one control per declared config field directly from the schema
- * (`@almadar/core` `DeclaredTraitConfig`): `boolean → Switch`, `string` with
+ * (`@almadar/core` `DeclaredTraitConfig`), dispatching on the field's `type`:
+ * `icon → IconPicker`, `asset → AssetPicker`, `boolean → Switch`, `string` with
  * `values → Select`, `number → numeric Input`, `string → Input`. Non-scalar
  * fields (array/object/node/SExpr) are shown read-only. Fields group + collapse
  * by `@tier`. The component is controlled — it emits `onChange(field, value)`;
@@ -22,5 +23,7 @@ export interface PropertyInspectorProps extends DisplayStateProps {
     onReset?: () => void;
     /** Panel heading (e.g. the trait name). */
     title?: string;
+    /** Browsable asset catalog supplied to `asset`-typed fields' AssetPicker. */
+    assets?: AssetCatalog;
 }
 export declare const PropertyInspector: React.FC<PropertyInspectorProps>;

package/dist/components/core/molecules/RichBlockEditor.d.ts

@@ -30,6 +30,13 @@ export interface RichBlockEditorProps {
     }>;
     readOnly?: boolean;
     placeholder?: string;
+    /**
+     * Opt-in to the Notion-style block authoring chrome (insert toolbar, per-row
+     * +/menu gutter, turn-into menu). Off by default: the editor renders as a
+     * plain rich text surface that edits block content inline without any
+     * add-block affordances.
+     */
+    enableBlocks?: boolean;
     showToolbar?: boolean;
     className?: string;
 }

package/dist/components/core/molecules/index.d.ts

@@ -33,7 +33,7 @@ export { Drawer, type DrawerProps, type DrawerPosition, type DrawerSize } from '
 export { WizardProgress, type WizardProgressProps, type WizardProgressStep } from './WizardProgress';
 export { WizardNavigation, type WizardNavigationProps } from './WizardNavigation';
 export { MarkdownContent, type MarkdownContentProps } from './markdown/MarkdownContent';
-export { CodeBlock, type CodeBlockProps } from './markdown/CodeBlock';
+export { CodeBlock, type CodeBlockProps, type CodeLanguage } from './markdown/CodeBlock';
 export { QuizBlock, type QuizBlockProps } from './QuizBlock';
 export { ScaledDiagram, type ScaledDiagramProps } from './ScaledDiagram';
 export { CalendarGrid, type CalendarGridProps } from './CalendarGrid';
@@ -41,6 +41,9 @@ export { RepeatableFormSection, type RepeatableFormSectionProps, type Repeatable
 export { ViolationAlert, type ViolationAlertProps, type ViolationRecord } from './ViolationAlert';
 export { FormSectionHeader, type FormSectionHeaderProps } from './FormSectionHeader';
 export { FlipCard, type FlipCardProps } from './FlipCard';
+export { GridPicker, type GridPickerProps, type PickerItem, type GridPickerCellSize, } from './GridPicker';
+export { AssetPicker, type AssetPickerProps } from './AssetPicker';
+export { IconPicker, type IconPickerProps } from './IconPicker';
 export { DateRangePicker, type DateRangePickerProps, type DateRangePickerPreset } from './DateRangePicker';
 export { DateRangeSelector, type DateRangeSelectorProps, type DateRangeSelectorOption } from './DateRangeSelector';
 export { ChartLegend, type ChartLegendProps, type ChartLegendItem } from './ChartLegend';
@@ -100,8 +103,8 @@ export { DocSearch, type DocSearchProps, type DocSearchResult } from './DocSearc
 export { DocSidebar, type DocSidebarProps, type DocSidebarItem } from './DocSidebar';
 export { DocTOC, type DocTOCProps, type DocTOCItem } from './DocTOC';
 export { GradientDivider, type GradientDividerProps } from './GradientDivider';
-export { MarketingFooter, type MarketingFooterProps, type FooterLinkColumn, type FooterLinkItem } from './MarketingFooter';
-export { PullQuote, type PullQuoteProps } from './PullQuote';
+export { MarketingFooter, type MarketingFooterProps, type FooterLinkColumn, type FooterLinkItem } from '../../marketing/molecules/MarketingFooter';
+export { PullQuote, type PullQuoteProps } from '../../marketing/molecules/PullQuote';
 export { BehaviorView, type BehaviorViewProps } from '../../avl/molecules/BehaviorView';
 export { ModuleCard, type ModuleCardProps } from '../../avl/molecules/ModuleCard';
 export { PageHeader, type PageHeaderProps, type PageBreadcrumb, } from "./PageHeader";

package/dist/components/core/molecules/markdown/CodeBlock.d.ts

@@ -8,11 +8,25 @@
  * - Emits: UI:COPY_CODE { language, success }
  */
 import React from 'react';
+/**
+ * The set of languages with a registered PrismLight grammar (above) plus the
+ * `.orb`/`.lolo` grammars from `@almadar/syntax`. Authoritative: an unregistered
+ * value renders as plain text, so this union mirrors the `registerLanguage`
+ * calls exactly.
+ */
+export declare const CODE_LANGUAGES: readonly ["text", "json", "javascript", "js", "typescript", "ts", "jsx", "tsx", "css", "markdown", "md", "bash", "shell", "sh", "yaml", "yml", "rust", "python", "py", "sql", "diff", "toml", "go", "graphql", "html", "xml", "orb", "lolo"];
+export type CodeLanguage = (typeof CODE_LANGUAGES)[number];
+/**
+ * Narrow an arbitrary string (e.g. a markdown fence info-string) to a
+ * `CodeLanguage`, falling back to `'text'` for any value without a registered
+ * grammar — matching the highlighter's own plain-text fallback.
+ */
+export declare function toCodeLanguage(value: string | undefined): CodeLanguage;
 export interface CodeBlockProps {
     /** The code content to display */
     code: string;
     /** Programming language for syntax highlighting */
-    language?: string;
+    language?: CodeLanguage;
     /** Show the copy button */
     showCopyButton?: boolean;
     /** Show the language badge */

package/dist/components/core/molecules/markdown/index.d.ts

@@ -1,2 +1,2 @@
 export { MarkdownContent, type MarkdownContentProps } from './MarkdownContent';
-export { CodeBlock, type CodeBlockProps } from './CodeBlock';
+export { CodeBlock, type CodeBlockProps, type CodeLanguage } from './CodeBlock';

package/dist/components/core/organisms/index.d.ts

@@ -18,12 +18,12 @@ export { NotifyListener } from "./NotifyListener";
 export { Timeline, type TimelineProps, type TimelineItem, type TimelineItemStatus, } from "./Timeline";
 export { MediaGallery, type MediaGalleryProps, type MediaItem, } from "./MediaGallery";
 export { RuntimeDebugger, type RuntimeDebuggerProps, } from "./debug";
-export { HeroOrganism, type HeroOrganismProps, } from "./HeroOrganism";
-export { FeatureGridOrganism, type FeatureGridOrganismProps, } from "./FeatureGridOrganism";
+export { HeroOrganism, type HeroOrganismProps, } from "../../marketing/organisms/HeroOrganism";
+export { FeatureGridOrganism, type FeatureGridOrganismProps, } from "../../marketing/organisms/FeatureGridOrganism";
 export { PricingOrganism, type PricingOrganismProps, } from "../../marketing/organisms/PricingOrganism";
 export { StatsOrganism, type StatsOrganismProps, } from "../../marketing/organisms/StatsOrganism";
-export { StepFlowOrganism, type StepFlowOrganismProps, } from "./StepFlowOrganism";
-export { ShowcaseOrganism, type ShowcaseOrganismProps, } from "./ShowcaseOrganism";
+export { StepFlowOrganism, type StepFlowOrganismProps, } from "../../marketing/organisms/StepFlowOrganism";
+export { ShowcaseOrganism, type ShowcaseOrganismProps, } from "../../marketing/organisms/ShowcaseOrganism";
 export { TeamOrganism, type TeamOrganismProps, } from "../../marketing/organisms/TeamOrganism";
-export { CaseStudyOrganism, type CaseStudyOrganismProps, } from "./CaseStudyOrganism";
+export { CaseStudyOrganism, type CaseStudyOrganismProps, } from "../../marketing/organisms/CaseStudyOrganism";
 export { FeatureRenderer, type FeatureRendererProps } from '../../game/organisms/three/renderers/FeatureRenderer';

package/dist/components/core/templates/index.d.ts

@@ -1,6 +1,6 @@
 export type { TemplateProps } from './types';
 export { DashboardLayout, type DashboardLayoutProps, type NavItem } from './DashboardLayout';
-export { AuthLayout, type AuthLayoutProps } from './AuthLayout';
+export { AuthLayout, type AuthLayoutProps } from '../../marketing/templates/AuthLayout';
 export { CounterTemplate, type CounterTemplateProps, type CounterSize, type CounterVariant } from './CounterTemplate';
 export { GameTemplate, type GameTemplateProps } from '../../game/templates/GameTemplate';
 export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';