@fairfox/polly 0.70.0 → 0.72.0

package/dist/src/polly-ui/Cluster.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Cluster — wrapping row of variable-width items.
+ *
+ * The flex-wrap counterpart to <Layout>. Where Layout owns CSS grid
+ * tracks, Cluster owns a row of items that differ in width and must
+ * reflow as space runs out — filter chips, tag and badge lists, groups
+ * of small buttons. Items keep even spacing on both axes via `gap`; the
+ * row wraps automatically at narrow widths. Like Layout, props map to
+ * CSS custom properties so consumers can override any of them in a
+ * media query without touching specificity.
+ *
+ * This is the second (and final) layout primitive: a consumer never
+ * writes `display: flex` or `display: grid` themselves — grid goes
+ * through <Layout>, a wrapping cluster goes through <Cluster>.
+ */
+import { type ComponentChildren, type JSX } from "preact";
+export type ClusterProps = {
+    children: ComponentChildren;
+    /** Polymorphic element (div, nav, ul, …). Defaults to 'div'. */
+    as?: keyof JSX.IntrinsicElements;
+    /** Space between items, both axes. Typically a `--polly-space-*` token. */
+    gap?: string;
+    padding?: string;
+    /** Main-axis distribution — maps to justify-content. Default: start. */
+    justify?: string;
+    /** Cross-axis alignment within a wrapped row — maps to align-items. Default: center. */
+    align?: string;
+    /** Render as inline-flex so the cluster flows inline with surrounding text. */
+    inline?: boolean;
+    className?: string;
+    id?: string;
+    role?: JSX.AriaRole;
+    "aria-label"?: string;
+};
+export declare function Cluster(props: ClusterProps): JSX.Element;

package/dist/src/polly-ui/Code.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Code — inline monospace code span.
+ *
+ * Renders a `<code>` with the `--polly-font-mono` stack, a faint sunken
+ * tint, and snug padding so a consumer never hand-rolls a `.mono` class
+ * for inline code, identifiers, or keyboard hints. For multi-line code
+ * blocks, pass `block`, which switches to a pre-wrapped <pre><code>.
+ */
+import type { ComponentChildren, JSX } from "preact";
+export type CodeProps = {
+    children: ComponentChildren;
+    /** Render as a block (<pre><code>) instead of an inline span. */
+    block?: boolean;
+    className?: string;
+    id?: string;
+};
+export declare function Code(props: CodeProps): JSX.Element;

package/dist/src/polly-ui/Text.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Text — typographic primitive for secondary and sized copy.
+ *
+ * Renders subtitles, captions, field labels, and empty-state copy
+ * without the consumer reaching for a `style` attribute or a hand-rolled
+ * `.muted` class. `tone` and `size` map to the semantic `--polly-text-*`
+ * token family; `as` keeps the element polymorphic so the same
+ * primitive backs a <span>, <p>, <label>, or <figcaption>. A no-prop
+ * <Text> is an ordinary <span> at body size and default colour.
+ */
+import { type ComponentChildren, type JSX } from "preact";
+export type TextTone = "default" | "muted";
+export type TextSize = "xs" | "sm" | "md" | "lg" | "xl";
+export type TextWeight = "normal" | "medium" | "bold";
+export type TextProps = {
+    children: ComponentChildren;
+    /** Polymorphic element (span, p, label, figcaption, …). Defaults to 'span'. */
+    as?: keyof JSX.IntrinsicElements;
+    /** Colour role. 'muted' renders de-emphasised secondary text. Default: 'default'. */
+    tone?: TextTone;
+    /** Token-backed font size. Default: inherit from context. */
+    size?: TextSize;
+    /** Token-backed font weight. Default: inherit from context. */
+    weight?: TextWeight;
+    className?: string;
+    id?: string;
+    /** Forwarded so <Text as="label"> can point at a control. */
+    htmlFor?: string;
+    "aria-hidden"?: boolean;
+};
+export declare function Text(props: TextProps): JSX.Element;

package/dist/src/polly-ui/index.css

@@ -55,6 +55,191 @@
   }
 }
 
