@almadar/shell-web 0.0.0-stage → 0.1.0

package/bundling.d.mts

@@ -0,0 +1,18 @@
+/** What `keepDynamicImportsLazy` reads of Rollup's module graph. */
+export interface BundlingModuleInfo {
+  isEntry: boolean;
+  /** Static importers only (Rollup lists dynamic ones separately). */
+  importers: readonly string[];
+}
+
+export interface BundlingChunkMeta {
+  getModuleInfo(id: string): BundlingModuleInfo | null;
+}
+
+/**
+ * Wraps an app's `manualChunks` rule: a module goes to the named chunk only when an entry reaches
+ * it through static imports, so @almadar/ui's lazily imported families stay lazy.
+ */
+export declare function keepDynamicImportsLazy(
+  assign: (id: string) => string | null | undefined,
+): (id: string, meta: BundlingChunkMeta) => string | null | undefined;

package/bundling.mjs

@@ -0,0 +1,28 @@
+/**
+ * Build-time helper for apps bundling @almadar/ui. The ui loads heavy families lazily (mermaid
+ * and what it pulls, leaflet, …) through dynamic import(); an app's catch-all `manualChunks`
+ * would move them into its eagerly loaded vendor chunk. Wrap it: a module goes to the named
+ * chunk only when an entry reaches it through static imports.
+ */
+export function keepDynamicImportsLazy(assign) {
+  const memo = new WeakMap();
+  return (id, meta) => {
+    const name = assign(id);
+    if (!name) return name;
+    let known = memo.get(meta.getModuleInfo);
+    if (!known) {
+      known = new Map();
+      memo.set(meta.getModuleInfo, known);
+    }
+    return staticallyReachable(id, meta.getModuleInfo, known) ? name : undefined;
+  };
+}
+
+function staticallyReachable(id, getModuleInfo, known) {
+  if (known.has(id)) return known.get(id);
+  known.set(id, false); // in progress: a cycle does not reach an entry by itself
+  const info = getModuleInfo(id);
+  const reachable = info === null || info.isEntry || info.importers.some((importer) => staticallyReachable(importer, getModuleInfo, known));
+  known.set(id, reachable);
+  return reachable;
+}

package/dist/ArbitraryClassCompiler-Mzabq-UB.d.ts

@@ -0,0 +1,100 @@
+import * as React from 'react';
+import React__default, { ReactNode, ReactElement } from 'react';
+import { ThemeRef, OrbitalSchema } from '@almadar/core';
+import './EventBusProvider-CVwjkV_2.js';
+import { T as ThemeProviderProps } from './ThemeContext-DJmO59xd.js';
+
+/**
+ * OrbitalThemeProvider — runtime application of `OrbitalDefinition.theme`.
+ *
+ * Wraps an orbital's rendered subtree in a surface `Box` that sets the
+ * CSS variables derived from `theme.tokens` (and `variants.dark` when the
+ * resolved color mode is dark). Inline custom-property declarations on the
+ * wrapper override any `[data-theme]` selector rule for the same variable
+ * within the subtree, while letting unset variables cascade from the parent.
+ *
+ * Mapping is delegated to `themeTokensToCssVars`, which mirrors the Rust
+ * compiler's `generate_tokens_css`. Compile-time and runtime produce the
+ * same CSS variable map for the same `ThemeDefinition` input, so a Studio
+ * Design System edit and an `orbital compile` of the same schema render
+ * identically.
+ *
+ * A registry theme key (e.g. `"gazette-light"`) scopes that preset to the
+ * subtree through `data-theme` on a wrapper that paints the theme's
+ * background, so an orbital renders in its declared theme even inside a host
+ * document running another one (playground picker, runtime-verify catalog).
+ *
+ * No-op when:
+ * - `theme` is `undefined` (orbital declares no theme — parent cascades)
+ * - `theme` is the legacy `"Alias.theme"` import form that didn't get inlined upstream
+ *
+ * @example
+ * ```tsx
+ * <OrbitalThemeProvider theme={orbital.theme}>
+ *   <UISlotRenderer />
+ * </OrbitalThemeProvider>
+ * ```
+ */
+
+interface OrbitalThemeProviderProps {
+    /** The `OrbitalDefinition.theme` value (inline definition or string ref). */
+    theme?: ThemeRef;
+    /**
+     * A host's explicit theme pick (registry key, e.g. the playground picker).
+     * Replaces `theme` here, in every nested orbital scope, and on every
+     * `data-theme` a component declares inside (see `ThemeScope.override`).
+     */
+    override?: string;
+    children: ReactNode;
+}
+declare function OrbitalThemeProvider({ theme: declared, override, children }: OrbitalThemeProviderProps): ReactElement;
+declare namespace OrbitalThemeProvider {
+    var displayName: string;
+}
+
+/**
+ * @deprecated Use ThemeProvider from ThemeContext instead
+ */
+declare const DesignThemeProvider: React.FC<ThemeProviderProps>;
+/**
+ * @deprecated Use useTheme from ThemeContext instead
+ *
+ * This wrapper provides backward compatibility with the old API.
+ */
+declare function useDesignTheme(): {
+    designTheme: string;
+    setDesignTheme: (theme: string) => void;
+    availableThemes: string[];
+};
+
+declare const CurrentPagePathContext: React__default.Context<string | undefined>;
+interface CurrentPagePathProviderProps {
+    value: string | undefined;
+    children: React__default.ReactNode;
+}
+declare const CurrentPagePathProvider: React__default.FC<CurrentPagePathProviderProps>;
+declare const useCurrentPagePath: () => string | 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
+ * schemas at runtime provides a compiler (e.g. the builder's server running
+ * Tailwind with this package's preset — `@almadar/ui/tailwind-compile`);
+ * `useArbitraryClassStyles(schema)` compiles each class once and appends its
+ * CSS to one shared `<style>`. Without a provider it does nothing.
+ */
+
+declare const ARBITRARY_CLASS_STYLE_ID = "almadar-arbitrary-classes";
+/** Compiles Tailwind classes to CSS. */
+type ArbitraryClassCompiler = (classes: string[]) => Promise<string>;
+interface ArbitraryClassCompilerProviderProps {
+    compile: ArbitraryClassCompiler;
+    children: React__default.ReactNode;
+}
+declare function ArbitraryClassCompilerProvider({ compile, children }: ArbitraryClassCompilerProviderProps): React__default.ReactElement;
+/** Forget what was compiled and drop the stylesheet (tests; a fresh document). */
+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 };

