@instruments/materia-ui 0.1.0

package/dist/tokens/tone.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tone system for the Materia design system.
+ *
+ * `Tone` is the single, canonical semantic-colour vocabulary shared across the
+ * design system - the colour analog of `ComponentSize`. Every component that
+ * exposes a semantic colour axis draws from THIS list; none define a bespoke
+ * tone union of their own.
+ *
+ * A component that supports only part of the vocabulary subsets it with
+ * `Extract<Tone, …>` (e.g. `Extract<Tone, "neutral" | "danger">`) rather than
+ * hand-spelling a narrower union - exactly the way size-limited components do
+ * `Extract<ComponentSize, …>`. This keeps the values in lockstep: rename or add
+ * a tone here once and every subset tracks it. Components that back their tone
+ * with a cva variant map guarantee the lockstep at compile time by annotating
+ * the variant object `satisfies Record<Tone, …>` (or the relevant subset).
+ *
+ * @module
+ */
+/**
+ * The canonical semantic colour vocabulary.
+ *
+ * neutral < brand < danger < warning < success < info - not an ordering, just
+ * the stable declaration order used for iteration in stories/matrices.
+ */
+export declare const TONES: readonly ["neutral", "brand", "danger", "warning", "success", "info"];
+/** A single semantic colour tone. Subset with `Extract<Tone, …>`, never a bespoke union. */
+export type Tone = (typeof TONES)[number];

package/dist/tokens/tone.js

@@ -0,0 +1,32 @@
+/**
+ * Tone system for the Materia design system.
+ *
+ * `Tone` is the single, canonical semantic-colour vocabulary shared across the
+ * design system - the colour analog of `ComponentSize`. Every component that
+ * exposes a semantic colour axis draws from THIS list; none define a bespoke
+ * tone union of their own.
+ *
+ * A component that supports only part of the vocabulary subsets it with
+ * `Extract<Tone, …>` (e.g. `Extract<Tone, "neutral" | "danger">`) rather than
+ * hand-spelling a narrower union - exactly the way size-limited components do
+ * `Extract<ComponentSize, …>`. This keeps the values in lockstep: rename or add
+ * a tone here once and every subset tracks it. Components that back their tone
+ * with a cva variant map guarantee the lockstep at compile time by annotating
+ * the variant object `satisfies Record<Tone, …>` (or the relevant subset).
+ *
+ * @module
+ */
+/**
+ * The canonical semantic colour vocabulary.
+ *
+ * neutral < brand < danger < warning < success < info - not an ordering, just
+ * the stable declaration order used for iteration in stories/matrices.
+ */
+export const TONES = [
+    "neutral",
+    "brand",
+    "danger",
+    "warning",
+    "success",
+    "info",
+];

package/dist/tokens/type-role.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The type ramp's roles, smallest first: the `--text-*` steps in
+ * styles/index.css from `caption` to `title`. Each owns its font-size,
+ * line-height and letter-spacing. Text and Heading take a role as their
+ * `size`; the surface-named one-offs beside the ramp (`micro`, `calendar`,
+ * `grid-header`) are classes, not roles.
+ *
+ * @module
+ */
+export declare const TYPE_ROLES: readonly ["caption", "paragraph-sm", "paragraph", "paragraph-lg", "subheading", "subheading-lg", "heading-sm", "heading", "heading-lg", "title"];
+/** A role on the type ramp; see {@link TYPE_ROLES}. */
+export type TypeRole = (typeof TYPE_ROLES)[number];

package/dist/tokens/type-role.js

@@ -0,0 +1,21 @@
+/**
+ * The type ramp's roles, smallest first: the `--text-*` steps in
+ * styles/index.css from `caption` to `title`. Each owns its font-size,
+ * line-height and letter-spacing. Text and Heading take a role as their
+ * `size`; the surface-named one-offs beside the ramp (`micro`, `calendar`,
+ * `grid-header`) are classes, not roles.
+ *
+ * @module
+ */
+export const TYPE_ROLES = [
+    "caption",
+    "paragraph-sm",
+    "paragraph",
+    "paragraph-lg",
+    "subheading",
+    "subheading-lg",
+    "heading-sm",
+    "heading",
+    "heading-lg",
+    "title",
+];

