@ptbdynamic/plinth 0.0.0-stage → 0.2.0

package/packages/react/dist/list-row.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The list row's chevron, for a row that opens something. It points the other way in
+ * right-to-left text (data-mirror). Blade's list row prints the same markup.
+ */
+export declare const listRowChevron = "<span class=\"plinth-icon plinth-list-row-chevron\" data-size=\"sm\" data-mirror aria-hidden=\"true\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M9 6l6 6-6 6\"></path></svg></span>";

package/packages/react/dist/markup.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+/** Plinth's class with the project's own after it, as Blade's `$attributes->merge()` does. */
+export declare const classNames: (base: string, extra: string | undefined) => string;
+/**
+ * Whether a node prints anything, as Vue's `hasContent` tells a filled slot from an empty one:
+ * `null`, `undefined`, booleans and blank text print nothing, nor does a list or a fragment of
+ * them (an empty `map()`, a false `&&`).
+ */
+export declare const hasContent: (node: ReactNode) => boolean;

package/packages/react/dist/menu.d.ts

@@ -0,0 +1,7 @@
+/** A menu item's tone: `neutral` (the default) or `danger`, for an item that destroys or removes. */
+export declare const menuItemTones: readonly ["neutral", "danger"];
+export type MenuItemTone = (typeof menuItemTones)[number];
+/** A tone from the list, or `neutral` when it is not one of them. */
+export declare function menuItemTone(value: string | undefined): MenuItemTone;
+/** The id of the menu around an item, which a button item closes when it is pressed. */
+export declare const MenuIdContext: import("react").Context<string | undefined>;

package/packages/react/dist/page-header.d.ts

@@ -0,0 +1,5 @@
+/** The levels the page header's heading can take. `h1` is the default. */
+export declare const pageHeaderLevels: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
+export type PageHeaderLevel = (typeof pageHeaderLevels)[number];
+/** A level from the list, or `h1` when it is not one of them. */
+export declare function pageHeaderLevel(value: string | undefined): PageHeaderLevel;

package/packages/react/dist/sheet.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The edge a sheet comes from. `end` is the default; `start` and `end` are logical, so they swap
+ * in right-to-left text. The same list is the side on a phone (`sidePhone`), which has no default.
+ */
+export declare const sheetSides: readonly ["start", "end", "top", "bottom"];
+export type SheetSide = (typeof sheetSides)[number];
+/** A side from the list, or `end` when it is not one of them. */
+export declare function sheetSide(value: string | undefined): SheetSide;
+/** A side from the list, or nothing (no `data-side-phone`) when it is not one of them. */
+export declare function sheetSidePhone(value: string | undefined): SheetSide | undefined;
+/** The close button's icon, a cross. Blade's sheet prints the same markup. */
+export declare const sheetCloseIcon = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M6 6l12 12M18 6L6 18\"></path></svg>";

