@almadar/ui 5.13.3 → 5.14.1

package/dist/components/index.js

@@ -8630,13 +8630,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect72, useRef: useRef66, useCallback: useCallback128, useState: useState111 } = React80__default;
+      const { useEffect: useEffect73, useRef: useRef67, useCallback: useCallback129, useState: useState112 } = React80__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef66({ centerLat, centerLng, zoom });
-        useEffect72(() => {
+        const prevRef = useRef67({ centerLat, centerLng, zoom });
+        useEffect73(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -8647,7 +8647,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect72(() => {
+        useEffect73(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -8675,8 +8675,8 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState111(null);
-        const handleMapClick = useCallback128((lat, lng) => {
+        const [clickedPosition, setClickedPosition] = useState112(null);
+        const handleMapClick = useCallback129((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -8685,7 +8685,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback128((marker) => {
+        const handleMarkerClick = useCallback129((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -12465,6 +12465,8 @@ var init_CodeBlock = __esm({
         collapsedRef.current = collapsed;
         const foldStartMapRef = useRef(foldStartMap);
         foldStartMapRef.current = foldStartMap;
+        const hiddenLinesRef = useRef(hiddenLines);
+        hiddenLinesRef.current = hiddenLines;
         const toggleFold = useCallback((lineNum) => {
           setCollapsed((prev) => {
             const next = new Set(prev);
@@ -12577,6 +12579,60 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language, success: false });
           }
         };
+        const handleSelectionCopy = useCallback((e) => {
+          if (hiddenLinesRef.current.size === 0) return;
+          const sel = typeof window !== "undefined" ? window.getSelection() : null;
+          if (!sel || sel.rangeCount === 0 || sel.isCollapsed) return;
+          const lineOf = (node) => {
+            const start = node instanceof HTMLElement ? node : node?.parentElement ?? null;
+            const lineEl = start?.closest("[data-line]");
+            if (!lineEl) return null;
+            const n = parseInt(lineEl.getAttribute("data-line") ?? "", 10);
+            return Number.isNaN(n) ? null : n;
+          };
+          const range = sel.getRangeAt(0);
+          let a = lineOf(range.startContainer);
+          let b = lineOf(range.endContainer);
+          if (a === null || b === null) {
+            const container = codeRef.current;
+            if (!container) return;
+            let min = Infinity, max = -Infinity;
+            container.querySelectorAll("[data-line]").forEach((el) => {
+              if (!sel.containsNode(el, true)) return;
+              const n = parseInt(el.getAttribute("data-line") ?? "", 10);
+              if (!Number.isNaN(n)) {
+                min = Math.min(min, n);
+                max = Math.max(max, n);
+              }
+            });
+            if (min === Infinity) return;
+            a = a ?? min;
+            b = b ?? max;
+          }
+          if (a > b) [a, b] = [b, a];
+          let touchesFold = false;
+          for (let i = a; i <= b; i++) {
+            if (hiddenLinesRef.current.has(i) || foldStartMapRef.current.has(i) && collapsedRef.current.has(i)) {
+              touchesFold = true;
+              break;
+            }
+          }
+          if (!touchesFold) return;
+          let endLine = b;
+          let changed = true;
+          while (changed) {
+            changed = false;
+            foldStartMapRef.current.forEach((region, start) => {
+              if (start >= a && start <= endLine && collapsedRef.current.has(start) && region.end > endLine) {
+                endLine = region.end;
+                changed = true;
+              }
+            });
+          }
+          const full = code.split("\n").slice(a, endLine + 1).join("\n");
+          e.clipboardData.setData("text/plain", full);
+          e.preventDefault();
+        }, [code]);
         const hasHeader = showLanguageBadge || showCopyButton;
         return /* @__PURE__ */ jsxs(Box, { className: `relative group ${className || ""}`, style: { display: "flex", flexDirection: "column", height: "100%" }, children: [
           hasHeader && /* @__PURE__ */ jsxs(
@@ -12727,6 +12783,7 @@ var init_CodeBlock = __esm({
             "div",
             {
               ref: scrollRef,
+              onCopy: handleSelectionCopy,
               style: {
                 flex: 1,
                 minHeight: 0,
@@ -23786,6 +23843,255 @@ var init_InputGroup = __esm({
     InputGroup.displayName = "InputGroup";
   }
 });
+function resolveAnchorRect(anchor) {
+  if (typeof anchor === "string") {
+    return document.querySelector(anchor)?.getBoundingClientRect() ?? null;
+  }
+  if (anchor instanceof DOMRect) return anchor;
+  return anchor?.current?.getBoundingClientRect() ?? null;
+}
+function useAnchorRect(anchor, active) {
+  const [rect, setRect] = useState(null);
+  const read = useCallback(() => resolveAnchorRect(anchor), [anchor]);
+  useEffect(() => {
+    if (!active || typeof document === "undefined") {
+      setRect(null);
+      return;
+    }
+    const update = () => setRect(read());
+    update();
+    window.addEventListener("scroll", update, true);
+    window.addEventListener("resize", update);
+    let raf = 0;
+    let tries = 0;
+    const poll = () => {
+      const found = read();
+      if (found) {
+        setRect(found);
+      } else if (tries++ < 40) {
+        raf = requestAnimationFrame(poll);
+      }
+    };
+    if (!read()) raf = requestAnimationFrame(poll);
+    return () => {
+      window.removeEventListener("scroll", update, true);
+      window.removeEventListener("resize", update);
+      if (raf) cancelAnimationFrame(raf);
+    };
+  }, [active, read]);
+  return rect;
+}
+function placeCard(placement, rect, size) {
+  const vw = typeof window !== "undefined" ? window.innerWidth : 1024;
+  const vh = typeof window !== "undefined" ? window.innerHeight : 768;
+  let top = 0;
+  let left = 0;
+  switch (placement) {
+    case "top":
+      top = rect.top - size.h - GAP;
+      left = rect.left + rect.width / 2 - size.w / 2;
+      break;
+    case "left":
+      left = rect.left - size.w - GAP;
+      top = rect.top + rect.height / 2 - size.h / 2;
+      break;
+    case "right":
+      left = rect.right + GAP;
+      top = rect.top + rect.height / 2 - size.h / 2;
+      break;
+    case "bottom":
+    default:
+      top = rect.bottom + GAP;
+      left = rect.left + rect.width / 2 - size.w / 2;
+      break;
+  }
+  left = Math.max(EDGE, Math.min(left, vw - size.w - EDGE));
+  top = Math.max(EDGE, Math.min(top, vh - size.h - EDGE));
+  return { top, left };
+}
+var GAP, EDGE, Coachmark;
+var init_Coachmark = __esm({
+  "components/molecules/Coachmark.tsx"() {
+    "use client";
+    init_Box();
+    init_Typography();
+    init_Button();
+    init_Icon();
+    init_cn();
+    GAP = 10;
+    EDGE = 8;
+    Coachmark = ({
+      open,
+      anchor,
+      placement = "bottom",
+      title,
+      children,
+      onDismiss,
+      onPrimary,
+      primaryLabel,
+      onSecondary,
+      secondaryLabel,
+      showBeacon = false,
+      fallbackCentered = false,
+      className
+    }) => {
+      const cardRef = useRef(null);
+      const rect = useAnchorRect(anchor, open);
+      const [pos, setPos] = useState(null);
+      const centered = open && !rect && fallbackCentered;
+      useLayoutEffect(() => {
+        if (!open || !rect || !cardRef.current) {
+          setPos(null);
+          return;
+        }
+        const size = {
+          w: cardRef.current.offsetWidth,
+          h: cardRef.current.offsetHeight
+        };
+        setPos(placeCard(placement, rect, size));
+      }, [open, rect, placement, children, title]);
+      useEffect(() => {
+        if (!open) return;
+        const onKey = (e) => {
+          if (e.key === "Escape") onDismiss();
+        };
+        window.addEventListener("keydown", onKey);
+        return () => window.removeEventListener("keydown", onKey);
+      }, [open, onDismiss]);
+      if (!open || typeof document === "undefined") return null;
+      if (!rect && !centered) return null;
+      const hasFooter = Boolean(onPrimary || onSecondary);
+      const cardStyle = centered ? { top: "50%", left: "50%", transform: "translate(-50%, -50%)" } : pos ? { top: pos.top, left: pos.left } : { top: -9999, left: -9999 };
+      const card = /* @__PURE__ */ jsxs(
+        Box,
+        {
+          ref: cardRef,
+          bg: "surface",
+          border: true,
+          rounded: "lg",
+          shadow: "xl",
+          padding: "md",
+          role: "dialog",
+          "aria-label": title,
+          className: cn(
+            "fixed z-50 max-w-xs w-72 transition-opacity duration-150",
+            centered || pos ? "opacity-100" : "opacity-0",
+            className
+          ),
+          style: cardStyle,
+          children: [
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                "aria-label": "Dismiss",
+                onClick: onDismiss,
+                className: "absolute top-2 right-2 text-[var(--color-muted-foreground)] hover:text-[var(--color-foreground)]",
+                children: /* @__PURE__ */ jsx(Icon, { name: "close", size: "xs" })
+              }
+            ),
+            title && /* @__PURE__ */ jsx(Typography, { variant: "body1", weight: "semibold", className: "pr-6 mb-1", children: title }),
+            /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "muted", as: "div", children }),
+            hasFooter && /* @__PURE__ */ jsxs("div", { className: "mt-3 flex items-center justify-end gap-2", children: [
+              onSecondary && /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "sm", onClick: onSecondary, children: secondaryLabel ?? "Skip" }),
+              onPrimary && /* @__PURE__ */ jsx(Button, { variant: "primary", size: "sm", onClick: onPrimary, children: primaryLabel ?? "Got it" })
+            ] })
+          ]
+        }
+      );
+      const beacon = showBeacon && rect ? /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "fixed z-50 pointer-events-none",
+          style: {
+            top: rect.top + rect.height / 2 - 6,
+            left: rect.left + rect.width / 2 - 6
+          },
+          "aria-hidden": "true",
+          children: /* @__PURE__ */ jsxs("span", { className: "relative flex h-3 w-3", children: [
+            /* @__PURE__ */ jsx("span", { className: "absolute inline-flex h-full w-full animate-ping rounded-full bg-[var(--color-primary)] opacity-75" }),
+            /* @__PURE__ */ jsx("span", { className: "relative inline-flex h-3 w-3 rounded-full bg-[var(--color-primary)]" })
+          ] })
+        }
+      ) : null;
+      return createPortal(
+        /* @__PURE__ */ jsxs(Fragment, { children: [
+          beacon,
+          card
+        ] }),
+        document.body
+      );
+    };
+    Coachmark.displayName = "Coachmark";
+  }
+});
+var DIM, OnboardingSpotlight;
+var init_OnboardingSpotlight = __esm({
+  "components/molecules/OnboardingSpotlight.tsx"() {
+    "use client";
+    init_Coachmark();
+    init_cn();
+    DIM = "fixed z-[45] bg-black/60";
+    OnboardingSpotlight = ({
+      steps,
+      stepIndex,
+      onNext,
+      onSkip,
+      onFinish,
+      cutoutPadding = 6
+    }) => {
+      const step = steps[stepIndex];
+      const rect = useAnchorRect(step?.anchor ?? "", Boolean(step));
+      if (!step || typeof document === "undefined") return null;
+      const isLast = stepIndex >= steps.length - 1;
+      const backdrop = rect ? (() => {
+        const p2 = cutoutPadding;
+        const top = Math.max(0, rect.top - p2);
+        const left = Math.max(0, rect.left - p2);
+        const right = rect.right + p2;
+        const bottom = rect.bottom + p2;
+        return /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("div", { className: DIM, style: { top: 0, left: 0, right: 0, height: top } }),
+          /* @__PURE__ */ jsx("div", { className: DIM, style: { top: bottom, left: 0, right: 0, bottom: 0 } }),
+          /* @__PURE__ */ jsx("div", { className: DIM, style: { top, left: 0, width: left, height: bottom - top } }),
+          /* @__PURE__ */ jsx("div", { className: DIM, style: { top, left: right, right: 0, height: bottom - top } })
+        ] });
+      })() : /* @__PURE__ */ jsx("div", { className: cn(DIM, "inset-0") });
+      return /* @__PURE__ */ jsxs(Fragment, { children: [
+        createPortal(backdrop, document.body),
+        /* @__PURE__ */ jsxs(
+          Coachmark,
+          {
+            open: true,
+            anchor: step.anchor,
+            placement: step.placement ?? "bottom",
+            fallbackCentered: true,
+            title: step.title,
+            onDismiss: onSkip,
+            onSecondary: onSkip,
+            secondaryLabel: "Skip",
+            onPrimary: isLast ? onFinish : onNext,
+            primaryLabel: isLast ? "Done" : "Next",
+            children: [
+              /* @__PURE__ */ jsx("span", { children: step.body }),
+              /* @__PURE__ */ jsx("span", { className: "mt-3 flex items-center gap-1.5", children: steps.map((_, i) => /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: cn(
+                    "h-1.5 w-1.5 rounded-full",
+                    i === stepIndex ? "bg-[var(--color-primary)]" : "bg-[var(--color-border)]"
+                  )
+                },
+                i
+              )) })
+            ]
+          }
+        )
+      ] });
+    };
+    OnboardingSpotlight.displayName = "OnboardingSpotlight";
+  }
+});
 function gateEnabled(level, ns = NAMESPACE) {
   return isLogLevelEnabled(level, ns);
 }
@@ -34146,7 +34452,7 @@ var init_AvlPage = __esm({
     AvlPage.displayName = "AvlPage";
   }
 });
-var NODE_W, NODE_H, GAP, ARROW_W, MiniStateMachine;
+var NODE_W, NODE_H, GAP2, ARROW_W, MiniStateMachine;
 var init_MiniStateMachine = __esm({
   "components/molecules/avl/MiniStateMachine.tsx"() {
     "use client";
@@ -34155,7 +34461,7 @@ var init_MiniStateMachine = __esm({
     init_types();
     NODE_W = 24;
     NODE_H = 16;
-    GAP = 8;
+    GAP2 = 8;
     ARROW_W = 16;
     MiniStateMachine = ({ data, className }) => {
       const states = data.states;
@@ -34172,12 +34478,12 @@ var init_MiniStateMachine = __esm({
         for (const e of t.effects) effectTypes.add(e.type);
       }
       const effectList = Array.from(effectTypes).slice(0, 6);
-      const totalW = states.length * NODE_W + (states.length - 1) * (GAP + ARROW_W + GAP);
+      const totalW = states.length * NODE_W + (states.length - 1) * (GAP2 + ARROW_W + GAP2);
       const svgW = Math.max(totalW + 4, 60);
       const svgH = NODE_H + (effectList.length > 0 ? 18 : 4);
       return /* @__PURE__ */ jsxs("svg", { width: svgW, height: svgH, viewBox: `0 0 ${svgW} ${svgH}`, className, children: [
         states.map((s, i) => {
-          const x = 2 + i * (NODE_W + GAP + ARROW_W + GAP);
+          const x = 2 + i * (NODE_W + GAP2 + ARROW_W + GAP2);
           const tc = transitionCounts[s.name] ?? 0;
           const role = getStateRole(s.name, s.isInitial, s.isTerminal, tc, maxTC);
           return /* @__PURE__ */ jsxs(React80__default.Fragment, { children: [
@@ -34198,9 +34504,9 @@ var init_MiniStateMachine = __esm({
               /* @__PURE__ */ jsx(
                 "line",
                 {
-                  x1: x + NODE_W + GAP,
+                  x1: x + NODE_W + GAP2,
                   y1: NODE_H / 2,
-                  x2: x + NODE_W + GAP + ARROW_W - 3,
+                  x2: x + NODE_W + GAP2 + ARROW_W - 3,
                   y2: NODE_H / 2,
                   stroke: "var(--color-muted-foreground)",
                   strokeWidth: 1,
@@ -34210,7 +34516,7 @@ var init_MiniStateMachine = __esm({
               /* @__PURE__ */ jsx(
                 "polygon",
                 {
-                  points: `${x + NODE_W + GAP + ARROW_W - 3},${NODE_H / 2 - 2.5} ${x + NODE_W + GAP + ARROW_W},${NODE_H / 2} ${x + NODE_W + GAP + ARROW_W - 3},${NODE_H / 2 + 2.5}`,
+                  points: `${x + NODE_W + GAP2 + ARROW_W - 3},${NODE_H / 2 - 2.5} ${x + NODE_W + GAP2 + ARROW_W},${NODE_H / 2} ${x + NODE_W + GAP2 + ARROW_W - 3},${NODE_H / 2 + 2.5}`,
                   fill: "var(--color-muted-foreground)",
                   opacity: 0.4
                 }
@@ -34357,6 +34663,8 @@ var init_molecules = __esm({
     init_Modal();
     init_Pagination();
     init_Popover();
+    init_Coachmark();
+    init_OnboardingSpotlight();
     init_RelationSelect();
     init_SearchInput();
     init_SidePanel();
@@ -50622,4 +50930,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BehaviorView, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, CodeBlock, CodeExample, CodeView, CodeViewer, CollapsibleSection, CombatLog, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ContentSection, ControlButton, CounterTemplate, CraftingRecipe, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, Dialog, DialogueBox, DialogueBubble, Divider, DocBreadcrumb, DocCodeBlock, DocPagination, DocSearch, DocSidebar, DocTOC, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FeatureRenderer2 as FeatureRenderer, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MatrixQuestion, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, ModuleCard, Navigation, NegotiatorBoard, NotifyListener, NumberStepper, ObjectRulePanel, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PhysicsManager, PlatformerCanvas, Popover, PositionedCanvas, PowerupSlots, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PullQuote, PullToRefresh, QrScanner, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ReplyTree, ResourceBar, ResourceCounter, RichBlockEditor, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, SectionHeader, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, StepFlow, StepFlowOrganism, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, TableView, Tabs, TagCloud, TagInput, TeamCard, TeamOrganism, TerrainPalette, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, VersionDiff, ViolationAlert, VoteStack, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, clearEntities, cn, combatAnimations, combatClasses, combatEffects, createInitialGameState, createTranslate, createUnitAnimationState, drawSprite, generateCombatMessage, getAllEntities, getByType, getCurrentFrame, getEntity, getSingleton, getTileDimensions, inferDirection, isoToScreen, mapBookData, parseQueryBinding, pendulum, projectileMotion, removeEntity, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, spawnEntity, springOscillator, tickAnimationState, transitionAnimation, updateEntity, updateSingleton, useAgentChat, useAuthContext, useBattleState, useCamera, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGameAudioContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePhysics2D, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSingletonEntity, useSpriteAnimations, useSwipeGesture, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BehaviorView, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, Coachmark, CodeBlock, CodeExample, CodeView, CodeViewer, CollapsibleSection, CombatLog, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ContentSection, ControlButton, CounterTemplate, CraftingRecipe, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, Dialog, DialogueBox, DialogueBubble, Divider, DocBreadcrumb, DocCodeBlock, DocPagination, DocSearch, DocSidebar, DocTOC, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FeatureRenderer2 as FeatureRenderer, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MatrixQuestion, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, ModuleCard, Navigation, NegotiatorBoard, NotifyListener, NumberStepper, ObjectRulePanel, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PhysicsManager, PlatformerCanvas, Popover, PositionedCanvas, PowerupSlots, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PullQuote, PullToRefresh, QrScanner, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ReplyTree, ResourceBar, ResourceCounter, RichBlockEditor, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, SectionHeader, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, StepFlow, StepFlowOrganism, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, TableView, Tabs, TagCloud, TagInput, TeamCard, TeamOrganism, TerrainPalette, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, VersionDiff, ViolationAlert, VoteStack, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, clearEntities, cn, combatAnimations, combatClasses, combatEffects, createInitialGameState, createTranslate, createUnitAnimationState, drawSprite, generateCombatMessage, getAllEntities, getByType, getCurrentFrame, getEntity, getSingleton, getTileDimensions, inferDirection, isoToScreen, mapBookData, parseQueryBinding, pendulum, projectileMotion, removeEntity, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, spawnEntity, springOscillator, tickAnimationState, transitionAnimation, updateEntity, updateSingleton, useAgentChat, useAnchorRect, useAuthContext, useBattleState, useCamera, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGameAudioContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePhysics2D, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSingletonEntity, useSpriteAnimations, useSwipeGesture, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/components/molecules/Coachmark.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Coachmark Molecule
+ *
+ * A controlled, externally-anchored popover for onboarding hints. Unlike
+ * Popover (uncontrolled, wraps its own trigger), a Coachmark is driven by
+ * `open` and points at an element it does not own — a tab button, the persona
+ * menu, a canvas node — resolved from a ref, a CSS selector, or a DOMRect.
+ * Portals to document.body so it escapes the canvas/preview transform contexts.
+ */
+import React from "react";
+export type CoachmarkPlacement = "top" | "bottom" | "left" | "right";
+export type CoachmarkAnchor = React.RefObject<HTMLElement | null> | string | DOMRect;
+export interface CoachmarkProps {
+    /** Controlled visibility. */
+    open: boolean;
+    /** The element to point at: a ref, a CSS selector, or a DOMRect. */
+    anchor: CoachmarkAnchor;
+    /** Side of the anchor to render on. @default 'bottom' */
+    placement?: CoachmarkPlacement;
+    title?: string;
+    children: React.ReactNode;
+    /** Close (X) handler — always rendered. */
+    onDismiss: () => void;
+    /** Optional filled primary action (e.g. Next / Got it). */
+    onPrimary?: () => void;
+    primaryLabel?: string;
+    /** Optional ghost secondary action (e.g. Skip). */
+    onSecondary?: () => void;
+    secondaryLabel?: string;
+    /** Render a pulsing beacon dot over the anchor (keystone hints). */
+    showBeacon?: boolean;
+    /**
+     * If the anchor can't be resolved, render the card centered in the viewport
+     * instead of hiding it. Guarantees the card (and its dismiss/skip) is always
+     * reachable — used by OnboardingSpotlight so a missing anchor never traps the
+     * user behind a dimmed backdrop. Default false: a missing anchor hides the card.
+     */
+    fallbackCentered?: boolean;
+    className?: string;
+}
+/**
+ * Tracks the live bounding rect of an anchor while `active`. Re-reads on
+ * scroll/resize, and polls a few frames so a selector that mounts just after
+ * activation (a freshly-revealed tab) still resolves.
+ */
+export declare function useAnchorRect(anchor: CoachmarkAnchor, active: boolean): DOMRect | null;
+export declare const Coachmark: React.FC<CoachmarkProps>;

package/dist/components/molecules/OnboardingSpotlight.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OnboardingSpotlight Molecule
+ *
+ * Optional first-run welcome: a dimmed backdrop with a cut-out over the current
+ * step's anchor, plus a stepped Coachmark bubble (Next / Skip). The backdrop is
+ * four dim rectangles around the anchor rect so the highlighted element stays
+ * lit and clickable-looking; the bubble and step dots reuse Coachmark.
+ */
+import React from "react";
+import { type CoachmarkAnchor, type CoachmarkPlacement } from "./Coachmark";
+export interface SpotlightStep {
+    anchor: CoachmarkAnchor;
+    placement?: CoachmarkPlacement;
+    title: string;
+    body: string;
+}
+export interface OnboardingSpotlightProps {
+    steps: SpotlightStep[];
+    /** Index of the active step. Out-of-range hides the spotlight. */
+    stepIndex: number;
+    onNext: () => void;
+    onSkip: () => void;
+    onFinish: () => void;
+    /** Padding around the cut-out, in px. @default 6 */
+    cutoutPadding?: number;
+}
+export declare const OnboardingSpotlight: React.FC<OnboardingSpotlightProps>;

package/dist/components/molecules/avl/avl-story-schemas.d.ts

@@ -14,7 +14,7 @@ export declare const CLINIC_SCHEMA: OrbitalSchema;
 /**
  * Task manager schema: 3 orbitals for a richer multi-module story.
  * - TaskOrbital (std-browse): task list
- * - TimerOrbital (std-timer): countdown timer
+ * - FocusTimer (std-list): focus session list
  * - ArchiveOrbital (std-confirmation): archive confirmation
  */
 export declare const TASK_SCHEMA: OrbitalSchema;

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

@@ -20,6 +20,8 @@ export { Menu, type MenuProps, type MenuItem } from './Menu';
 export { Modal, type ModalProps, type ModalSize } from './Modal';
 export { Pagination, type PaginationProps } from './Pagination';
 export { Popover, type PopoverProps } from './Popover';
+export { Coachmark, useAnchorRect, type CoachmarkProps, type CoachmarkPlacement, type CoachmarkAnchor, } from './Coachmark';
+export { OnboardingSpotlight, type OnboardingSpotlightProps, type SpotlightStep, } from './OnboardingSpotlight';
 export { RelationSelect, type RelationSelectProps, type RelationOption } from './RelationSelect';
 export { SearchInput, type SearchInputProps } from './SearchInput';
 export { SidePanel, type SidePanelProps } from './SidePanel';

package/dist/providers/index.cjs

@@ -13990,6 +13990,8 @@ var init_CodeBlock = __esm({
         collapsedRef.current = collapsed;
         const foldStartMapRef = React86.useRef(foldStartMap);
         foldStartMapRef.current = foldStartMap;
+        const hiddenLinesRef = React86.useRef(hiddenLines);
+        hiddenLinesRef.current = hiddenLines;
         const toggleFold = React86.useCallback((lineNum) => {
           setCollapsed((prev) => {
             const next = new Set(prev);
@@ -14102,6 +14104,60 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language, success: false });
           }
         };
+        const handleSelectionCopy = React86.useCallback((e) => {
+          if (hiddenLinesRef.current.size === 0) return;
+          const sel = typeof window !== "undefined" ? window.getSelection() : null;
+          if (!sel || sel.rangeCount === 0 || sel.isCollapsed) return;
+          const lineOf = (node) => {
+            const start = node instanceof HTMLElement ? node : node?.parentElement ?? null;
+            const lineEl = start?.closest("[data-line]");
+            if (!lineEl) return null;
+            const n = parseInt(lineEl.getAttribute("data-line") ?? "", 10);
+            return Number.isNaN(n) ? null : n;
+          };
+          const range = sel.getRangeAt(0);
+          let a = lineOf(range.startContainer);
+          let b = lineOf(range.endContainer);
+          if (a === null || b === null) {
+            const container = codeRef.current;
+            if (!container) return;
+            let min = Infinity, max = -Infinity;
+            container.querySelectorAll("[data-line]").forEach((el) => {
+              if (!sel.containsNode(el, true)) return;
+              const n = parseInt(el.getAttribute("data-line") ?? "", 10);
+              if (!Number.isNaN(n)) {
+                min = Math.min(min, n);
+                max = Math.max(max, n);
+              }
+            });
+            if (min === Infinity) return;
+            a = a ?? min;
+            b = b ?? max;
+          }
+          if (a > b) [a, b] = [b, a];
+          let touchesFold = false;
+          for (let i = a; i <= b; i++) {
+            if (hiddenLinesRef.current.has(i) || foldStartMapRef.current.has(i) && collapsedRef.current.has(i)) {
+              touchesFold = true;
+              break;
+            }
+          }
+          if (!touchesFold) return;
+          let endLine = b;
+          let changed = true;
+          while (changed) {
+            changed = false;
+            foldStartMapRef.current.forEach((region, start) => {
+              if (start >= a && start <= endLine && collapsedRef.current.has(start) && region.end > endLine) {
+                endLine = region.end;
+                changed = true;
+              }
+            });
+          }
+          const full = code.split("\n").slice(a, endLine + 1).join("\n");
+          e.clipboardData.setData("text/plain", full);
+          e.preventDefault();
+        }, [code]);
         const hasHeader = showLanguageBadge || showCopyButton;
         return /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: `relative group ${className || ""}`, style: { display: "flex", flexDirection: "column", height: "100%" }, children: [
           hasHeader && /* @__PURE__ */ jsxRuntime.jsxs(
@@ -14252,6 +14308,7 @@ var init_CodeBlock = __esm({
             "div",
             {
               ref: scrollRef,
+              onCopy: handleSelectionCopy,
               style: {
                 flex: 1,
                 minHeight: 0,