package/dist/tokens/wrap.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Flex wrap types.
+ */
+export type FlexWrap = "wrap" | "nowrap" | "wrap-reverse";

package/dist/tokens/wrap.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/cn-theme.d.ts

@@ -0,0 +1,44 @@
+/** The house tokens and utilities `cn` resolves conflicts between. */
+export declare const CN_THEME: {
+    classGroups: {
+        animate: {
+            animate: string[];
+        }[];
+        duration: {
+            duration: string[];
+        }[];
+        scale: {
+            scale: string[];
+        }[];
+        transition: string[];
+        "border-w-b": string[];
+        "border-w-e": string[];
+        "border-w-s": string[];
+        rounded: string[];
+        "stroke-w": string[];
+        mx: string[];
+        "max-h": string[];
+        "ring-w": string[];
+        top: string[];
+        mt: string[];
+        pb: string[];
+        pl: string[];
+        pr: string[];
+        pt: string[];
+        px: string[];
+        h: string[];
+    };
+    theme: {
+        "drop-shadow": string[];
+        breakpoint: string[];
+        container: string[];
+        tracking: string[];
+        spacing: string[];
+        animate: string[];
+        radius: string[];
+        shadow: string[];
+        blur: string[];
+        ease: string[];
+        text: string[];
+    };
+};

package/dist/utils/cn-theme.js

@@ -0,0 +1,119 @@
+// GENERATED by scripts/generate-cn-theme.mjs - do not edit.
+// Regenerate with `pnpm generate:cn-theme` after changing index.css; the
+// cn test fails when a token or utility there no longer merges.
+/** The house tokens and utilities `cn` resolves conflicts between. */
+export const CN_THEME = {
+    classGroups: {
+        animate: [
+            {
+                animate: ["in", "out"],
+            },
+        ],
+        duration: [
+            {
+                duration: ["instant", "quick", "normal", "moderate", "slow"],
+            },
+        ],
+        scale: [
+            {
+                scale: ["press", "press-deep", "hover"],
+            },
+        ],
+        transition: [
+            "transition-panel",
+            "transition-panel-close",
+            "transition-color-shadow",
+            "transition-color-shadow-border",
+            "transition-color-bg-shadow-border",
+            "transition-shadow-border",
+            "transition-bg-shadow-border",
+            "transition-border-shadow-opacity",
+            "transition-opacity-translate",
+            "transition-opacity-transform",
+            "transition-opacity-bg",
+            "transition-opacity-scale-color-bg",
+            "transition-margin-shadow",
+            "transition-width",
+            "transition-stroke-dashoffset",
+            "transition-inset-start-bottom",
+        ],
+        "border-w-b": ["border-b-hairline"],
+        "border-w-e": ["border-e-hairline"],
+        "border-w-s": ["border-s-hairline"],
+        rounded: ["rounded-inherit"],
+        "stroke-w": ["stroke-fine", "stroke-medium", "stroke-bold"],
+        mx: ["-mx-page-gutter"],
+        "max-h": ["max-h-below-header"],
+        "ring-w": ["ring-3"],
+        top: ["top-app-bar", "top-header", "top-header-plus"],
+        mt: ["mt-header"],
+        pb: ["pb-safe-24", "pb-safe-min-4", "pb-dialog-lift", "pb-page-gutter"],
+        pl: ["pl-page-gutter"],
+        pr: ["pr-tag-dot", "pr-page-gutter"],
+        pt: ["pt-safe-2", "pt-safe-18", "pt-header", "pt-header-half"],
+        px: ["px-page-gutter"],
+        h: ["h-below-header", "h-header"],
+    },
+    theme: {
+        "drop-shadow": ["xs", "sm", "md", "lg", "xl", "2xl", "folder"],
+        breakpoint: ["2xs", "xs", "3xl"],
+        container: ["4xs", "3xs", "2xs", "sidepanel", "dialog-viewport"],
+        tracking: ["folder-label"],
+        spacing: ["dialog-viewport", "dialog-viewport-md"],
+        animate: [
+            "overlay-in",
+            "overlay-out",
+            "fade-up",
+            "fade-in",
+            "pop-in",
+            "shimmer-text",
+        ],
+        radius: [
+            "2xs",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "4xl",
+            "5xl",
+            "modal",
+            "editorial-stack",
+        ],
+        shadow: [
+            "2xs",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "edge-bottom",
+            "edge-top",
+            "inner-2xs",
+            "inner-xs",
+            "inner-sm",
+            "inset-highlight",
+            "button-sheen",
+        ],
+        blur: ["xs", "sm", "md", "lg", "xl", "2xl", "3xl"],
+        ease: ["out", "in-out", "sheet"],
+        text: [
+            "2xs",
+            "caption",
+            "paragraph-sm",
+            "paragraph",
+            "paragraph-lg",
+            "subheading",
+            "subheading-lg",
+            "heading-sm",
+            "heading",
+            "heading-lg",
+            "title",
+            "micro",
+            "calendar",
+            "grid-header",
+        ],
+    },
+};