+/* src/polly-ui/Dropdown.module.css */
+@layer polly-components {
+  .dropdown_HX48zA {
+    position: relative;
+    display: inline-block;
+  }
+
+  .trigger_HX48zA {
+    display: inline-block;
+  }
+
+  .menu_HX48zA {
+    position: absolute;
+    inset: unset;
+    z-index: var(--polly-z-raised);
+    margin: var(--polly-space-xs) 0 0;
+    padding: var(--polly-space-xs) 0;
+    border: var(--polly-border-width-default) solid var(--polly-border);
+    border-radius: var(--polly-radius-md);
+    background-color: var(--polly-surface);
+    box-shadow: var(--polly-shadow-md);
+    box-sizing: border-box;
+    overflow-y: auto;
+    min-width: 160px;
+    max-height: 280px;
+    top: 100%;
+    left: 0;
+  }
+
+  .alignRight_HX48zA {
+    left: auto;
+    right: 0;
+  }
+}
+
+/* src/polly-ui/Layout.module.css */
+@layer polly-components {
+  .layout_QgwWPg {
+    --l-cols: none;
+    --l-rows: none;
+    --l-gap: 0;
+    --l-p: 0;
+    --l-h: auto;
+    --l-mh: auto;
+    --l-mis: none;
+    --l-ji: stretch;
+    --l-ai: start;
+    --l-jc: normal;
+    --l-ac: normal;
+    --l-js: auto;
+    --l-as: auto;
+    --l-flow: row;
+    --l-arows: auto;
+    --l-acols: auto;
+    --l-col: auto;
+    display: grid;
+    box-sizing: border-box;
+    max-inline-size: var(--l-mis);
+    grid-template-columns: var(--l-cols);
+    grid-template-rows: var(--l-rows);
+    gap: var(--l-gap);
+    padding: var(--l-p);
+    height: var(--l-h);
+    min-height: var(--l-mh);
+    justify-items: var(--l-ji);
+    align-items: var(--l-ai);
+    justify-content: var(--l-jc);
+    align-content: var(--l-ac);
+    justify-self: var(--l-js);
+    align-self: var(--l-as);
+    grid-auto-flow: var(--l-flow);
+    grid-auto-rows: var(--l-arows);
+    grid-auto-columns: var(--l-acols);
+    grid-column: var(--l-col);
+    inline-size: 100%;
+    margin-inline-start: auto;
+    margin-inline-end: auto;
+  }
+
+  .inline_QgwWPg {
+    display: inline-grid;
+    inline-size: auto;
+  }
+
+  @media (max-width: 640px) {
+    .stackOnMobile_QgwWPg {
+      grid-template-columns: 1fr;
+      grid-auto-flow: row;
+      grid-column: auto;
+    }
+  }
+}
+
+/* src/polly-ui/Select.module.css */
+@layer polly-components {
+  .select_daofbw {
+    display: inline-block;
+  }
+
+  .label_daofbw {
+    display: block;
+    margin-bottom: var(--polly-space-xs);
+    font-size: var(--polly-text-sm);
+    font-weight: var(--polly-weight-medium);
+    color: var(--polly-text-muted);
+  }
+
+  .trigger_daofbw {
+    display: inline-block;
+    padding: var(--polly-space-sm) var(--polly-space-md);
+    border: var(--polly-border-width-default) solid var(--polly-border);
+    border-radius: var(--polly-radius-sm);
+    background-color: var(--polly-surface);
+    font-family: inherit;
+    font-size: var(--polly-text-md);
+    color: var(--polly-text);
+    text-align: left;
+    cursor: pointer;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    min-width: 140px;
+  }
+
+  .trigger_daofbw:disabled {
+    opacity: var(--polly-opacity-disabled);
+    cursor: not-allowed;
+  }
+
+  .placeholder_daofbw {
+    color: var(--polly-text-muted);
+  }
+
+  .actions_daofbw {
+    padding: var(--polly-space-xs) var(--polly-space-sm);
+    border-bottom: var(--polly-border-width-default) solid var(--polly-border);
+  }
+
+  .actionBtn_daofbw {
+    display: inline-block;
+    padding: var(--polly-space-xs) var(--polly-space-sm);
+    border-radius: var(--polly-radius-sm);
+    font-family: inherit;
+    font-size: var(--polly-text-xs);
+    color: var(--polly-accent);
+    cursor: pointer;
+    text-align: center;
+    background: none;
+    border: none;
+    width: 100%;
+  }
+
+  .actionBtn_daofbw:hover {
+    background-color: var(--polly-surface-sunken);
+  }
+
+  .option_daofbw {
+    display: block;
+    padding: var(--polly-space-sm) var(--polly-space-md);
+    font-family: inherit;
+    font-size: var(--polly-text-sm);
+    color: var(--polly-text);
+    text-align: left;
+    cursor: pointer;
+    background: none;
+    border: none;
+    width: 100%;
+  }
+
+  .option_daofbw:hover {
+    background-color: var(--polly-surface-sunken);
+  }
+
+  .optionSelected_daofbw {
+    background-color: color-mix(in srgb, var(--polly-accent) 8%, var(--polly-surface));
+  }
+
+  .optionCheck_daofbw {
+    accent-color: var(--polly-accent);
+    margin-right: var(--polly-space-sm);
+    vertical-align: middle;
+    pointer-events: none;
+  }
+}
+
 /* src/polly-ui/Badge.module.css */
 @layer polly-components {
   .badge_cZd0Aw {
@@ -203,64 +388,6 @@
   }
 }
 
