@fungi.computer/caps 0.0.0-stage → 0.0.1

package/docs/api/README.md

@@ -0,0 +1,134 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+**@fungi.computer/caps**
+
+---
+
+# @fungi.computer/caps
+
+## Modules
+
+| Module                                                                              | Description |
+| ----------------------------------------------------------------------------------- | ----------- |
+| [blocks/app-bar](blocks/app-bar.md)                                                 | -           |
+| [blocks/app-status-bar](blocks/app-status-bar.md)                                   | -           |
+| [blocks/async-state](blocks/async-state.md)                                         | -           |
+| [blocks/card-grid](blocks/card-grid.md)                                             | -           |
+| [blocks/command-menu](blocks/command-menu.md)                                       | -           |
+| [blocks/composer](blocks/composer.md)                                               | -           |
+| [blocks/empty-state](blocks/empty-state.md)                                         | -           |
+| [blocks/faq-chat](blocks/faq-chat.md)                                               | -           |
+| [blocks/game-share-card](blocks/game-share-card.md)                                 | -           |
+| [blocks/launcher-grid](blocks/launcher-grid.md)                                     | -           |
+| [blocks/listing-detail](blocks/listing-detail.md)                                   | -           |
+| [blocks/loading-state](blocks/loading-state.md)                                     | -           |
+| [blocks/mosaic](blocks/mosaic.md)                                                   | -           |
+| [blocks/permission-grid](blocks/permission-grid.md)                                 | -           |
+| [blocks/pricing-card](blocks/pricing-card.md)                                       | -           |
+| [blocks/release-tag](blocks/release-tag.md)                                         | -           |
+| [blocks/resource-select](blocks/resource-select.md)                                 | -           |
+| [blocks/result-state](blocks/result-state.md)                                       | -           |
+| [blocks/section-card](blocks/section-card.md)                                       | -           |
+| [blocks/section-heading](blocks/section-heading.md)                                 | -           |
+| [blocks/spec-sheet](blocks/spec-sheet.md)                                           | -           |
+| [blocks/status-tray](blocks/status-tray.md)                                         | -           |
+| [blocks/upload-queue](blocks/upload-queue.md)                                       | -           |
+| [components/action-row](components/action-row.md)                                   | -           |
+| [components/activity-line](components/activity-line.md)                             | -           |
+| [components/alert](components/alert.md)                                             | -           |
+| [components/badge](components/badge.md)                                             | -           |
+| [components/button](components/button.md)                                           | -           |
+| [components/card](components/card.md)                                               | -           |
+| [components/chat-bubble](components/chat-bubble.md)                                 | -           |
+| [components/checkbox-bead](components/checkbox-bead.md)                             | -           |
+| [components/checkbox](components/checkbox.md)                                       | -           |
+| [components/code-input](components/code-input.md)                                   | -           |
+| [components/combobox](components/combobox.md)                                       | -           |
+| [components/confirm-action](components/confirm-action.md)                           | -           |
+| [components/copy-field](components/copy-field.md)                                   | -           |
+| [components/count-badge](components/count-badge.md)                                 | -           |
+| [components/cover-pattern](components/cover-pattern.md)                             | -           |
+| [components/data-list](components/data-list.md)                                     | -           |
+| [components/dialog](components/dialog.md)                                           | -           |
+| [components/diff-view](components/diff-view.md)                                     | -           |
+| [components/disclosure](components/disclosure.md)                                   | -           |
+| [components/dropdown-menu](components/dropdown-menu.md)                             | -           |
+| [components/field-guide](components/field-guide.md)                                 | -           |
+| [components/field](components/field.md)                                             | -           |
+| [components/game-feedback](components/game-feedback.md)                             | -           |
+| [components/game-hud](components/game-hud.md)                                       | -           |
+| [components/generation-frame](components/generation-frame.md)                       | -           |
+| [components/hold-button](components/hold-button.md)                                 | -           |
+| [components/icon-button](components/icon-button.md)                                 | -           |
+| [components/icon-checkbox](components/icon-checkbox.md)                             | -           |
+| [components/icon-choice-mark](components/icon-choice-mark.md)                       | -           |
+| [components/icon-lamp](components/icon-lamp.md)                                     | -           |
+| [components/icon-radio](components/icon-radio.md)                                   | -           |
+| [components/inline-code](components/inline-code.md)                                 | -           |
+| [components/input-group](components/input-group.md)                                 | -           |
+| [components/input](components/input.md)                                             | -           |
+| [components/item-grid](components/item-grid.md)                                     | -           |
+| [components/keycap](components/keycap.md)                                           | -           |
+| [components/label](components/label.md)                                             | -           |
+| [components/listbox](components/listbox.md)                                         | -           |
+| [components/loader-blobs](components/loader-blobs.md)                               | -           |
+| [components/loader](components/loader.md)                                           | -           |
+| [components/markdown](components/markdown.md)                                       | -           |
+| [components/minimap-labels](components/minimap-labels.md)                           | -           |
+| [components/monogram](components/monogram.md)                                       | -           |
+| [components/motion-visibility](components/motion-visibility.md)                     | -           |
+| [components/navigation-rail](components/navigation-rail.md)                         | -           |
+| [components/overlay-root](components/overlay-root.md)                               | -           |
+| [components/pixel-number](components/pixel-number.md)                               | -           |
+| [components/popover](components/popover.md)                                         | -           |
+| [components/presence](components/presence.md)                                       | -           |
+| [components/price-tag](components/price-tag.md)                                     | -           |
+| [components/progress](components/progress.md)                                       | -           |
+| [components/prose](components/prose.md)                                             | -           |
+| [components/quota-meter](components/quota-meter.md)                                 | -           |
+| [components/radio-bead](components/radio-bead.md)                                   | -           |
+| [components/radio-group](components/radio-group.md)                                 | -           |
+| [components/resize-handle](components/resize-handle.md)                             | -           |
+| [components/rough-drawing](components/rough-drawing.md)                             | -           |
+| [components/rough](components/rough.md)                                             | -           |
+| [components/scroll-area](components/scroll-area.md)                                 | -           |
+| [components/scroll-motion](components/scroll-motion.md)                             | -           |
+| [components/scroll-to-bottom-blob-state](components/scroll-to-bottom-blob-state.md) | -           |
+| [components/scroll-to-bottom-blob](components/scroll-to-bottom-blob.md)             | -           |
+| [components/select](components/select.md)                                           | -           |
+| [components/send-action](components/send-action.md)                                 | -           |
+| [components/separator](components/separator.md)                                     | -           |
+| [components/skeleton](components/skeleton.md)                                       | -           |
+| [components/slider](components/slider.md)                                           | -           |
+| [components/stat](components/stat.md)                                               | -           |
+| [components/status-bead](components/status-bead.md)                                 | -           |
+| [components/status-mark](components/status-mark.md)                                 | -           |
+| [components/status](components/status.md)                                           | -           |
+| [components/store-card](components/store-card.md)                                   | -           |
+| [components/surface](components/surface.md)                                         | -           |
+| [components/switch-bead](components/switch-bead.md)                                 | -           |
+| [components/switch](components/switch.md)                                           | -           |
+| [components/tabs](components/tabs.md)                                               | -           |
+| [components/technonomicon](components/technonomicon.md)                             | -           |
+| [components/textarea](components/textarea.md)                                       | -           |
+| [components/toaster](components/toaster.md)                                         | -           |
+| [components/tool-call-chip](components/tool-call-chip.md)                           | -           |
+| [components/tooltip](components/tooltip.md)                                         | -           |
+| [components/trading-card](components/trading-card.md)                               | -           |
+| [components/undo-action](components/undo-action.md)                                 | -           |
+| [components/undo-toast](components/undo-toast.md)                                   | -           |
+| [components/visually-hidden](components/visually-hidden.md)                         | -           |
+| [components/window](components/window.md)                                           | -           |
+| [components/wizard](components/wizard.md)                                           | -           |
+| [enhance/cigarette-card](enhance/cigarette-card.md)                                 | -           |
+| [enhance/sketch](enhance/sketch.md)                                                 | -           |
+| [form](form.md)                                                                     | -           |
+| [lib/cn](lib/cn.md)                                                                 | -           |
+| [lib/format-money](lib/format-money.md)                                             | -           |
+| [lib/glide](lib/glide.md)                                                           | -           |
+| [lib/ime](lib/ime.md)                                                               | -           |
+| [lib/motion-spring](lib/motion-spring.md)                                           | -           |
+| [lib/motion](lib/motion.md)                                                         | -           |
+| [lib/reorder-motion](lib/reorder-motion.md)                                         | -           |
+| [lib/seed-hash](lib/seed-hash.md)                                                   | -           |
+| [lib/tanstack-highlight](lib/tanstack-highlight.md)                                 | -           |