package/dist/utils/cn.d.ts

@@ -0,0 +1,14 @@
+import type { CnFunction } from "cn";
+/**
+ * Class merging for Tailwind v4, extended with the house tokens and utilities
+ * so that `shadow-button-sheen` replaces `shadow-md` and `duration-normal`
+ * replaces `duration-150`, rather than both surviving.
+ *
+ * In Tailwind v4, font-size utilities (text-*) use CSS variables for line-height:
+ * `line-height: var(--tw-leading, var(--text-lg--line-height))`
+ *
+ * Leading utilities (leading-*) set the --tw-leading variable, so they work
+ * together rather than conflicting. We override the default conflictingClassGroups
+ * to prevent cn from stripping leading-* when text-* is present.
+ */
+export declare const cn: CnFunction;

package/dist/utils/cn.js

@@ -0,0 +1,22 @@
+import { createCn } from "cn/config";
+import { CN_THEME } from "./cn-theme.js";
+/**
+ * Class merging for Tailwind v4, extended with the house tokens and utilities
+ * so that `shadow-button-sheen` replaces `shadow-md` and `duration-normal`
+ * replaces `duration-150`, rather than both surviving.
+ *
+ * In Tailwind v4, font-size utilities (text-*) use CSS variables for line-height:
+ * `line-height: var(--tw-leading, var(--text-lg--line-height))`
+ *
+ * Leading utilities (leading-*) set the --tw-leading variable, so they work
+ * together rather than conflicting. We override the default conflictingClassGroups
+ * to prevent cn from stripping leading-* when text-* is present.
+ */
+export const cn = createCn({
+    extend: CN_THEME,
+    override: {
+        conflictingClassGroups: {
+            "font-size": [],
+        },
+    },
+});

package/dist/utils/confetti.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Fire a subtle confetti burst - perfect for success moments.
+ * Respects prefers-reduced-motion automatically.
+ */
+export declare const fireSuccessConfetti: (options?: {
+    origin?: {
+        x: number;
+        y: number;
+    };
+}) => Promise<void>;
+/**
+ * Fire a subtle emoji confetti burst from a specific origin point.
+ * Respects prefers-reduced-motion automatically.
+ */
+export declare const fireEmojiConfetti: (options: {
+    emoji: string;
+    origin?: {
+        x: number;
+        y: number;
+    };
+}) => Promise<void>;
+/**
+ * Fire an eco-themed confetti burst with leaf emojis.
+ * Designed for eco-order unlock celebrations (e.g., reaching 4 items).
+ * Respects prefers-reduced-motion automatically.
+ */
+export declare const fireEcoConfetti: (options?: {
+    origin?: {
+        x: number;
+        y: number;
+    };
+}) => Promise<void>;

package/dist/utils/confetti.js