package/packages/react/dist/size.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One size scale for every component, as Filament has (and as Blade's Size enum). Each component
+ * supports the sizes that make sense for it and falls back to its default for the rest.
+ */
+export declare const sizes: readonly ["xs", "sm", "md", "lg", "xl"];
+export type Size = (typeof sizes)[number];
+/** The control sizes (28, 32 and 40 px): buttons, icon buttons, inputs. */
+export declare const controlSizes: readonly ["sm", "md", "lg"];
+export type ControlSize = (typeof controlSizes)[number];
+/** A size from `supported`, or `fallback` when it isn't one of them. */
+export declare function resolveSize<T extends Size>(value: string | undefined, supported: readonly T[], fallback: T): T;
+/** The size of the icons inside a control of this size. */
+export declare function iconSizeFor(size: Size): 'sm' | 'md';

package/packages/react/dist/swipe.d.ts

@@ -0,0 +1,15 @@
+import { type Ref, type RefCallback } from 'react';
+/**
+ * What a bottom panel on a phone needs beyond the platform (modal.css, docs/adr/0005): the
+ * dialog, sheet and drawer are dragged by native scrolling, and this closes the dialog (with
+ * `requestClose()`, so `cancel` can keep it open) when the scrolling settles with the panel off the bottom edge, closes it on a tap above the panel when
+ * it has `closedby="any"`, and opens a drawer at its `data-snap` point. It does nothing while the
+ * root isn't a scroll-snap container (from 768px up, or a panel with no handle). Returns what
+ * removes the listeners.
+ */
+export declare function swipeToClose(dialog: HTMLDialogElement): () => void;
+/**
+ * `swipeToClose()` on a component's dialog, as a callback ref that also sets the project's own
+ * `ref`, while the dialog is mounted.
+ */
+export declare function useSwipeToClose(ref: Ref<HTMLDialogElement> | undefined): RefCallback<HTMLDialogElement>;

package/packages/react/dist/text-field.d.ts

@@ -0,0 +1,10 @@
+/** The text field sizes (28 and 32 px), from the shared size scale. `md` is the default. */
+export declare const textFieldSizes: readonly ["sm", "md"];
+export type TextFieldSize = (typeof textFieldSizes)[number];
+/** A size from the list, or `md` when it is not one of them. */
+export declare function textFieldSize(value: string | undefined): TextFieldSize;
+/**
+ * What a field's aria-describedby lists: its description's id, then its error's, or nothing when
+ * it has neither (text-field.css, textarea.css).
+ */
+export declare function fieldDescribedBy(id: string, description: string | undefined, error: string | undefined): string | undefined;

package/packages/react/dist/tones.d.ts

@@ -0,0 +1,5 @@
+/** The tones a component such as the badge accepts. The first one is the default. */
+export declare const tones: readonly ["neutral", "success", "warning", "danger"];
+export type Tone = (typeof tones)[number];
+/** A tone from the list, or the default when it is not one of them. */
+export declare function tone(value: string | undefined): Tone;

package/packages/tokens/dist/index.d.ts

@@ -0,0 +1,230 @@
+/* Built from packages/tokens/tokens/*.json. Do not edit by hand. */
+export interface Token {
+  path: string[];
+  name: string;
+  cssVar: string;
+  tier: 'primitive' | 'semantic' | 'component';
+  type: string;
+  description?: string;
+  value: string;
+  dark?: string;
+  ref?: string;
+  darkRef?: string;
+  css: string;
+  darkCss?: string;
+}
+
+export declare const tokens: Token[];
+
+export declare const vars: {
+  "space": {
+    "0": string;
+    "1": string;
+    "2": string;
+    "3": string;
+    "4": string;
+    "5": string;
+    "6": string;
+    "8": string;
+    "10": string;
+    "12": string;
+    "14": string;
+    "16": string;
+    "0-5": string;
+  };
+  "radius": {
+    "control": string;
+    "container": string;
+    "pill": string;
+  };
+  "border-width": {
+    "thin": string;
+    "thick": string;
+  };
+  "opacity": {
+    "disabled": string;
+  };
+  "focus-ring": {
+    "width": string;
+    "offset": string;
+    "offset-filled": string;
+    "offset-inset": string;
+  };
+  "font": {
+    "family": {
+      "body": string;
+      "mono": string;
+    };
+    "size": {
+      "xs": string;
+      "sm": string;
+      "md": string;
+      "lg": string;
+      "xl": string;
+      "2xl": string;
+      "3xl": string;
+      "4xl": string;
+      "5xl": string;
+      "6xl": string;
+      "field": string;
+    };
+    "weight": {
+      "regular": string;
+      "medium": string;
+      "semibold": string;
+      "bold": string;
+    };
+    "leading": {
+      "display": string;
+      "tight": string;
+      "normal": string;
+    };
+    "tracking": {
+      "normal": string;
+      "snug": string;
+      "tight": string;
+      "tighter": string;
+    };
+  };
+  "duration": {
+    "fast": string;
+    "normal": string;
+    "slow": string;
+  };
+  "easing": {
+    "standard": string;
+    "enter": string;
+    "exit": string;
+  };
+  "control": {
+    "sm": string;
+    "md": string;
+    "lg": string;
+  };
+  "touch-target": string;
+  "size": {
+    "icon": {
+      "sm": string;
+      "md": string;
+      "lg": string;
+    };
+    "row": string;
+    "avatar": {
+      "sm": string;
+      "md": string;
+      "lg": string;
+      "xl": string;
+    };
+    "dialog": string;
+    "panel": string;
+    "peek": string;
+    "menu": {
+      "min": string;
+      "max": string;
+    };
+  };
+  "layer": {
+    "base": string;
+    "sticky": string;
+    "overlay": string;
+    "sheet": string;
+    "toast": string;
+  };
+  "breakpoint": {
+    "md": string;
+    "lg": string;
+  };
+  "color": {
+    "surface": string;
+    "surface-raised": string;
+    "surface-sunken": string;
+    "surface-hover": string;
+    "text": string;
+    "text-muted": string;
+    "text-subtle": string;
+    "border": string;
+    "border-strong": string;
+    "divider": string;
+    "primary": string;
+    "primary-hover": string;
+    "primary-active": string;
+    "on-primary": string;
+    "primary-edge": string;
+    "accent": string;
+    "accent-text": string;
+    "on-accent": string;
+    "focus-ring": string;
+    "overlay": string;
+    "info": string;
+    "info-surface": string;
+    "info-text": string;
+    "success": string;
+    "success-surface": string;
+    "success-text": string;
+    "warning": string;
+    "warning-surface": string;
+    "warning-text": string;
+    "danger": string;
+    "danger-surface": string;
+    "danger-text": string;
+    "accent-hover": string;
+    "accent-active": string;
+    "danger-solid": string;
+    "danger-solid-hover": string;
+    "danger-solid-active": string;
+    "on-danger": string;
+    "accent-subtle": string;
+    "accent-subtle-hover": string;
+    "accent-subtle-active": string;
+  };
+  "elevation": {
+    "1": string;
+    "2": string;
+    "3": string;
+  };
+  "page-header": {
+    "height": string;
+    "offset": string;
+  };
+  "data-table": {
+    "row-height": string;
+  };
+  "list-row": {
+    "height": string;
+  };
+  "pill": {
+    "height": string;
+  };
+  "dialog": {
+    "width": string;
+  };
+  "sheet": {
+    "side-width": string;
+  };
+  "drawer": {
+    "peek-height": string;
+  };
+  "section-menu": {
+    "height": string;
+    "item-height": string;
+  };
+  "menu": {
+    "min-width": string;
+    "max-width": string;
+  };
+  "text-field": {
+    "trailing-size": string;
+  };
+  "callout": {
+    "neutral-surface": string;
+    "neutral-border": string;
+    "info-surface": string;
+    "info-border": string;
+    "success-surface": string;
+    "success-border": string;
+    "warning-surface": string;
+    "warning-border": string;
+    "danger-surface": string;
+    "danger-border": string;
+  };
+};