@deadragdoll/reactnu 0.1.9

package/dist/windowing/internals/MdiWindowPickerDialog.d.ts

@@ -0,0 +1,10 @@
+import { NuManagedWindowInfo } from "../windowing.types";
+type MdiWindowPickerDialogProps = {
+    activeWindowId?: string;
+    domain?: string;
+    onActivateWindow: (id: string) => void;
+    onClose: () => void;
+    windows: NuManagedWindowInfo[];
+};
+export declare function MdiWindowPickerDialog({ activeWindowId, domain, onActivateWindow, onClose, windows }: MdiWindowPickerDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/windowing/mdiMenu.d.ts

@@ -0,0 +1,3 @@
+import { MainMenuNode } from "../components/MainMenu/MainMenu.types";
+import { NuMdiMenuBridge } from "./windowContext";
+export declare function resolveMdiMainMenuItems(items: MainMenuNode[], bridge: NuMdiMenuBridge | null): MainMenuNode[];

package/dist/windowing/windowContext.d.ts

@@ -0,0 +1,18 @@
+import { NuInputBoxOptions, NuManagedWindowDefinition, NuManagedWindowInfo, NuMessageBoxOptions, NuMessageBoxResult } from "./windowing.types";
+export type NuWindowContextValue = {
+    activateWindow: (id: string) => void;
+    bringToFront: (id: string) => void;
+    closeAll: () => void;
+    closeWindow: (id: string) => void;
+    openDialog: (definition: NuManagedWindowDefinition) => string;
+    openWindow: (definition: NuManagedWindowDefinition) => string;
+    showInputBox: (options: NuInputBoxOptions) => Promise<string | null>;
+    showMessageBox: (options: NuMessageBoxOptions) => Promise<NuMessageBoxResult>;
+    toggleWindowMaximized: (id: string) => void;
+    toggleWindowMinimized: (id: string) => void;
+    updateWindow: (id: string, patch: Partial<NuManagedWindowDefinition>) => void;
+    windows: NuManagedWindowInfo[];
+};
+export type NuMdiMenuBridge = Pick<NuWindowContextValue, "activateWindow" | "openDialog" | "windows">;
+export declare const NuWindowContext: import("react").Context<NuWindowContextValue | null>;
+export declare function useNuWindowManager(): NuWindowContextValue;

package/dist/windowing/windowing.constants.d.ts

@@ -0,0 +1 @@
+export declare const NU_APP_BAR_HEIGHT = "2.1rem";

package/dist/windowing/windowing.types.d.ts

@@ -0,0 +1,54 @@
+import { CSSProperties, ReactNode } from "react";
+import { WindowBorder, WindowMode } from "../components/Window";
+import { WindowTitleButtonDefinition } from "../components/Window/WindowTitleButton";
+import { NuInputBoxOptions, NuMessageBoxKind, NuMessageBoxOptions, NuMessageBoxPreset, NuMessageBoxResult } from "./dialogHelpers";
+export type NuManagedWindowSnapshot = {
+    height?: number;
+    left?: number;
+    maximized?: boolean;
+    minimized?: boolean;
+    top?: number;
+    width?: number;
+};
+export type NuManagedWindowDefinition = {
+    appModal?: boolean;
+    bodyClassName?: string;
+    border?: WindowBorder;
+    className?: string;
+    closeable?: boolean;
+    content: ReactNode | ((controls: NuManagedWindowControls) => ReactNode);
+    domain?: string;
+    maximizable?: boolean;
+    modal?: boolean | string;
+    minimizable?: boolean;
+    mode?: WindowMode;
+    onClose?: (snapshot: NuManagedWindowSnapshot) => boolean | void;
+    onOpen?: () => NuManagedWindowSnapshot | void;
+    resizable?: boolean;
+    statusBar?: ReactNode;
+    style?: CSSProperties;
+    titleButtons?: WindowTitleButtonDefinition[];
+    title: string;
+};
+export type NuManagedWindowControls = {
+    bringToFront: () => void;
+    close: () => void;
+    id: string;
+    toggleMaximized: () => void;
+    toggleMinimized: () => void;
+    update: (patch: Partial<NuManagedWindowDefinition>) => void;
+};
+export type NuManagedWindowInfo = Omit<NuManagedWindowDefinition, "content"> & {
+    active: boolean;
+    id: string;
+    maximized: boolean;
+    minimized: boolean;
+    mode: WindowMode;
+};
+export type NuWindowBounds = {
+    height: number;
+    left: number;
+    top: number;
+    width: number;
+};
+export type { NuInputBoxOptions, NuMessageBoxKind, NuMessageBoxOptions, NuMessageBoxPreset, NuMessageBoxResult };

package/docs/API_REFERENCE.md

@@ -0,0 +1,150 @@
+# API Reference
+
+This is the top-level map of the public ReactNU API.
+
+For internal implementation and extension rules, also read:
+
+- [Contributor Guide](./CONTRIBUTOR_GUIDE.md)
+- [Architecture](./ARCHITECTURE.md)
+- [Storybook](./STORYBOOK.md)
+
+## Common Customization Contract
+
+Many controls now support internal slot overrides through:
+
+- `slotStyles`
+- `slotClassNames`
+
+See: [Slot Customization](./SLOT_CUSTOMIZATION.md)
+
+## Providers And Shell
+
+- `NuThemeProvider`
+  docs: [NuThemeProvider](./NuThemeProvider.md)
+- `NuDesktop`
+  docs: [Desktop](./Desktop.md)
+- `Dashboard`
+  docs: [Dashboard](./Dashboard.md)
+- `NuAppHostProvider`
+  docs: [NuAppHostProvider](./NuAppHostProvider.md)
+- `NuWindowProvider`
+  docs: [NuWindowProvider](./NuWindowProvider.md)
+
+## Hooks
+
+- `useNuTheme()`
+  reads and changes the active theme, provider typography, and desktop pattern mode
+- `useAppHostMenu()`
+  manages the desktop-level main menu tree and item flags
+- `useNuWindowManager()`
+  opens, updates, activates, and closes managed windows
+  also exposes `showMessageBox(...)` and `showInputBox(...)`
+- `usePopupMenu()`
+  anchor/open helper for `PopupMenu`
+- `useWindowMenu()`
+  accesses menu state from inside a managed window
+
+## Core Controls
+
+- `Button`
+  docs: [Button](./Button.md)
+- `CheckBox`
+  docs: [CheckBox](./CheckBox.md)
+- `Dropdown`
+  docs: [Dropdown](./Dropdown.md)
+- `ComboBox`
+  docs: [ComboBox](./ComboBox.md)
+- `CommandButton`
+  docs: [CommandButton](./CommandButton.md)
+- `Info`
+  docs: [Info](./Info.md)
+- `MaskedField`
+  docs: [MaskedField](./MaskedField.md)
+- `Memo`
+  docs: [Memo](./Memo.md)
+- `Panel`
+  docs: [Panel](./Panel.md)
+- `PageControl` / `Tabs`
+  docs: [PageControl](./PageControl.md)
+- `ProgressBar`
+  docs: [ProgressBar](./ProgressBar.md)
+- `RadioButton`, `RadioGroup`
+  docs: [RadioGroup](./RadioGroup.md)
+- `SearchBox`
+  docs: [SearchBox](./SearchBox.md)
+- `TextField`
+  docs: [TextField](./TextField.md)
+- `SpinBox`
+  docs: [SpinBox](./SpinBox.md)
+- `TickBar`
+  docs: [TickBar](./TickBar.md)
+
+## Data And Navigation Controls
+
+- `ListBox`
+  docs: [ListBox](./ListBox.md)
+- `ListView`
+  docs: [ListView](./ListView.md)
+- `TreeView`
+  docs: [TreeView](./TreeView.md)
+- `TreeListView`
+  docs: [TreeListView](./TreeListView.md)
+
+## Layout And Surfaces
+
+- `Frame`
+  docs: [Frame](./Frame.md)
+- `NuView`
+  docs: [NuView](./NuView.md)
+- `PropertyGrid`
+  docs: [PropertyGrid](./PropertyGrid.md)
+- `ReportCell`
+  docs: [ReportCell](./ReportCell.md)
+- `Splitter`
+  docs: [Splitter](./Splitter.md)
+- `Stack`
+  docs: [Stack](./Stack.md)
+- `ToolBar`, `ToolButton`, `ToolSeparator`
+  docs: [ToolBar](./ToolBar.md)
+
+## Menus
+
+- `MainMenu`
+  docs: [MainMenu](./MainMenu.md)
+- `PopupMenu`
+  docs: [PopupMenu](./PopupMenu.md)
+
+## Windowing And Desktop Chrome
+
+- `Window`
+  docs: [Window](./Window.md)
+- `StatusBarItem`
+  docs: [StatusBarItem](./StatusBarItem.md)
+- `AppBarHost`
+  docs: [AppBarHost](./AppBarHost.md)
+- `AppBarItem`
+  docs: [AppBarItem](./AppBarItem.md)
+- `WindowBar`
+  docs: [WindowBar](./WindowBar.md)
+- `MessageBox` / `InputBox` helpers
+  docs: [Dialog Helpers](./DialogHelpers.md)
+
+## Visual Utilities
+
+- `NuGlyph`
+  docs: [Glyph](./Glyph.md)
+- `NuCrtGlitch`
+  docs: [CrtGlitch](./CrtGlitch.md)
+- `nuThemes`
+- `resolveNuTheme(...)`
+- `isNuThemeName(...)`
+
+## Start Here
+
+If you are new to the library, read in this order:
+
+1. [Getting Started](./GETTING_STARTED.md)
+2. [Architecture](./ARCHITECTURE.md)
+3. [NuThemeProvider](./NuThemeProvider.md)
+4. [Desktop](./Desktop.md)
+5. [NuWindowProvider](./NuWindowProvider.md)

package/docs/ARCHITECTURE.md

@@ -0,0 +1,170 @@
+# Architecture
+
+ReactNU is organized around a desktop shell and explicit ownership boundaries.
+
+## Main Layers
+
+1. Theme tokens
+2. Low-level controls
+3. Desktop shell and window manager
+4. Host application composition
+
+## Desktop Ownership
+
+Recommended ownership:
+
+`NuThemeProvider -> NuDesktop -> workspace + app bar -> managed windows`
+
+That means:
+
+- `NuDesktop` owns screen geometry.
+- `NuDesktop` composes `NuAppHostProvider` and `NuWindowProvider` for the full desktop shell.
+- `NuWindowProvider` owns managed windows.
+- the host owns main menu content and app bar composition.
+- controls do not know about desktop layout unless they are part of windowing.
+
+## Window Ownership
+
+Managed windows are opened through `useNuWindowManager()`:
+
+- `openWindow(definition)`
+- `openDialog(definition)`
+- `updateWindow(id, patch)`
+- `closeWindow(id)`
+
+The host provides:
+
+- title
+- content
+- optional persistence callbacks
+- domain metadata
+
+The manager provides:
+
+- activation
+- z-order
+- modal behavior
+- app-bar visibility state
+
+## Popup Ownership
+
+Popup-like controls such as:
+
+- `Dropdown`
+- `ComboBox`
+- `SearchBox`
+- `PopupMenu`
+
+use a shared ownership split:
+
+- the control owns anchor measurement
+- the popup layer renders into `document.body`
+- theme variables are mirrored from the nearest `.nu-theme-root`
+
+This avoids mixing local portal roots with viewport-based coordinates.
+
+If a popup needs the same chrome as another control, prefer a shared internal primitive or shared helper over per-control duplication.
+
+## Scroll Ownership
+
+ReactNU does not assume that every container should scroll automatically.
+
+Recommended ownership:
+
+- `Splitter cell -> NuView -> content`
+- `Window body -> scrollable control`
+- `Frame -> one filling child`
+
+This keeps scroll behavior explicit and avoids hidden nested viewport bugs.
+
+## Slot Customization
+
+ReactNU is standardizing internal customization around named slots.
+
+Preferred API:
+
+- `slotStyles`
+- `slotClassNames`
+
+Use this for component internals instead of inventing ad-hoc props like:
+
+- `headerStyle`
+- `inputShellClassName`
+- `popupBackground`
+
+See: [Slot Customization](./SLOT_CUSTOMIZATION.md)
+
+## Shared Internal Primitives
+
+Not every repeated visual element should become a public component.
+
+Preferred rule:
+
+- shared public behavior -> public component
+- shared internal geometry/chrome -> internal primitive
+
+Example:
+
+- `Dropdown` and `ComboBox` use the internal `ControlOpener` primitive so opener size, glyph metrics, border, and button chrome stay centralized.
+
+## Tree Ownership
+
+`TreeView` and `TreeListView` own:
+
+- hierarchy geometry
+- connector rendering
+- expand/collapse behavior
+- keyboard navigation
+
+The host owns:
+
+- data
+- selection/check state when controlled
+- report-column rendering for `TreeListView`
+
+## Window Persistence
+
+Managed windows can persist geometry with:
+
+- `onOpen?: () => NuManagedWindowSnapshot | void`
+- `onClose?: (snapshot) => boolean | void`
+
+Use this when the host wants to restore:
+
+- last position
+- last size
+- maximized state
+- minimized state
+
+## Recommended Host Split
+
+Keep host code separated by responsibility:
+
+- desktop shell
+- menu state
+- app bar composition
+- window launchers
+- individual window content components
+
+That keeps the component library reusable and avoids demo-only patterns leaking into product code.
+
+## Storybook Host Strategy
+
+Storybook should distinguish between:
+
+- full desktop-shell stories
+- bounded window-manager stories
+
+Use a full `NuDesktop` story when validating:
+
+- desktop background
+- menu/app-bar composition
+- shell-level layering
+
+Use a bounded `NuWindowProvider` story when validating:
+
+- helper dialogs
+- modal behavior
+- managed window chrome inside a fixed preview area
+
+This avoids accidental fullscreen/fixed-position behavior inside Storybook preview containers.

package/docs/AppBarHost.md

@@ -0,0 +1,22 @@
+# AppBarHost
+
+`AppBarHost` is the bottom chrome container for desktop bar content.
+
+## Usage
+
+```tsx
+<AppBarHost inline>
+  <WindowBar items={windowManager.windows} onActivateWindow={handleActivate} />
+  <CalendarAppBarItem />
+</AppBarHost>
+```
+
+## Key Props
+
+- `children`
+- `inline?: boolean`
+
+## Notes
+
+- `inline` is intended for `NuDesktop` layout usage.
+- The host is intentionally dumb; the application decides which app-bar items to place inside it.

package/docs/AppBarItem.md

@@ -0,0 +1,22 @@
+# AppBarItem
+
+`AppBarItem` is the generic item primitive for desktop bar content such as clocks, indicators, or task entries.
+
+## Usage
+
+```tsx
+<AppBarItem alignment="end">12:30</AppBarItem>
+```
+
+## Key Props
+
+- `alignment?: "start" | "end"`
+- `active?: boolean`
+- `grow?: boolean`
+- `interactive?: boolean`
+- standard static or button-like props depending on usage
+
+## Notes
+
+- `AppBarItem` can render as static chrome or as an interactive item.
+- `WindowBar` is built on top of this primitive rather than embedding its own task-button styling.

package/docs/Button.md

@@ -0,0 +1,24 @@
+# Button
+
+`Button` is the basic action control for the library.
+
+## Usage
+
+```tsx
+<Button variant="primary">Commit</Button>
+<Button variant="secondary">Preview</Button>
+<Button variant="danger">Reset</Button>
+<Button variant="success">Apply</Button>
+```
+
+## Key Props
+
+- `variant?: "primary" | "secondary" | "danger" | "success"`
+- `focused?: boolean`
+- `defaultFocused?: boolean`
+- standard `button` props such as `disabled`, `onClick`, `type`
+
+## Notes
+
+- Visual focus is rendered with DOS-style side markers instead of a browser outline.
+- Press state is purely visual and does not change layout around neighboring controls.

package/docs/COMPONENT_INDEX.md

@@ -0,0 +1,64 @@
+# Component Index
+
+## Guides
+
+- [Getting Started](./GETTING_STARTED.md)
+- [Architecture](./ARCHITECTURE.md)
+- [API Reference](./API_REFERENCE.md)
+- [Contributor Guide](./CONTRIBUTOR_GUIDE.md)
+- [Slot Customization](./SLOT_CUSTOMIZATION.md)
+- [Storybook](./STORYBOOK.md)
+
+## Core Components
+
+- [Button](./Button.md)
+- [CheckBox](./CheckBox.md)
+- [Dashboard](./Dashboard.md)
+- [Desktop](./Desktop.md)
+- [Dropdown](./Dropdown.md)
+- [Frame](./Frame.md)
+- [Glyph](./Glyph.md)
+- [Info](./Info.md)
+- [ListBox](./ListBox.md)
+- [ListView](./ListView.md)
+- [MainMenu](./MainMenu.md)
+- [MaskedField](./MaskedField.md)
+- [Memo](./Memo.md)
+- [PageControl](./PageControl.md)
+- [Panel](./Panel.md)
+- [PopupMenu](./PopupMenu.md)
+- [PropertyGrid](./PropertyGrid.md)
+- [ProgressBar](./ProgressBar.md)
+- [RadioGroup](./RadioGroup.md)
+- [ReportCell](./ReportCell.md)
+- [SearchBox](./SearchBox.md)
+- [SpinBox](./SpinBox.md)
+- [Stack](./Stack.md)
+- [Splitter](./Splitter.md)
+- [TextField](./TextField.md)
+- [TickBar](./TickBar.md)
+- [ToolBar](./ToolBar.md)
+- [TreeListView](./TreeListView.md)
+- [TreeView](./TreeView.md)
+- [NuView](./NuView.md)
+- [Window](./Window.md)
+- [StatusBarItem](./StatusBarItem.md)
+- [ComboBox](./ComboBox.md)
+- [CommandButton](./CommandButton.md)
+- [CrtGlitch](./CrtGlitch.md)
+
+## App Bar And Windowing
+
+- [AppBarHost](./AppBarHost.md)
+- [AppBarItem](./AppBarItem.md)
+- [WindowBar](./WindowBar.md)
+- [NuWindowProvider](./NuWindowProvider.md)
+
+## Providers
+
+- [NuThemeProvider](./NuThemeProvider.md)
+- [NuAppHostProvider](./NuAppHostProvider.md)
+
+## Design System
+
+- [Token Checklist](./TOKEN_CHECKLIST.md)