@signal9/era-ui 3.5.1 → 3.7.0

package/dist/ui/logo/logo.svelte.d.ts

@@ -0,0 +1,181 @@
+/**
+ * SIGNALNINE dish — the logo, in one self-contained file.
+ *
+ * Zero imports and zero dependencies, deliberately: this file is the mark's
+ * portable master copy, so it stays droppable into any Svelte 5 project
+ * unchanged. It is the one component in the library that does NOT consume
+ * --era-* tokens — a logo has fixed brand geometry and colour, and must
+ * render identically whatever density, surface, or theme surrounds it.
+ * Do not "fix" that by tokenising it.
+ *
+ * A nonagon satellite dish modeled as a true closed shell (inner bowl, outer
+ * underside cone, rim wall), orthographically projected to plain SVG polygons
+ * with painter depth-sorting, backface culling, and Lambert shading in oklch.
+ * No rendering library — the math below is the product.
+ *
+ * The render math and physics tables are exported from this module block, so
+ * tooling (labs, exporters, tests) can reuse them without duplicating
+ * geometry:
+ *   import { Logo, renderLogoMarkup, PAL } from './index.js';
+ *
+ * Colors, geometry constants, and defaults are final brand decisions.
+ *
+ * Ported from blog.signalnine.dev (src/lib/SignalnineDish.svelte); era-ui is
+ * now the canonical home. Public types/functions were renamed Dish* -> Logo*;
+ * the geometry and physics are untouched.
+ */
+export type LogoPalette = 'amber' | 'chrome' | 'steel';
+export type LogoState = 'manual' | 'idle' | 'loading' | 'search' | 'transmit' | 'success' | 'error' | 'sleep';
+export type HueOverride = {
+    hD: number;
+    hL: number;
+    C: number;
+};
+export type Ring = {
+    r: number;
+    rise: number;
+    a: number;
+    w: number;
+};
+export interface LogoParams {
+    /** 0 flat plate → 100 deepest dish (mouth always full width). */
+    depth?: number;
+    /** Core-inlay dilate, 40–240 (%). */
+    inset?: number;
+    /** View elevation, 0 flat 2D face-on → 100 edge-on/underside. */
+    tilt?: number;
+    /** Screen-plane rotation, degrees. */
+    aim?: number;
+    /** Key-light orbit around the dish axis, degrees. */
+    light?: number;
+    palette?: LogoPalette;
+    /** Global luminance multiplier (sleep dims to 0.5). */
+    dim?: number;
+    /** Rotor spin, degrees (loading preset). */
+    spin?: number;
+    /** Core opacity multiplier (error blink). */
+    feedBlink?: number;
+    /** Core radius multiplier (transmit pulse). */
+    feedPulse?: number;
+    /** Rising transmit/success rings. */
+    rings?: Ring[] | null;
+    /** State recolor (error red, success green). */
+    hueOv?: HueOverride | null;
+}
+export declare const LOGO_STATES: LogoState[];
+export declare const wrap: (d: number) => number;
+export declare const clamp: (v: number, a: number, b: number) => number;
+export declare const norm360: (v: number) => number;
+export declare const PAL: Record<LogoPalette, {
+    Cm: number;
+    hD: number;
+    hL: number;
+    loI: number;
+    hiI: number;
+    loO: number;
+    hiO: number;
+    dot: string;
+    tile: string;
+}>;
+export declare const PALETTES: LogoPalette[];
+/** oklch → sRGB hex, for portable export. */
+export declare function oklchToHex(Lc: number, C: number, H: number): string;
+/** One frame of the dish, as inner SVG markup for a -100 -100 200 200 canvas. */
+export declare function renderLogoMarkup(params?: LogoParams): string;
+/** Standalone portable SVG of a pose — oklch converted to sRGB hex. */
+export declare function logoSvgDocument(params?: LogoParams, size?: number): string;
+export declare const SPR: {
+    readonly depth: {
+        readonly k: 70;
+        readonly c: 12;
+    };
+    readonly inset: {
+        readonly k: 80;
+        readonly c: 13;
+    };
+    readonly tilt: {
+        readonly k: 34;
+        readonly c: 7;
+    };
+    readonly aim: {
+        readonly k: 26;
+        readonly c: 5.2;
+    };
+    readonly light: {
+        readonly k: 90;
+        readonly c: 17;
+    };
+};
+export type Dof = keyof typeof SPR;
+export type LogoSim = Record<Dof, {
+    v: number;
+    vel: number;
+}> & {
+    /** Where a spinning light has committed to stop. Always AHEAD of the
+     *  current angle, so the sweep never reverses to get home. */
+    light: {
+        v: number;
+        vel: number;
+        park?: number | null;
+    };
+};
+export type Fx = {
+    spinV: number;
+    dim: number;
+    feedBlink: number;
+    feedPulse: number;
+    rings: Ring[] | null;
+    hueOv: HueOverride | null;
+};
+export declare function createSim(p: Required<Pick<LogoParams, Dof>>): LogoSim;
+/** Where the key light parks at rest. Every preset targets this (or an offset
+ *  from it), so moving it re-lights the mark everywhere at once. */
+export declare const REST_LIGHT = 250;
+/** Fixed physics step. Long frames are sub-stepped rather than integrated in
+ *  one huge leap — a stalled frame (e.g. the main thread finishing a
+ *  navigation) would otherwise blow the spring up and snap the pose. */
+export declare const FIXED_STEP: number;
+/**
+ * Advance every spring one step toward its target.
+ *
+ * `coastLight` cuts the light's spring drive while it is still orbiting fast,
+ * leaving only drag — the sweep spins down like a motor losing power instead
+ * of being yanked to the nearest rest angle (which reverses it) or whipped to
+ * one a full turn ahead (which speeds it up). Once it drops below SPIN_CARRY
+ * the spring takes over and parks it.
+ */
+export declare function integrate(sim: LogoSim, tgt: Record<Dof, number>, dt: number, coastLight?: boolean): void;
+/**
+ * Per-state spring targets and visual effects. Mutates `sim` for impulses.
+ *
+ * Tilt targets are expressed RELATIVE to `baseTilt` (the mark's resting
+ * elevation), so a mark parked at a different tilt keeps its silhouette
+ * through every preset instead of springing back to the stock 55. At the
+ * default 55 the numbers are identical to the original absolute table.
+ */
+export declare function stateFrame(st: LogoState, t: number, scl: number, sim: LogoSim, jolt: {
+    last: number;
+    sign: number;
+}, baseTilt?: number): {
+    tgt: Record<Dof, number>;
+    fx: Fx;
+};
+type $$ComponentProps = {
+    depth?: number;
+    tilt?: number;
+    aim?: number;
+    light?: number;
+    inset?: number;
+    palette?: LogoPalette;
+    /** 'manual' renders a static pose; any other state animates its preset. */
+    state?: LogoState;
+    size?: number;
+    /** Deepen the bowl while held, then spring back on release. */
+    pressable?: boolean;
+    class?: string;
+};
+declare const Logo: import("svelte").Component<$$ComponentProps, {
+    exportSVG: () => string;
+}, "">;
+type Logo = ReturnType<typeof Logo>;
+export default Logo;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@signal9/era-ui",
-	"version": "3.5.1",
+	"version": "3.7.0",
 	"scripts": {
 		"dev": "vite dev --host",
 		"build": "vite build && npm run prepack",