@leavepulse/ui 0.42.0 → 0.43.0

package/dist/layout/tree.d.ts

@@ -1,75 +0,0 @@
-export type Dir = "row" | "col";
-export type Side = "left" | "right" | "top" | "bottom" | "center";
-export interface Leaf {
-    kind: "leaf";
-    id: string;
-    /**
-     * Block ids stacked as tabs in this cell. A plain cell is a single-element
-     * stack; dropping onto a cell's center adds another tab. The consumer maps
-     * each id to content via the canvas slot.
-     */
-    blocks: string[];
-    /** Index into `blocks` of the visible tab. */
-    active: number;
-    /** Flex fraction among siblings. */
-    size: number;
-}
-export interface Split {
-    kind: "split";
-    id: string;
-    dir: Dir;
-    size: number;
-    children: LayoutNode[];
-}
-export type LayoutNode = Leaf | Split;
-/** Build a single-row layout from a flat list of block ids (one cell each). */
-export declare function makeLayout(blocks: string[]): Split;
-export declare function findParent(node: Split, childId: string): Split | null;
-export declare function findLeaf(node: LayoutNode, id: string): Leaf | null;
-export declare function countLeaves(node: LayoutNode): number;
-/** Total blocks across all cells (a tabbed cell counts each of its tabs). */
-export declare function countBlocks(node: LayoutNode): number;
-/** Remove an entire cell (with all its tabs). */
-export declare function removeLeaf(root: Split, id: string): void;
-/**
- * Remove one tab from a cell. Removing the last tab removes the cell itself
- * (unless it's the only block left in the whole layout, which is kept).
- */
-export declare function removeBlock(root: Split, leafId: string, index: number): void;
-export declare function addLeaf(root: Split, block: string, side?: Side): void;
-/** Append a block as a new tab in the target cell and focus it. */
-export declare function addTab(root: Split, leafId: string, block: string): void;
-/** Switch the visible tab of a cell. */
-export declare function setActiveTab(root: Split, leafId: string, index: number): void;
-/**
- * Reorder a tab within its cell, moving the block at `from` to `to`. The same
- * block stays visible afterwards (active follows the moved block by identity,
- * not by index). Always available — not gated by edit mode.
- */
-export declare function reorderTab(root: Split, leafId: string, from: number, to: number): void;
-/**
- * Move an existing cell to a target. An edge side splits beside the target;
- * `center` merges the moving cell's tabs into the target cell (and focuses
- * the first moved tab).
- */
-export declare function moveLeaf(root: Split, movingId: string, targetId: string, side: Side): void;
-/** Splitter drag: redistribute size between two adjacent siblings. */
-export declare function resizeAt(parent: Split, index: number, deltaFraction: number): void;
-interface SerializedLeaf {
-    kind: "leaf";
-    blocks: string[];
-    active: number;
-    size: number;
-    /** Legacy single-block form (pre-tabs); hydrated into `blocks`. */
-    block?: string;
-}
-interface SerializedSplit {
-    kind: "split";
-    dir: Dir;
-    size: number;
-    children: SerializedNode[];
-}
-type SerializedNode = SerializedLeaf | SerializedSplit;
-export declare function serializeLayout(root: Split): SerializedNode;
-export declare function deserializeLayout(data: SerializedNode): Split;
-export {};

package/dist/layout/useLayout.d.ts

@@ -1,39 +0,0 @@
-import { Ref } from 'vue';
-import { Side, Split } from './tree';
-export interface UseLayoutOptions {
-    /** Initial block ids, left-to-right, when no saved layout is loaded. */
-    initial: string[];
-    /** Max undo depth. */
-    historyLimit?: number;
-}
-export interface UseLayout {
-    /** The live reactive tree to hand to <LayoutCanvas v-model>. */
-    layout: Ref<Split>;
-    /** Block count across all tabs, handy for "N blocks" labels and guards. */
-    count: Ref<number>;
-    canUndo: Ref<boolean>;
-    canRedo: Ref<boolean>;
-    /** Add a block: a new cell on an edge, or a tab on the last cell (center). */
-    add: (block: string, side?: Side) => void;
-    /** Add a block as a tab in a specific cell. */
-    addTab: (leafId: string, block: string) => void;
-    /** Switch the visible tab of a cell. */
-    setActive: (leafId: string, index: number) => void;
-    /** Reorder a tab within its cell (always available, not edit-gated). */
-    reorderTab: (leafId: string, from: number, to: number) => void;
-    /** Remove one tab (drops the cell when it was the last tab). */
-    removeBlock: (leafId: string, index: number) => void;
-    /** Remove an entire cell with all its tabs. */
-    remove: (leafId: string) => void;
-    move: (movingId: string, targetId: string, side: Side) => void;
-    resize: (parent: Split, index: number, deltaFraction: number) => void;
-    undo: () => void;
-    redo: () => void;
-    /** Replace the whole layout from a flat block list. */
-    reset: (blocks?: string[]) => void;
-    /** Serialize to JSON-safe data for persistence. */
-    serialize: () => unknown;
-    /** Replace the layout from previously serialized data. */
-    hydrate: (data: unknown) => void;
-}
-export declare function useLayout(options: UseLayoutOptions): UseLayout;