-/* src/polly-ui/Layout.module.css */
-@layer polly-components {
-  .layout_QgwWPg {
-    --l-cols: none;
-    --l-rows: none;
-    --l-gap: 0;
-    --l-p: 0;
-    --l-h: auto;
-    --l-mh: auto;
-    --l-mis: none;
-    --l-ji: stretch;
-    --l-ai: start;
-    --l-jc: normal;
-    --l-ac: normal;
-    --l-js: auto;
-    --l-as: auto;
-    --l-flow: row;
-    --l-arows: auto;
-    --l-acols: auto;
-    --l-col: auto;
-    display: grid;
-    box-sizing: border-box;
-    max-inline-size: var(--l-mis);
-    grid-template-columns: var(--l-cols);
-    grid-template-rows: var(--l-rows);
-    gap: var(--l-gap);
-    padding: var(--l-p);
-    height: var(--l-h);
-    min-height: var(--l-mh);
-    justify-items: var(--l-ji);
-    align-items: var(--l-ai);
-    justify-content: var(--l-jc);
-    align-content: var(--l-ac);
-    justify-self: var(--l-js);
-    align-self: var(--l-as);
-    grid-auto-flow: var(--l-flow);
-    grid-auto-rows: var(--l-arows);
-    grid-auto-columns: var(--l-acols);
-    grid-column: var(--l-col);
-    inline-size: 100%;
-    margin-inline-start: auto;
-    margin-inline-end: auto;
-  }
-
-  .inline_QgwWPg {
-    display: inline-grid;
-    inline-size: auto;
-  }
-
-  @media (max-width: 640px) {
-    .stackOnMobile_QgwWPg {
-      grid-template-columns: 1fr;
-      grid-auto-flow: row;
-      grid-column: auto;
-    }
-  }
-}
-
 /* src/polly-ui/Surface.module.css */
 @layer polly-components {
   .surface_pQCFqA {
@@ -361,6 +488,55 @@
   }
 }
 