package/dist/AvlGlyph-JKJOAH23.js

@@ -0,0 +1,6 @@
+export { AVL_GLYPH_KINDS, AvlGlyph } from './chunk-L677XGY3.js';
+import './chunk-FP3WIKTC.js';
+import './chunk-DZ42OJQC.js';
+import './chunk-DFNZUYX4.js';
+import './chunk-MBQAMMSE.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlStateMachine-PI4YGREK.js

@@ -0,0 +1,8 @@
+export { AvlStateMachine } from './chunk-KVQS4GXU.js';
+import './chunk-GAR5TQ5B.js';
+import './chunk-SJGJJKBY.js';
+import './chunk-DZ42OJQC.js';
+import './chunk-TZZBINQY.js';
+import './chunk-DFNZUYX4.js';
+import './chunk-MBQAMMSE.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlTransitionDetail-ZH7V24UG.js

@@ -0,0 +1,12 @@
+export { AvlTransitionDetail } from './chunk-SGM3FASH.js';
+import './chunk-U6QRZASX.js';
+import './chunk-42FY4RYA.js';
+import './chunk-FAJDTHWC.js';
+import './chunk-GAR5TQ5B.js';
+import './chunk-SJGJJKBY.js';
+import './chunk-DZ42OJQC.js';
+import './chunk-VFF5OO47.js';
+import './chunk-DFNZUYX4.js';
+import './chunk-DYEKAA4L.js';
+import './chunk-MBQAMMSE.js';
+import './chunk-G7DCAZ22.js';

package/dist/AvlTransitionExplainer-ZSRT7L6Y.js

@@ -0,0 +1,13 @@
+export { AvlTransitionExplainer } from './chunk-TESBIVUA.js';
+import './chunk-SGM3FASH.js';
+import './chunk-U6QRZASX.js';
+import './chunk-42FY4RYA.js';
+import './chunk-FAJDTHWC.js';
+import './chunk-GAR5TQ5B.js';
+import './chunk-SJGJJKBY.js';
+import './chunk-DZ42OJQC.js';
+import './chunk-VFF5OO47.js';
+import './chunk-DFNZUYX4.js';
+import './chunk-DYEKAA4L.js';
+import './chunk-MBQAMMSE.js';
+import './chunk-G7DCAZ22.js';

package/dist/BehaviorValueFrame-6RUJXT4A.js

@@ -0,0 +1,29 @@
+export { BehaviorValueFrame, BehaviorValueFrame_default as default } from './chunk-2QOH2HWM.js';
+import './chunk-FIW6WN23.js';
+import './chunk-GYTPOFVC.js';
+import './chunk-YDNJLLG6.js';
+import './chunk-KVQS4GXU.js';
+import './chunk-L677XGY3.js';
+import './chunk-FP3WIKTC.js';
+import './chunk-42FY4RYA.js';
+import './chunk-FAJDTHWC.js';
+import './chunk-GAR5TQ5B.js';
+import './chunk-SJGJJKBY.js';
+import './chunk-DZ42OJQC.js';
+import './chunk-P4LNHAFI.js';
+import './chunk-TZZBINQY.js';
+import './chunk-PC7K4SK7.js';
+import './chunk-VFF5OO47.js';
+import './chunk-DFNZUYX4.js';
+import './chunk-B4BU77LT.js';
+import './chunk-6P3MWXYE.js';
+import './chunk-DYEKAA4L.js';
+import './chunk-R5O5AUPI.js';
+import './chunk-L2DEKY4J.js';
+import './chunk-AILY3XPS.js';
+import './chunk-3BBUBJFF.js';
+import './chunk-YHMRX6YA.js';
+import './chunk-MBQAMMSE.js';
+import './chunk-A2LR6VQQ.js';
+import './chunk-P4ZFUQFF.js';
+import './chunk-G7DCAZ22.js';