package/dist/theme/backdrop.d.ts

@@ -1,9 +0,0 @@
-/** Set on <html> when backdrop-filter resolves but does not composite. */
-export declare const NO_BACKDROP_ATTR = "data-lp-no-backdrop";
-export declare function isBrokenBackdropEngine(nav?: Navigator): boolean;
-/**
- * Flag the document when backdrop-filter cannot be trusted, so the fallback
- * rules in tokens.css can trade blur for opacity. Safe to call more than once
- * and a no-op outside the browser.
- */
-export declare function detectBackdropFilter(root?: HTMLElement): boolean;

package/dist/theme/config.d.ts

@@ -1,16 +0,0 @@
-import { Split } from '../layout/tree';
-import { TokenSet } from './tokens';
-export declare const UI_CONFIG_VERSION = 1;
-export interface UiConfig {
-    version: number;
-    theme: TokenSet;
-    /** Optional — apps without a composable layout omit it. */
-    layout?: Split;
-}
-export interface SerializedUiConfig {
-    version: number;
-    theme: TokenSet;
-    layout?: unknown;
-}
-export declare function serializeConfig(config: UiConfig): string;
-export declare function parseConfig(json: string): UiConfig;

package/dist/theme/define.d.ts

@@ -1,12 +0,0 @@
-import { presets } from './presets';
-import { ColorTokens, DensityTokens, FontTokens, ShapeTokens, SurfaceTokens, TokenSet } from './tokens';
-export interface ThemeOverrides {
-    name?: string;
-    mode?: "dark" | "light";
-    colors?: Partial<ColorTokens>;
-    shape?: Partial<ShapeTokens>;
-    density?: Partial<DensityTokens>;
-    font?: Partial<FontTokens>;
-    surface?: Partial<SurfaceTokens>;
-}
-export declare function defineTheme(base: TokenSet | keyof typeof presets, overrides?: ThemeOverrides): TokenSet;

package/dist/theme/presets.d.ts

@@ -1,20 +0,0 @@
-import { TokenSet } from './tokens';
-export declare const dark: TokenSet;
-export declare const light: TokenSet;
-export declare const lime: TokenSet;
-export declare const leavepulse: TokenSet;
-export declare const rose: TokenSet;
-export declare const amber: TokenSet;
-export declare const violet: TokenSet;
-export declare const nord: TokenSet;
-export declare const presets: {
-    readonly dark: TokenSet;
-    readonly light: TokenSet;
-    readonly lime: TokenSet;
-    readonly leavepulse: TokenSet;
-    readonly rose: TokenSet;
-    readonly amber: TokenSet;
-    readonly violet: TokenSet;
-    readonly nord: TokenSet;
-};
-export type PresetName = keyof typeof presets;

package/dist/theme/tokens.d.ts

