@proyecto-viviana/solid-stately 0.2.2 → 0.2.3

package/src/collections/types.ts

@@ -0,0 +1,169 @@
+/**
+ * Core types for collection state management.
+ * Simplified from @react-stately/collections for SolidJS.
+ */
+
+import type { JSX } from 'solid-js';
+
+/** A unique identifier for an item in a collection. */
+export type Key = string | number;
+
+/** The type of selection allowed in a collection. */
+export type SelectionMode = 'none' | 'single' | 'multiple';
+
+/** How selection behaves when clicking on items. */
+export type SelectionBehavior = 'toggle' | 'replace';
+
+/** Represents the current selection state. */
+export type Selection = 'all' | Set<Key>;
+
+/** Strategy for focusing first or last item. */
+export type FocusStrategy = 'first' | 'last';
+
+/** Whether disabled keys affect selection, actions, or both. */
+export type DisabledBehavior = 'selection' | 'all';
+
+/**
+ * Represents a node in a collection (item or section).
+ */
+export interface CollectionNode<T = unknown> {
+  /** The type of node: 'item' or 'section'. */
+  type: 'item' | 'section';
+  /** A unique key for the node. */
+  key: Key;
+  /** The original value/data for this node. */
+  value: T | null;
+  /** The text content for accessibility and typeahead. */
+  textValue: string;
+  /** The rendered content (JSX). */
+  rendered: JSX.Element;
+  /** The level of nesting (0 for top-level). */
+  level: number;
+  /** The index within the parent. */
+  index: number;
+  /** The key of the parent node, if any. */
+  parentKey: Key | null;
+  /** Whether this node has child nodes. */
+  hasChildNodes: boolean;
+  /** Child nodes, if any. */
+  childNodes: CollectionNode<T>[];
+  /** Whether this item is disabled. */
+  isDisabled?: boolean;
+  /** ARIA label for this node. */
+  'aria-label'?: string;
+  /** Additional props for the node. */
+  props?: Record<string, unknown>;
+}
+
+/**
+ * A collection of nodes with methods to traverse and query.
+ */
+export interface Collection<T = unknown> extends Iterable<CollectionNode<T>> {
+  /** The number of items in the collection. */
+  readonly size: number;
+
+  /** Get all keys in the collection. */
+  getKeys(): Iterable<Key>;
+
+  /** Get a node by its key. */
+  getItem(key: Key): CollectionNode<T> | null;
+
+  /** Get a node by index. */
+  at(index: number): CollectionNode<T> | null;
+
+  /** Get the key before the given key. */
+  getKeyBefore(key: Key): Key | null;
+
+  /** Get the key after the given key. */
+  getKeyAfter(key: Key): Key | null;
+
+  /** Get the first key in the collection. */
+  getFirstKey(): Key | null;
+
+  /** Get the last key in the collection. */
+  getLastKey(): Key | null;
+
+  /** Get the children of a node. */
+  getChildren(key: Key): Iterable<CollectionNode<T>>;
+
+  /** Get the text value for a key. */
+  getTextValue(key: Key): string;
+}
+
+/**
+ * Props for items in a collection.
+ */
+export interface ItemProps<T = unknown> {
+  /** Unique key for the item. Required if items is used for dynamic collections. */
+  key?: Key;
+  /** The text value for accessibility and typeahead. If not provided, derived from children. */
+  textValue?: string;
+  /** Whether the item is disabled. */
+  isDisabled?: boolean;
+  /** The rendered content of the item. */
+  children?: JSX.Element;
+  /** ARIA label for the item. */
+  'aria-label'?: string;
+  /** The original value for dynamic collections. */
+  value?: T;
+}
+
+/**
+ * Props for sections in a collection.
+ */
+export interface SectionProps<T = unknown> {
+  /** Unique key for the section. */
+  key?: Key;
+  /** The section header/title. */
+  title?: JSX.Element;
+  /** ARIA label for the section. */
+  'aria-label'?: string;
+  /** The items in this section. */
+  children?: JSX.Element;
+  /** Items for dynamic rendering. */
+  items?: Iterable<T>;
+}
+
+/**
+ * Base props for components that use collections.
+ */
+export interface CollectionBase<T = unknown> {
+  /** The items in the collection (for dynamic rendering). */
+  items?: Iterable<T>;
+  /** The children (static items or render function). */
+  children?: JSX.Element | ((item: T) => JSX.Element);
+  /** Keys of disabled items. */
+  disabledKeys?: Iterable<Key>;
+}
+
+/**
+ * Props for single selection.
+ */
+export interface SingleSelection {
+  /** Whether empty selection is allowed. */
+  disallowEmptySelection?: boolean;
+  /** The currently selected key (controlled). */
+  selectedKey?: Key | null;
+  /** The default selected key (uncontrolled). */
+  defaultSelectedKey?: Key;
+  /** Handler called when selection changes. */
+  onSelectionChange?: (key: Key | null) => void;
+}
+
+/**
+ * Props for multiple selection.
+ */
+export interface MultipleSelection {
+  /** The selection mode. */
+  selectionMode?: SelectionMode;
+  /** Whether empty selection is allowed. */
+  disallowEmptySelection?: boolean;
+  /** The currently selected keys (controlled). */
+  selectedKeys?: 'all' | Iterable<Key>;
+  /** The default selected keys (uncontrolled). */
+  defaultSelectedKeys?: 'all' | Iterable<Key>;
+  /** Handler called when selection changes. */
+  onSelectionChange?: (keys: Selection) => void;
+  /** Keys of disabled items. */
+  disabledKeys?: Iterable<Key>;
+}

package/src/color/Color.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Color class implementation.
+ * Based on @react-stately/color.
+ *
+ * Provides color manipulation, conversion, and formatting.
+ */
+import type { Color } from './types';
+/**
+ * Parse a color string into a Color object.
+ */
+export declare function parseColor(value: string): Color;
+/**
+ * Create an RGB color.
+ */
+export declare function createRGBColor(red: number, green: number, blue: number, alpha?: number): Color;
+/**
+ * Create an HSL color.
+ */
+export declare function createHSLColor(hue: number, saturation: number, lightness: number, alpha?: number): Color;
+/**
+ * Create an HSB color.
+ */
+export declare function createHSBColor(hue: number, saturation: number, brightness: number, alpha?: number): Color;
+/**
+ * Normalize a color value (string or Color) to a Color object.
+ */
+export declare function normalizeColor(value: string | Color): Color;
+//# sourceMappingURL=Color.d.ts.map

package/src/color/Color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["Color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EASN,MAAM,SAAS,CAAC;AAi0BjB;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAkE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,CAEjG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,CAE3G;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,CAE5G;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAK3D"}