@lcars-gui/federation 0.0.0-stage → 0.1.1

package/dist/index.js

@@ -0,0 +1,155 @@
+// src/shared.ts
+function colorAttribute(color) {
+  return color ? { "data-color": String(color) } : {};
+}
+
+// src/button.ts
+var defaultButtonProps = {
+  color: 1,
+  size: "m",
+  shape: "capsule",
+  align: "center",
+  disabled: false
+};
+var buttonClassName = "lcar-btn-std";
+function normalizeButtonProps(props) {
+  return {
+    ...defaultButtonProps,
+    ...props
+  };
+}
+function buttonDataAttributes(props) {
+  const { color, size, length, shape, align } = normalizeButtonProps(props);
+  return {
+    "data-color": String(color),
+    "data-size": size,
+    ...length && { "data-length": length },
+    ...shape !== "capsule" && { "data-shape": shape },
+    ...align === "bottom-right" && { "data-align": "br" }
+  };
+}
+
+// src/frame.ts
+var frameClassNames = {
+  elbow: "lcar-elbow",
+  bar: "lcar-bar",
+  block: "lcar-block",
+  title: "lcar-title",
+  stack: "lcar-stack",
+  frame: "lcar-frame",
+  frameTop: "lcar-frame-top",
+  frameBottom: "lcar-frame-bottom",
+  frameContent: "lcar-frame-content",
+  frameHeader: "lcar-frame-header"
+};
+function elbowDataAttributes({ corner = "tl", color }) {
+  return { "data-corner": corner, ...colorAttribute(color) };
+}
+function barDataAttributes({ color, cap, length }) {
+  return {
+    ...colorAttribute(color),
+    ...cap && { "data-cap": cap },
+    ...length && { "data-length": length }
+  };
+}
+function blockDataAttributes({ color, fill }) {
+  return {
+    ...colorAttribute(color),
+    ...fill && { "data-fill": "" }
+  };
+}
+
+// src/display.ts
+import { seededRandom } from "@lcars-gui/core";
+var displayClassNames = {
+  cascade: "lcar-cascade",
+  cascadeCol: "lcar-cascade-col",
+  readout: "lcar-readout",
+  number: "lcar-number",
+  divider: "lcar-divider",
+  grid: "lcar-grid",
+  level: "lcar-level",
+  gauge: "lcar-gauge",
+  sensor: "lcar-sensor",
+  blip: "lcar-blip",
+  scan: "lcar-scan",
+  status: "lcar-status",
+  alert: "lcar-alert",
+  alertTitle: "lcar-alert-title",
+  alertText: "lcar-alert-text"
+};
+var controlClassNames = {
+  tabs: "lcar-tabs",
+  tablist: "lcar-tablist",
+  tab: "lcar-tab",
+  tabpanel: "lcar-tabpanel",
+  field: "lcar-field",
+  fieldLabel: "lcar-field-label",
+  input: "lcar-input",
+  range: "lcar-range",
+  keypad: "lcar-keypad",
+  keypadDisplay: "lcar-keypad-display"
+};
+function cascadeNumbers(columns, rows, seed = 47) {
+  const random = seededRandom(seed);
+  return Array.from({ length: columns }, (_, col) => {
+    const digits = 2 + col * 3 % 5;
+    return Array.from(
+      { length: rows },
+      () => String(Math.floor(random() * 10 ** digits)).padStart(digits, "0")
+    );
+  });
+}
+function levelSegments(value, segments = 10, max = 100) {
+  const lit = Math.round(Math.min(Math.max(value, 0), max) / max * segments);
+  return Array.from({ length: segments }, (_, i) => i < lit);
+}
+function toPercent(value, max = 100) {
+  return Math.min(Math.max(value / max * 100, 0), 100);
+}
+
+// src/behaviors.ts
+import { initBehaviors } from "@lcars-gui/core";
+import { pressedChangeEvent } from "@lcars-gui/core";
+function initLcars(options = {}) {
+  fillCascades(options.root);
+  return initBehaviors(
+    {
+      control: `.${buttonClassName}, .${controlClassNames.tab}`,
+      keypad: `.${controlClassNames.keypad}`,
+      keypadKey: `.${buttonClassName}`,
+      keypadDisplay: `.${controlClassNames.keypadDisplay}`
+    },
+    options
+  );
+}
+function fillCascades(root = document) {
+  root.querySelectorAll(`.${displayClassNames.cascade}[data-columns]`).forEach((el, k) => {
+    const { columns, rows = "6", seed } = el.dataset;
+    const data = cascadeNumbers(Number(columns), Number(rows), seed ? Number(seed) : 47 + k);
+    el.innerHTML = data.map((col, c) => `<div class="${displayClassNames.cascadeCol}">${col.map((n, r) => `<span style="--i:${r * 2 + c}">${n}</span>`).join("")}</div>`).join("");
+  });
+}
+
+// src/index.ts
+import { createLcarsSound } from "@lcars-gui/core";
+export {
+  barDataAttributes,
+  blockDataAttributes,
+  buttonClassName,
+  buttonDataAttributes,
+  cascadeNumbers,
+  colorAttribute,
+  controlClassNames,
+  createLcarsSound,
+  defaultButtonProps,
+  displayClassNames,
+  elbowDataAttributes,
+  fillCascades,
+  frameClassNames,
+  initLcars,
+  levelSegments,
+  normalizeButtonProps,
+  pressedChangeEvent,
+  toPercent
+};