@@ -1,75 +0,0 @@
-export interface ColorTokens {
-    surface: string;
-    surfaceRaised: string;
-    surfaceSoft: string;
-    ink: string;
-    inkInverse: string;
-    muted: string;
-    mutedStrong: string;
-    brand: string;
-    brandHover: string;
-    brandSoft: string;
-    action: string;
-    actionHover: string;
-    actionSoft: string;
-    accent: string;
-    accentHover: string;
-    accentSoft: string;
-    danger: string;
-    dangerHover: string;
-    dangerSoft: string;
-    line: string;
-    lineStrong: string;
-    ring: string;
-}
-export interface ShapeTokens {
-    radiusControl: number;
-    radiusCard: number;
-    radiusPill: number;
-}
-export interface DensityTokens {
-    /** base spacing unit in px */
-    spacingUnit: number;
-    controlSm: number;
-    controlMd: number;
-    controlLg: number;
-}
-export interface FontTokens {
-    /** CSS font-family stack for UI text */
-    sans: string;
-    /** CSS font-family stack for numerals / code */
-    mono: string;
-}
-export interface SurfaceTokens {
-    /** Border width for panels/cards/controls (CSS length, e.g. "1px"). */
-    borderWidth: string;
-    /** backdrop-filter blur radius (CSS length; "0" disables glass blur). */
-    panelBlur: string;
-    /** backdrop-filter saturate (unitless or %, e.g. "100%" / "180%"). */
-    panelSaturate: string;
-    /** Overlay painted over a panel's base color ("none" or a gradient). */
-    panelOverlay: string;
-    /** Box-shadow for a raised panel (may be multi-layer for glass). */
-    panelShadow: string;
-    /** Inset highlight line for a panel ("none" or an inset box-shadow). */
-    panelInset: string;
-}
-export interface TokenSet {
-    /** human label, e.g. "Lime" */
-    name: string;
-    /** "dark" | "light" — drives `color-scheme` and the data-theme-mode hint */
-    mode: "dark" | "light";
-    colors: ColorTokens;
-    shape: ShapeTokens;
-    density: DensityTokens;
-    font: FontTokens;
-    /** Optional skin axis; older themes without it fall back to a flat default. */
-    surface?: SurfaceTokens;
-}
-/** camelCase token key → CSS custom property name. */
-export declare const COLOR_VARS: Record<keyof ColorTokens, string>;
-export declare const SHAPE_VARS: Record<keyof ShapeTokens, string>;
-export declare const DENSITY_VARS: Record<keyof DensityTokens, string>;
-export declare const FONT_VARS: Record<keyof FontTokens, string>;
-export declare const SURFACE_VARS: Record<keyof SurfaceTokens, string>;
-export declare const DEFAULT_SURFACE: SurfaceTokens;

package/dist/theme/useTheme.d.ts

@@ -1,46 +0,0 @@
-import { ComputedRef, DeepReadonly, Ref } from 'vue';
-import { TokenSet } from './tokens';
-export declare function applyTheme(theme: TokenSet, root?: HTMLElement): void;
-/** Point a circular theme reveal expands from (viewport px). */
-export interface RevealOrigin {
-    x: number;
-    y: number;
-}
-export declare function applyThemeWithTransition(theme: TokenSet, origin?: RevealOrigin, root?: HTMLElement, durationMs?: number): void;
-export declare function serializeTheme(theme: TokenSet): string;
-export declare function themeToCssVars(theme: TokenSet): string;
-/** Render a theme as a complete CSS rule (default selector `:root`). */
-export declare function themeToCssRule(theme: TokenSet, selector?: string): string;
-/** Parse + shallow-validate a theme JSON; throws on a malformed shape. */
-export declare function parseTheme(json: string): TokenSet;
-export declare function bootstrapTheme(fallback: TokenSet): TokenSet;
-export declare function cacheTheme(theme: TokenSet): void;
-export declare const THEME_COOKIE = "lp-theme";
-/**
- * Resolve a theme name (as read from the `lp-theme` cookie) against a set of
- * known themes. Returns `null` when the name is absent or unknown, so the caller
- * can fall back to its own default.
- *
- * Server-side counterpart to `cacheTheme`: pair it with `themeToCssRule` to
- * inline the right variables into `<head>` during SSR.
- */
-export declare function themeFromCookie(cookieValue: string | null | undefined, themes: readonly TokenSet[]): TokenSet | null;
-export interface UseTheme {
-    /** The active theme, kept in sync by the kit. Null until hydrated (SSR/first
-     *  paint) — reactive, so a switcher binds straight to it. */
-    current: DeepReadonly<Ref<TokenSet | null>>;
-    /** The active theme's name (""="not yet hydrated"). */
-    currentName: ComputedRef<string>;
-    /** Set + persist a theme (with the circular reveal if `origin`/transition).
-     *  This is the one call a switcher needs — it updates `current` too. */
-    setTheme: (theme: TokenSet, origin?: RevealOrigin) => void;
-    /** Seed the fallback (used when nothing is cached) and hydrate now. Call once
-     *  at app start (client) — optional; the first useTheme() hydrates anyway. */
-    init: (fallback: TokenSet) => TokenSet;
-    apply: (theme: TokenSet) => void;
-    applyWithTransition: (theme: TokenSet, origin?: RevealOrigin) => void;
-    serialize: typeof serializeTheme;
-    parse: typeof parseTheme;
-    bootstrap: typeof bootstrapTheme;
-}
-export declare function useTheme(): UseTheme;