package/docs/api/blocks/app-bar.md

@@ -0,0 +1,227 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/caps**](../README.md)
+
+---
+
+[@fungi.computer/caps](../README.md) / blocks/app-bar
+
+# blocks/app-bar
+
+## Type Aliases
+
+### AppBarItem
+
+```ts
+type AppBarItem = object;
+```
+
+A caller-owned running App window or available App launcher.
+
+#### Properties
+
+##### id
+
+```ts
+id: string;
+```
+
+##### label
+
+```ts
+label: string;
+```
+
+##### icon?
+
+```ts
+optional icon?: ReactNode;
+```
+
+##### active?
+
+```ts
+optional active?: boolean;
+```
+
+##### onSelect
+
+```ts
+onSelect: () => void;
+```
+
+Request focusing a running window or opening an available App.
+
+###### Returns
+
+`void`
+
+##### onClose?
+
+```ts
+optional onClose?: () => void;
+```
+
+Request closing; the caller owns disposal and removal.
+
+###### Returns
+
+`void`
+
+---
+
+### AppBarProps
+
+```ts
+type AppBarProps = object;
+```
+
+Caller-owned apps and actions; AppBar owns only presentation and disclosure.
+
+#### Properties
+
+##### container?
+
+```ts
+optional container?: HTMLElement | null;
+```
+
+Portal container for the App dial; defaults to the document body.
+
+##### windows
+
+```ts
+windows: readonly AppBarItem[];
+```
+
+##### launchers
+
+```ts
+launchers: readonly AppBarItem[];
+```
+
+Team Apps available to launch from the speed dial.
+
+##### sessions?
+
+```ts
+optional sessions?: readonly AppBarItem[];
+```
+
+Recent Sessions supplied by the shell's session owner.
+
+##### launcherLabels?
+
+```ts
+optional launcherLabels?: "truncate" | "wrap";
+```
+
+Keep long launcher names readable instead of truncating them.
+
+##### alwaysExpanded?
+
+```ts
+optional alwaysExpanded?: boolean;
+```
+
+##### isOpen?
+
+```ts
+optional isOpen?: boolean;
+```
+
+Control the compact App dial from the surrounding shell.
+
+##### onOpenChange?
+
+```ts
+optional onOpenChange?: (open) => void;
+```
+
+Report requests to open or dismiss the compact App dial.
+
+###### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `open`    | `boolean` |
+
+###### Returns
+
+`void`
+
+##### emptyLabel?
+
+```ts
+optional emptyLabel?: ReactNode;
+```
+
+##### launcher
+
+```ts
+launcher: object;
+```
+
+###### label
+
+```ts
+label: string;
+```
+
+###### icon?
+
+```ts
+optional icon?: ReactNode;
+```
+
+##### primaryAction?
+
+```ts
+optional primaryAction?: object;
+```
+
+A primary action revealed above the launcher, such as starting a chat.
+
+###### label
+
+```ts
+label: string;
+```
+
+###### icon
+
+```ts
+icon: ReactNode;
+```
+
+###### onSelect
+
+```ts
+onSelect: () => void;
+```
+
+Invoke the caller-owned primary action.
+
+###### Returns
+
+`void`
+
+## Functions
+
+### AppBar()
+
+```ts
+function AppBar(__namedParameters): Element;
+```
+
+An anchored launcher between persistent running apps and a spring-out app tray.
+
+#### Parameters
+
+| Parameter           | Type                          |
+| ------------------- | ----------------------------- |
+| `__namedParameters` | [`AppBarProps`](#appbarprops) |
+
+#### Returns
+
+`Element`

package/docs/api/blocks/app-status-bar.md

@@ -0,0 +1,257 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/caps**](../README.md)
+
+---
+
+[@fungi.computer/caps](../README.md) / blocks/app-status-bar
+
+# blocks/app-status-bar
+
+## Type Aliases
+
+### AppStatusBarProps
+
+```ts
+type AppStatusBarProps = HTMLAttributes<HTMLElement> & object;
+```
+
+Props accepted by AppStatusBar.
+
+#### Type Declaration
+
+| Name          | Type        | Description                                                                                                                       |
+| ------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `attachment?` | `ReactNode` | What this window is attached to: a StatusBarPicker, or a plain AppStatusItem when it cannot be changed. Every App keeps it first. |
+| `end?`        | `ReactNode` | Readouts held at the far end, such as save state.                                                                                 |
+
+---
+
+### StatusBarPickerOption
+
+```ts
+type StatusBarPickerOption = Readonly<{
+  id: string;
+  label: string;
+}>;
+```
+
+One choice a status bar picker offers.
+
+---
+
+### StatusBarPickerProps
+
+```ts
+type StatusBarPickerProps = object;
+```
+
+Props accepted by StatusBarPicker.
+
+#### Properties
+
+##### noun
+
+```ts
+noun: string;
+```
+
+What is picked, e.g. "Computer"; the trigger is named "\<noun\>: \<label\>".
+
+##### pluralNoun
+
+```ts
+pluralNoun: string;
+```
+
+The plural used for searching, e.g. "Computers".
+
+##### icon
+
+```ts
+icon: ReactNode;
+```
+
+The picked thing's mark, shown before its label.
+
+##### options
+
+```ts
+options: readonly StatusBarPickerOption[];
+```
+
+##### value
+
+```ts
+value: string | null;
+```
+
+The selected option id; `null` when nothing is attached.
+
+##### onSelect
+
+```ts
+onSelect: (id) => void;
+```
+
+Called with a different option's id.
+
+###### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `id`      | `string` |
+
+###### Returns
+
+`void`
+
+##### emptyMessage?
+
+```ts
+optional emptyMessage?: ReactNode;
+```
+
+Shown when the list is empty, e.g. why nothing can be chosen.
+
+##### accessibleLabel?
+
+```ts
+optional accessibleLabel?: string;
+```
+
+The trigger's accessible name; defaults to "\<noun\>: \<label\>".
+
+##### disabled?
+
+```ts
+optional disabled?: boolean;
+```
+
+##### open?
+
+```ts
+optional open?: boolean;
+```
+
+Host-owned popup visibility; omitted for the ordinary trigger-owned picker.
+
+##### onOpenChange?
+
+```ts
+optional onOpenChange?: (open) => void;
+```
+
+Reports popup dismissal or trigger activation to the host.
+
+###### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `open`    | `boolean` |
+
+###### Returns
+
+`void`
+
+---
+
+### StatusBarChipProps
+
+```ts
+type StatusBarChipProps = Omit<
+  ButtonHTMLAttributes<HTMLButtonElement>,
+  "children"
+> &
+  object;
+```
+
+Props accepted by StatusBarChip.
+
+#### Type Declaration
+
+| Name        | Type        | Description                                                                                                           |
+| ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
+| `label`     | `ReactNode` | Visible name of the item, e.g. "Ports".                                                                               |
+| `icon?`     | `ReactNode` | Decorative mark before the label; on a phone the chip shows it alone.                                                 |
+| `readout?`  | `ReactNode` | A readout after the label, such as a CountBadge.                                                                      |
+| `pressed?`  | `boolean`   | Toggle state. `undefined` is an ordinary action; a boolean adds `aria-pressed` and fills the chip while on.           |
+| `expanded?` | `boolean`   | Disclosure state for a chip that opens a menu or panel. A boolean adds `aria-expanded` and fills the chip while open. |
+
+## Variables
+
+### StatusBarChip
+
+```ts
+const StatusBarChip: ForwardRefExoticComponent<
+  Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> &
+    object &
+    RefAttributes<HTMLButtonElement>
+>;
+```
+
+One App-declared status bar control (an action, a toggle or a menu trigger): a
+flat chip with the same quiet face as StatusBarPicker. It forwards its ref and
+props, so a menu can render it as its trigger.
+
+## Functions
+
+### AppStatusBar()
+
+```ts
+function AppStatusBar(__namedParameters): Element;
+```
+
+One App window's status bar: its attachment first, then the App's own readouts,
+with an optional far-end readout. One bar per window.
+
+#### Parameters
+
+| Parameter           | Type                                      |
+| ------------------- | ----------------------------------------- |
+| `__namedParameters` | [`AppStatusBarProps`](#appstatusbarprops) |
+
+#### Returns
+
+`Element`
+
+---
+
+### AppStatusItem()
+
+```ts
+function AppStatusItem(__namedParameters): Element;
+```
+
+One quiet status readout.
+
+#### Parameters
+
+| Parameter           | Type                                  |
+| ------------------- | ------------------------------------- |
+| `__namedParameters` | `HTMLAttributes`\<`HTMLSpanElement`\> |
+
+#### Returns
+
+`Element`
+
+---
+
+### StatusBarPicker()
+
+```ts
+function StatusBarPicker(__namedParameters): Element;
+```
+
+The status bar's attachment picker: a quiet label that opens a searchable list
+above the bar. Selection is a request; the caller owns the change.
+
+#### Parameters
+
+| Parameter           | Type                                            |
+| ------------------- | ----------------------------------------------- |
+| `__namedParameters` | [`StatusBarPickerProps`](#statusbarpickerprops) |
+
+#### Returns
+
+`Element`

package/docs/api/blocks/async-state.md

@@ -0,0 +1,53 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/caps**](../README.md)
+
+---
+
+[@fungi.computer/caps](../README.md) / blocks/async-state
+
+# blocks/async-state
+
+## Type Aliases
+
+### AsyncStateValue
+
+```ts
+type AsyncStateValue = "loading" | "empty" | "error" | "content";
+```
+
+Supported AsyncStateValue values.
+
+---
+
+### AsyncStateProps
+
+```ts
+type AsyncStateProps = Omit<HTMLAttributes<HTMLDivElement>, "content"> & object;
+```
+
+Props accepted by AsyncState.
+
+#### Type Declaration
+
+| Name      | Type                                  | Description                                                             |
+| --------- | ------------------------------------- | ----------------------------------------------------------------------- |
+| `state`   | [`AsyncStateValue`](#asyncstatevalue) | The host's explicit state; this block does not infer it from its slots. |
+| `loading` | `ReactNode`                           | -                                                                       |
+| `empty`   | `ReactNode`                           | -                                                                       |
+| `error`   | `ReactNode`                           | -                                                                       |
+| `content` | `ReactNode`                           | -                                                                       |
+
+## Variables
+
+### AsyncState
+
+```ts
+const AsyncState: ForwardRefExoticComponent<
+  Omit<HTMLAttributes<HTMLDivElement>, "content"> &
+    object &
+    RefAttributes<HTMLDivElement>
+>;
+```
+
+Selects a caller-rendered state region without fetching or inventing copy.

package/docs/api/blocks/card-grid.md

@@ -0,0 +1,31 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/caps**](../README.md)
+
+---
+
+[@fungi.computer/caps](../README.md) / blocks/card-grid
+
+# blocks/card-grid
+
+## Type Aliases
+
+### CardGridMinWidth
+
+```ts
+type CardGridMinWidth = "narrow" | "regular" | "wide";
+```
+
+Minimum width for a card column before the grid adds another column.
+
+## Variables
+
+### CardGrid
+
+```ts
+const CardGrid: ForwardRefExoticComponent<
+  HTMLAttributes<HTMLDivElement> & object & RefAttributes<HTMLDivElement>
+>;
+```
+
+A responsive grid that fits complete cards to the available content width.