+/* src/polly-ui/Cluster.module.css */
+@layer polly-components {
+  .cluster_pNLz5g {
+    --c-gap: 0;
+    --c-p: 0;
+    --c-jc: flex-start;
+    --c-ai: center;
+    display: flex;
+    box-sizing: border-box;
+    gap: var(--c-gap);
+    padding: var(--c-p);
+    justify-content: var(--c-jc);
+    align-items: var(--c-ai);
+    flex-wrap: wrap;
+  }
+
+  .inline_pNLz5g {
+    display: inline-flex;
+  }
+}
+
+/* src/polly-ui/Code.module.css */
+@layer polly-components {
+  .code_Vc8yiw {
+    font-family: var(--polly-font-mono);
+    font-size: var(--polly-text-sm);
+    padding: .1em var(--polly-space-xs);
+    border-radius: var(--polly-radius-sm);
+    background-color: var(--polly-surface-sunken);
+    color: var(--polly-text);
+    word-break: break-word;
+  }
+
+  .block_Vc8yiw {
+    padding: var(--polly-space-md);
+    border-radius: var(--polly-radius-md);
+    background-color: var(--polly-surface-sunken);
+    overflow-x: auto;
+    margin: 0;
+  }
+
+  .block_Vc8yiw code {
+    font-family: var(--polly-font-mono);
+    font-size: var(--polly-text-sm);
+    color: var(--polly-text);
+    white-space: pre;
+  }
+}
+
 /* src/polly-ui/Collapsible.module.css */
 @layer polly-components {
   .collapsible_sEhnPw {
@@ -530,133 +706,6 @@
   }
 }
 
-/* src/polly-ui/Dropdown.module.css */
-@layer polly-components {
-  .dropdown_HX48zA {
-    position: relative;
-    display: inline-block;
-  }
-
-  .trigger_HX48zA {
-    display: inline-block;
-  }
-
-  .menu_HX48zA {
-    position: absolute;
-    inset: unset;
-    z-index: var(--polly-z-raised);
-    margin: var(--polly-space-xs) 0 0;
-    padding: var(--polly-space-xs) 0;
-    border: var(--polly-border-width-default) solid var(--polly-border);
-    border-radius: var(--polly-radius-md);
-    background-color: var(--polly-surface);
-    box-shadow: var(--polly-shadow-md);
-    box-sizing: border-box;
-    overflow-y: auto;
-    min-width: 160px;
-    max-height: 280px;
-    top: 100%;
-    left: 0;
-  }
-
-  .alignRight_HX48zA {
-    left: auto;
-    right: 0;
-  }
-}
-
-/* src/polly-ui/Select.module.css */
-@layer polly-components {
-  .select_daofbw {
-    display: inline-block;
-  }
-
-  .label_daofbw {
-    display: block;
-    margin-bottom: var(--polly-space-xs);
-    font-size: var(--polly-text-sm);
-    font-weight: var(--polly-weight-medium);
-    color: var(--polly-text-muted);
-  }
-
-  .trigger_daofbw {
-    display: inline-block;
-    padding: var(--polly-space-sm) var(--polly-space-md);
-    border: var(--polly-border-width-default) solid var(--polly-border);
-    border-radius: var(--polly-radius-sm);
-    background-color: var(--polly-surface);
-    font-family: inherit;
-    font-size: var(--polly-text-md);
-    color: var(--polly-text);
-    text-align: left;
-    cursor: pointer;
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    min-width: 140px;
-  }
-
-  .trigger_daofbw:disabled {
-    opacity: var(--polly-opacity-disabled);
-    cursor: not-allowed;
-  }
-
-  .placeholder_daofbw {
-    color: var(--polly-text-muted);
-  }
-
-  .actions_daofbw {
-    padding: var(--polly-space-xs) var(--polly-space-sm);
-    border-bottom: var(--polly-border-width-default) solid var(--polly-border);
-  }
-
-  .actionBtn_daofbw {
-    display: inline-block;
-    padding: var(--polly-space-xs) var(--polly-space-sm);
-    border-radius: var(--polly-radius-sm);
-    font-family: inherit;
-    font-size: var(--polly-text-xs);
-    color: var(--polly-accent);
-    cursor: pointer;
-    text-align: center;
-    background: none;
-    border: none;
-    width: 100%;
-  }
-
-  .actionBtn_daofbw:hover {
-    background-color: var(--polly-surface-sunken);
-  }
-
-  .option_daofbw {
-    display: block;
-    padding: var(--polly-space-sm) var(--polly-space-md);
-    font-family: inherit;
-    font-size: var(--polly-text-sm);
-    color: var(--polly-text);
-    text-align: left;
-    cursor: pointer;
-    background: none;
-    border: none;
-    width: 100%;
-  }
-
-  .option_daofbw:hover {
-    background-color: var(--polly-surface-sunken);
-  }
-
-  .optionSelected_daofbw {
-    background-color: color-mix(in srgb, var(--polly-accent) 8%, var(--polly-surface));
-  }
-
-  .optionCheck_daofbw {
-    accent-color: var(--polly-accent);
-    margin-right: var(--polly-space-sm);
-    vertical-align: middle;
-    pointer-events: none;
-  }
-}
-
 /* src/polly-ui/Skeleton.module.css */
 @layer polly-components {
   @keyframes pollyShimmer_gpBHJA {
@@ -736,6 +785,50 @@
   }
 }
 