@@ -0,0 +1,88 @@
+import confetti from "canvas-confetti";
+/**
+ * Fire a subtle confetti burst - perfect for success moments.
+ * Respects prefers-reduced-motion automatically.
+ */
+export const fireSuccessConfetti = async (options) => {
+    // Only run in browser
+    if (typeof window === "undefined") {
+        return;
+    }
+    // Default origin: bottom-right where toasts appear
+    const origin = options?.origin ?? { x: 0.95, y: 0.85 };
+    await confetti({
+        colors: [
+            // brand-accent (orange-300)
+            "#fdba74",
+            // brand-soft (orange-50)
+            "#fff7ed",
+            // orange-400
+            "#fb923c",
+            // orange-200
+            "#fed7aa",
+        ],
+        disableForReducedMotion: true,
+        drift: 0,
+        gravity: 0.9,
+        origin,
+        particleCount: 80,
+        scalar: 0.8,
+        spread: 55,
+        ticks: 150,
+        // Ensure confetti appears above dialogs/modals
+        zIndex: 9999,
+    });
+};
+/**
+ * Fire a subtle emoji confetti burst from a specific origin point.
+ * Respects prefers-reduced-motion automatically.
+ */
+export const fireEmojiConfetti = async (options) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    const scalar = 2;
+    const emojiGlyph = confetti.shapeFromText({ scalar, text: options.emoji });
+    const origin = options.origin ?? { x: 0.5, y: 0.5 };
+    await confetti({
+        decay: 0.94,
+        disableForReducedMotion: true,
+        gravity: 0.6,
+        origin,
+        particleCount: 35,
+        scalar: 1.2,
+        // oxlint-disable-next-line anti-slop/no-shape-in-symbol-names -- `shapes` is canvas-confetti's option key
+        shapes: [emojiGlyph],
+        spread: 55,
+        startVelocity: 20,
+        ticks: 160,
+        zIndex: 9999,
+    });
+};
+/**
+ * Fire an eco-themed confetti burst with leaf emojis.
+ * Designed for eco-order unlock celebrations (e.g., reaching 4 items).
+ * Respects prefers-reduced-motion automatically.
+ */
+export const fireEcoConfetti = async (options) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    const leaf = confetti.shapeFromText({ scalar: 2, text: "\u{1F343}" });
+    const clover = confetti.shapeFromText({ scalar: 2, text: "\u{1F340}" });
+    const origin = options?.origin ?? { x: 0.5, y: 0.85 };
+    await confetti({
+        decay: 0.93,
+        disableForReducedMotion: true,
+        gravity: 0.5,
+        origin,
+        particleCount: 40,
+        scalar: 1.4,
+        // oxlint-disable-next-line anti-slop/no-shape-in-symbol-names -- `shapes` is canvas-confetti's option key
+        shapes: [leaf, clover],
+        spread: 70,
+        startVelocity: 18,
+        ticks: 180,
+        zIndex: 9999,
+    });
+};

package/dist/utils/css-variables.d.ts

@@ -0,0 +1,9 @@
+import type { CSSProperties } from "react";
+/**
+ * Build an inline `style` that carries CSS custom properties. React's
+ * `CSSProperties` has no index signature for `--*` names, so a literal with
+ * custom properties needs a cast; copying the entries across keeps the cast
+ * out of every call site. `style` is applied last so a caller's own inline
+ * style wins over the variables.
+ */
+export declare const cssVariables: (variables: Record<`--${string}`, string | number>, style?: CSSProperties) => CSSProperties;

package/dist/utils/css-variables.js

@@ -0,0 +1,12 @@
+/**
+ * Build an inline `style` that carries CSS custom properties. React's
+ * `CSSProperties` has no index signature for `--*` names, so a literal with
+ * custom properties needs a cast; copying the entries across keeps the cast
+ * out of every call site. `style` is applied last so a caller's own inline
+ * style wins over the variables.
+ */
+export const cssVariables = (variables, style) => {
+    const merged = {};
+    Object.assign(merged, variables, style);
+    return merged;
+};

package/dist/utils/data-grid-table.d.ts