package/dist/react/index.d.ts

@@ -0,0 +1,241 @@
+import * as react from 'react';
+import { ButtonHTMLAttributes, HTMLAttributes, ReactNode, InputHTMLAttributes } from 'react';
+import { LcarsSoundKind } from '@lcars-gui/core';
+export { LcarsSoundKind } from '@lcars-gui/core';
+export { SoundProvider, SoundProviderProps, useLcarsSound } from '@lcars-gui/core/react';
+
+type LcarsColor = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+type LcarsLength = "xs" | "s" | "m" | "l" | "xl";
+
+type ButtonColor = LcarsColor;
+type ButtonSize = "xs" | "s" | "m" | "l" | "xl";
+type ButtonLength = LcarsLength;
+type ButtonShape = "capsule" | "rect" | "cap-left" | "cap-right";
+type ButtonAlign = "center" | "bottom-right";
+/**
+ * Platform-neutral button props (without events/children,
+ * those come from the respective renderer).
+ */
+interface ButtonProps$1 {
+    color?: ButtonColor;
+    size?: ButtonSize;
+    length?: ButtonLength;
+    shape?: ButtonShape;
+    align?: ButtonAlign;
+    disabled?: boolean;
+}
+
+type ElbowCorner = "tl" | "tr" | "bl" | "br";
+type BarCap = "left" | "right" | "both";
+interface ElbowProps$1 {
+    corner?: ElbowCorner;
+    color?: LcarsColor;
+}
+interface BarProps$1 {
+    color?: LcarsColor;
+    cap?: BarCap;
+    length?: LcarsLength;
+}
+interface BlockProps$1 {
+    color?: LcarsColor;
+    fill?: boolean;
+}
+
+type LcarsTheme = "tng" | "ds9" | "picard";
+type AlertLevel = "red" | "yellow";
+type StatusKind = "ok" | "warn" | "error" | "off";
+type Orientation = "horizontal" | "vertical";
+
+type ButtonProps = ButtonProps$1 & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "color"> & {
+    /** Sound on click (only inside a SoundProvider); false = silent */
+    sound?: LcarsSoundKind | false;
+};
+declare const Button: react.ForwardRefExoticComponent<ButtonProps$1 & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "color"> & {
+    /** Sound on click (only inside a SoundProvider); false = silent */
+    sound?: LcarsSoundKind | false;
+} & react.RefAttributes<HTMLButtonElement>>;
+
+type DivProps$1 = Omit<HTMLAttributes<HTMLDivElement>, "color">;
+type ElbowProps = ElbowProps$1 & DivProps$1;
+/** L-shaped corner that connects the sidebar and a bar. */
+declare function Elbow({ corner, color, className, ...rest }: ElbowProps): react.JSX.Element;
+type BarProps = BarProps$1 & DivProps$1;
+/** Horizontal bar, optionally with a rounded end (end cap). */
+declare function Bar({ color, cap, length, className, ...rest }: BarProps): react.JSX.Element;
+type BlockProps = BlockProps$1 & DivProps$1;
+/** Rectangular segment, e.g. in the sidebar; the label sits bottom right. */
+declare function Block({ color, fill, className, ...rest }: BlockProps): react.JSX.Element;
+type TitleProps = {
+    color?: LcarsColor;
+} & Omit<HTMLAttributes<HTMLHeadingElement>, "color">;
+/** Title in the bar row. */
+declare function Title({ color, className, ...rest }: TitleProps): react.JSX.Element;
+/** Vertical stack of segments with even gaps. */
+declare function Stack({ className, ...rest }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
+interface FrameProps extends Omit<DivProps$1, "title"> {
+    color?: LcarsColor;
+    title?: ReactNode;
+    /** Label in the top/bottom elbow, e.g. a number like "47-1138" */
+    topLabel?: ReactNode;
+    bottomLabel?: ReactNode;
+    /** Sidebar content (buttons/blocks); filled up to the bottom */
+    sidebar?: ReactNode;
+    /** Replaces the default bar at the top or bottom */
+    top?: ReactNode;
+    bottom?: ReactNode;
+}
+/** Classic LCARS panel: sidebar, two elbows, bars and a content area. */
+declare function Frame({ color, title, topLabel, bottomLabel, sidebar, top, bottom, className, children, ...rest }: FrameProps): react.JSX.Element;
+interface SplitFrameProps extends Omit<DivProps$1, "title"> {
+    color?: LcarsColor;
+    title?: ReactNode;
+    /** Content of the upper area (e.g. DataCascade, Readout) */
+    header?: ReactNode;
+    /** Upper and lower sidebar (buttons/blocks); each is filled up */
+    headerSidebar?: ReactNode;
+    sidebar?: ReactNode;
+    /** Labels in the two middle elbows */
+    upperLabel?: ReactNode;
+    lowerLabel?: ReactNode;
+    /** Replaces the bars next to the middle elbows */
+    upperBar?: ReactNode;
+    lowerBar?: ReactNode;
+}
+/** TNG main layout: upper and lower area, separated by two elbows. */
+declare function SplitFrame({ color, title, header, headerSidebar, sidebar, upperLabel, lowerLabel, upperBar, lowerBar, className, children, ...rest }: SplitFrameProps): react.JSX.Element;
+
+interface ToggleProps extends ButtonProps {
+    pressed?: boolean;
+    defaultPressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+}
+/** Button with an on/off state (aria-pressed). */
+declare function Toggle({ pressed, defaultPressed, onPressedChange, onClick, ...rest }: ToggleProps): react.JSX.Element;
+type SliderProps = {
+    color?: LcarsColor;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "color">;
+/** Slider (native input type="range"). */
+declare const Slider: react.ForwardRefExoticComponent<{
+    color?: LcarsColor;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "color"> & react.RefAttributes<HTMLInputElement>>;
+type InputProps = {
+    color?: LcarsColor;
+    label?: ReactNode;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "color">;
+/** Text field with a colored label as end cap. */
+declare const Input: react.ForwardRefExoticComponent<{
+    color?: LcarsColor;
+    label?: ReactNode;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "color"> & react.RefAttributes<HTMLInputElement>>;
+interface TabItem {
+    id: string;
+    label: ReactNode;
+    content: ReactNode;
+    color?: LcarsColor;
+}
+interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "color"> {
+    items: TabItem[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (id: string) => void;
+    color?: LcarsColor;
+}
+/** Tabs; the active tab flows into the bar below. */
+declare function Tabs({ items, value, defaultValue, onValueChange, color, className, ...rest }: TabsProps): react.JSX.Element;
+interface KeypadProps extends Omit<HTMLAttributes<HTMLDivElement>, "color" | "onSubmit"> {
+    color?: LcarsColor;
+    /** Maximum code length */
+    length?: number;
+    /** Show the code as dots */
+    mask?: boolean;
+    /** Called with the code; true = accepted, false = denied */
+    onSubmit?: (code: string) => boolean | void;
+}
+/** Number pad with display, e.g. for access codes. */
+declare function Keypad({ color, length, mask, onSubmit, className, ...rest }: KeypadProps): react.JSX.Element;
+
+type DivProps = Omit<HTMLAttributes<HTMLDivElement>, "color">;
+interface DataCascadeProps extends DivProps {
+    columns?: number;
+    rows?: number;
+    seed?: number;
+}
+/** Cycling number columns – the "computer at work" effect. */
+declare function DataCascade({ columns, rows, seed, className, ...rest }: DataCascadeProps): react.JSX.Element;
+interface ReadoutItem {
+    label: ReactNode;
+    value: ReactNode;
+    color?: LcarsColor;
+}
+interface ReadoutProps extends Omit<HTMLAttributes<HTMLDListElement>, "color"> {
+    items: ReadoutItem[];
+    color?: LcarsColor;
+}
+/** Value table: label on the left, value right-aligned. */
+declare function Readout({ items, color, className, ...rest }: ReadoutProps): react.JSX.Element;
+type NumberCodeProps = {
+    color?: LcarsColor;
+} & Omit<HTMLAttributes<HTMLSpanElement>, "color">;
+/** ID number like "47-1138". */
+declare function NumberCode({ color, className, ...rest }: NumberCodeProps): react.JSX.Element;
+declare function Divider({ color, className, ...rest }: {
+    color?: LcarsColor;
+} & DivProps): react.JSX.Element;
+interface ButtonGridProps extends HTMLAttributes<HTMLDivElement> {
+    columns?: number;
+}
+/** Grid of buttons like a bridge console. */
+declare function ButtonGrid({ columns, className, style, ...rest }: ButtonGridProps): react.JSX.Element;
+interface LevelBarProps extends DivProps {
+    value: number;
+    max?: number;
+    segments?: number;
+    orientation?: Orientation;
+    color?: LcarsColor;
+}
+/** Segmented level bar. */
+declare function LevelBar({ value, max, segments, orientation, color, className, ...rest }: LevelBarProps): react.JSX.Element;
+interface GaugeProps extends DivProps {
+    value: number;
+    max?: number;
+    segments?: number;
+    label?: ReactNode;
+    color?: LcarsColor;
+}
+/** Semicircular gauge made of arc segments. */
+declare function Gauge({ value, max, segments, label, color, className, style, ...rest }: GaugeProps): react.JSX.Element;
+interface Blip {
+    x: number;
+    y: number;
+    color?: LcarsColor;
+}
+interface SensorProps extends DivProps {
+    blips?: Blip[];
+    scan?: boolean;
+    color?: LcarsColor;
+}
+/** Sensor display with grid, crosshair, contacts and optional scan. */
+declare function Sensor({ blips, scan, color, className, children, ...rest }: SensorProps): react.JSX.Element;
+interface StatusIndicatorProps extends HTMLAttributes<HTMLSpanElement> {
+    status?: StatusKind;
+    blink?: boolean;
+}
+/** Indicator light with label. */
+declare function StatusIndicator({ status, blink, className, ...rest }: StatusIndicatorProps): react.JSX.Element;
+interface AlertBannerProps extends Omit<DivProps, "title"> {
+    level?: AlertLevel;
+    title?: ReactNode;
+}
+/** Large, blinking alert banner. */
+declare function AlertBanner({ level, title, children, className, ...rest }: AlertBannerProps): react.JSX.Element;
+
+interface LcarsRootProps extends HTMLAttributes<HTMLDivElement> {
+    theme?: LcarsTheme;
+    /** Turns everything below red/yellow and makes the bars pulse */
+    alert?: AlertLevel | null;
+}
+/** Sets the color theme and alert state for all components below. */
+declare function LcarsRoot({ theme, alert, ...rest }: LcarsRootProps): react.JSX.Element;
+
+export { AlertBanner, Bar, Block, Button, ButtonGrid, DataCascade, Divider, Elbow, Frame, Gauge, Input, Keypad, LcarsRoot, LevelBar, NumberCode, Readout, Sensor, Slider, SplitFrame, Stack, StatusIndicator, Tabs, Title, Toggle };
+export type { AlertBannerProps, AlertLevel, BarCap, BarProps, Blip, BlockProps, ButtonAlign, ButtonColor, ButtonGridProps, ButtonLength, ButtonProps, ButtonShape, ButtonSize, DataCascadeProps, ElbowCorner, ElbowProps, FrameProps, GaugeProps, InputProps, KeypadProps, LcarsColor, LcarsLength, LcarsRootProps, LcarsTheme, LevelBarProps, NumberCodeProps, Orientation, ReadoutItem, ReadoutProps, SensorProps, SliderProps, SplitFrameProps, StatusIndicatorProps, StatusKind, TabItem, TabsProps, TitleProps, ToggleProps };