+/* src/polly-ui/Text.module.css */
+@layer polly-components {
+  .text_75HKdQ {
+    color: var(--polly-text);
+    font-family: inherit;
+  }
+
+  .muted_75HKdQ {
+    color: var(--polly-text-muted);
+  }
+
+  .xs_75HKdQ {
+    font-size: var(--polly-text-xs);
+  }
+
+  .sm_75HKdQ {
+    font-size: var(--polly-text-sm);
+  }
+
+  .md_75HKdQ {
+    font-size: var(--polly-text-md);
+  }
+
+  .lg_75HKdQ {
+    font-size: var(--polly-text-lg);
+  }
+
+  .xl_75HKdQ {
+    font-size: var(--polly-text-xl);
+  }
+
+  .normal_75HKdQ {
+    font-weight: var(--polly-weight-normal);
+  }
+
+  .medium_75HKdQ {
+    font-weight: var(--polly-weight-medium);
+  }
+
+  .bold_75HKdQ {
+    font-weight: var(--polly-weight-bold);
+  }
+}
+
 /* src/polly-ui/TextInput.module.css */
 @layer polly-components {
   .input_ez4_Vg {

package/dist/src/polly-ui/index.d.ts

@@ -8,11 +8,14 @@
  * the default look; redefine variables to re-theme.
  */
 export { ActionForm, type ActionFormProps } from "./ActionForm.tsx";
-export { ActionInput, type ActionInputProps, type ActionInputSaveOn, type ActionInputVariant, } from "./ActionInput.tsx";
+export { ActionInput, type ActionInputProps, type ActionInputSaveOn, type ActionInputType, type ActionInputVariant, } from "./ActionInput.tsx";
+export { ActionSelect, type ActionSelectProps } from "./ActionSelect.tsx";
 export { Badge, type BadgeProps, type BadgeVariant } from "./Badge.tsx";
 export { Button, type ButtonColor, type ButtonProps, type ButtonSize, type ButtonTier, } from "./Button.tsx";
 export { Card, type CardProps, type CardSlotProps } from "./Card.tsx";
 export { Checkbox, type CheckboxProps } from "./Checkbox.tsx";
+export { Cluster, type ClusterProps } from "./Cluster.tsx";
+export { Code, type CodeProps } from "./Code.tsx";
 export { Collapsible, type CollapsibleProps } from "./Collapsible.tsx";
 export { ConfirmDialog, type ConfirmOptions, confirm } from "./ConfirmDialog.tsx";
 export { Dropdown, type DropdownProps } from "./Dropdown.tsx";
@@ -23,6 +26,7 @@ export { Select, type SelectOption, type SelectProps } from "./Select.tsx";
 export { Skeleton, type SkeletonProps, type SkeletonVariant } from "./Skeleton.tsx";
 export { Surface, type SurfaceProps, type SurfaceVariant } from "./Surface.tsx";
 export { type Tab, Tabs, type TabsProps } from "./Tabs.tsx";
+export { Text, type TextProps, type TextSize, type TextTone, type TextWeight, } from "./Text.tsx";
 export { TextInput, type TextInputProps } from "./TextInput.tsx";
 export { Toast, type ToastViewportProps } from "./Toast.tsx";
 export { Toggle, type ToggleProps } from "./Toggle.tsx";