@@ -0,0 +1,80 @@
+import type { Cell, Column, ColumnDef, Header, HeaderGroup, ReactTable, Row, Table } from "@tanstack/react-table";
+/**
+ * The full feature contract used by DataGrid. Sorting, filtering and facet
+ * counts are registered here, so every table can sort and filter by its
+ * column definitions alone; a table whose server sorts or filters sets
+ * `manualSorting` / `manualFiltering`. Pagination and expansion stay opt-in.
+ */
+export declare const dataGridFeatures: {
+    cellSelectionFeature: import("@tanstack/react-table").TableFeature;
+    cellSpanningFeature: import("@tanstack/react-table").TableFeature;
+    columnFacetingFeature: import("@tanstack/react-table").TableFeature;
+    columnFilteringFeature: import("@tanstack/react-table").TableFeature;
+    columnGroupingFeature: import("@tanstack/react-table").TableFeature;
+    columnOrderingFeature: import("@tanstack/react-table").TableFeature;
+    columnPinningFeature: import("@tanstack/react-table").TableFeature;
+    columnResizingFeature: import("@tanstack/react-table").TableFeature;
+    columnSizingFeature: import("@tanstack/react-table").TableFeature;
+    columnVisibilityFeature: import("@tanstack/react-table").TableFeature;
+    globalFilteringFeature: import("@tanstack/react-table").TableFeature;
+    rowAggregationFeature: import("@tanstack/react-table").TableFeature;
+    rowExpandingFeature: import("@tanstack/react-table").TableFeature;
+    rowPaginationFeature: import("@tanstack/react-table").TableFeature;
+    rowPinningFeature: import("@tanstack/react-table").TableFeature;
+    rowSelectionFeature: import("@tanstack/react-table").TableFeature;
+    rowSortingFeature: import("@tanstack/react-table").TableFeature;
+    aggregationFns: {
+        sum: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+        min: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+        max: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+        extent: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, [(number | Date) | undefined, (number | Date) | undefined]>;
+        mean: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+        median: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+        unique: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown[]>;
+        uniqueCount: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+        count: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+        first: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+        last: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    };
+    facetedRowModel: (table: Table<any, any>, columnId: string) => () => import("@tanstack/react-table").RowModel<any, any>;
+    facetedUniqueValues: (table: Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+    filterFns: {
+        arrIncludes: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        arrIncludesAll: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        arrHas: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        arrIncludesSome: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        between: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        betweenInclusive: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        empty: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        endsWith: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        equals: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        equalsString: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        equalsStringSensitive: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        inDateRange: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        inNumberRange: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        includesString: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        includesStringSensitive: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        notEmpty: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        startsWith: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+        weakEquals: import("@tanstack/react-table").CreatedFilterFn<any, any>;
+    };
+    filteredRowModel: (table: Table<any, any>) => () => import("@tanstack/react-table").RowModel<any, any>;
+    sortFns: {
+        alphanumeric: import("@tanstack/react-table").CreatedSortFn<any, any>;
+        alphanumericCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+        basic: import("@tanstack/react-table").CreatedSortFn<any, any>;
+        datetime: import("@tanstack/react-table").CreatedSortFn<any, any>;
+        text: import("@tanstack/react-table").CreatedSortFn<any, any>;
+        textCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    };
+    sortedRowModel: (table: Table<any, any>) => () => import("@tanstack/react-table").RowModel<any, any>;
+};
+export type DataGridFeatures = typeof dataGridFeatures;
+export type DataGridTable<TData extends object> = ReactTable<DataGridFeatures, TData>;
+export type DataGridCoreTable<TData extends object> = Table<DataGridFeatures, TData>;
+export type DataGridColumn<TData extends object, TValue = unknown> = Column<DataGridFeatures, TData, TValue>;
+export type DataGridColumnDef<TData extends object, TValue = unknown> = ColumnDef<DataGridFeatures, TData, TValue>;
+export type DataGridRow<TData extends object> = Row<DataGridFeatures, TData>;
+export type DataGridCell<TData extends object, TValue = unknown> = Cell<DataGridFeatures, TData, TValue>;
+export type DataGridHeader<TData extends object, TValue = unknown> = Header<DataGridFeatures, TData, TValue>;
+export type DataGridHeaderGroup<TData extends object> = HeaderGroup<DataGridFeatures, TData>;

package/dist/utils/data-grid-table.js

@@ -0,0 +1,17 @@
+import { aggregationFns, createFacetedRowModel, createFacetedUniqueValues, createFilteredRowModel, createSortedRowModel, filterFns, sortFns, stockFeatures, tableFeatures, } from "@tanstack/react-table";
+/**
+ * The full feature contract used by DataGrid. Sorting, filtering and facet
+ * counts are registered here, so every table can sort and filter by its
+ * column definitions alone; a table whose server sorts or filters sets
+ * `manualSorting` / `manualFiltering`. Pagination and expansion stay opt-in.
+ */
+export const dataGridFeatures = tableFeatures({
+    ...stockFeatures,
+    aggregationFns,
+    facetedRowModel: createFacetedRowModel(),
+    facetedUniqueValues: createFacetedUniqueValues(),
+    filterFns,
+    filteredRowModel: createFilteredRowModel(),
+    sortFns,
+    sortedRowModel: createSortedRowModel(),
+});

package/dist/utils/dev-issue.d.ts

@@ -0,0 +1,2 @@
+/** Report a consumer mistake in a local dev browser without throwing. */
+export declare const reportDevIssue: (message: string) => void;

package/dist/utils/dev-issue.js

@@ -0,0 +1,8 @@
+import { isLocalDevBrowser } from "../tokens/responsive.js";
+/** Report a consumer mistake in a local dev browser without throwing. */
+export const reportDevIssue = (message) => {
+    if (!isLocalDevBrowser()) {
+        return;
+    }
+    reportError(new Error(message));
+};

package/dist/utils/has-child-nodes.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+/**
+ * True when `children` holds at least one node. Mirrors `Children.count(c) > 0`
+ * without introspecting through `React.Children`: `null`/`undefined` and
+ * (nested) empty arrays are empty; anything else, including `false` and `""`,
+ * is a node.
+ */
+export declare const hasChildNodes: (children: ReactNode) => boolean;

package/dist/utils/has-child-nodes.js

@@ -0,0 +1,15 @@
+/**
+ * True when `children` holds at least one node. Mirrors `Children.count(c) > 0`
+ * without introspecting through `React.Children`: `null`/`undefined` and
+ * (nested) empty arrays are empty; anything else, including `false` and `""`,
+ * is a node.
+ */
+export const hasChildNodes = (children) => {
+    if (children === null || children === undefined) {
+        return false;
+    }
+    if (Array.isArray(children)) {
+        return children.some((child) => Array.isArray(child) ? hasChildNodes(child) : true);
+    }
+    return true;
+};

package/dist/utils/is-development-browser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Restrict noisy development-only UI warnings to local browser sessions.
+ *
+ * Shared UI packages use this helper as a lightweight browser-side signal to
+ * avoid surfacing accessibility warnings to end users in deployed environments.
+ */
+export declare const isDevelopmentBrowser: () => boolean;

package/dist/utils/is-development-browser.js

@@ -0,0 +1,16 @@
+const LOCAL_HOSTNAMES = new Set(["127.0.0.1", "::1", "0.0.0.0", "localhost"]);
+/**
+ * Restrict noisy development-only UI warnings to local browser sessions.
+ *
+ * Shared UI packages use this helper as a lightweight browser-side signal to
+ * avoid surfacing accessibility warnings to end users in deployed environments.
+ */
+export const isDevelopmentBrowser = () => {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    const { hostname, protocol } = window.location;
+    return (protocol === "file:" ||
+        LOCAL_HOSTNAMES.has(hostname) ||
+        hostname.endsWith(".local"));
+};

package/dist/utils/keyboard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Keyboard shortcut parsing utilities.
+ *
+ * Converts shortcut strings like "cmd+k" or "ctrl+shift+p" into display-ready
+ * arrays with proper symbols. Inlined into @instruments/materia-ui (was @materia/utils) so
+ * the package is self-contained - only `parseShortcut` is consumed here.
+ */
+/**
+ * Parses a keyboard shortcut string into an array of display-ready key symbols.
+ *
+ * @example
+ * ```ts
+ * parseShortcut("cmd+k") // ["⌘", "K"]
+ * parseShortcut("ctrl+shift+p") // ["Ctrl", "⇧", "P"]
+ * ```
+ */
+export declare const parseShortcut: (shortcut: string) => string[];