@satellatickets/core 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -2,6 +2,36 @@
 import { $ as useFormFieldControl, A as LinkUnderline, B as textVariants, C as UIProviderProps, D as useLink, E as UseLinkResult, F as TextVariant, G as useButton, H as useControllableState, I as TextVariantStyle, J as FormFieldControlOptions, K as FormFieldContext, L as textAligns, M as TextAlign, N as TextColorToken, O as LinkPressEvent, P as TextProps, Q as resolveFormFieldControl, R as textColors, S as ThemeMode, T as UseLinkOptions, U as UseButtonOptions, V as UseControllableStateOptions, W as UseButtonResult, X as FormFieldValueOptions, Y as FormFieldValue, Z as createFormFieldValue, _ as useBrand, a as ToastStore, b as useUIContext, c as ToastApi, d as FeedbackTone, f as feedbackTones, g as createUIContextValue, h as UIContextValue, i as TOAST_MAX_VISIBLE, j as linkUnderlines, k as LinkProps, l as ToastItem, m as UIContext, n as useToast, o as createToastStore, p as isFeedbackTone, q as FormFieldControl, r as TOAST_DEFAULT_DURATION, s as ToastAction, t as ToastContext, u as ToastOptions, v as useColorScheme, w as themeModes, x as ColorScheme, y as useTheme, z as textVariantStyles } from "./client-DpHlKasm.js";
 import { BrandName, Theme, ThemeName, ThemeOverrides } from "@satellatickets/tokens";
 import { ReactNode } from "react";
+//#region src/select/navigation.d.ts
+/** Lo mínimo que hace falta saber de una opción para moverse entre ellas y buscarla. */
+export interface NavigableOption {
+  value: string;
+  label: string;
+  disabled?: boolean | undefined;
+}
+/** Hacia dónde mueve el resaltado una tecla: flechas, Inicio, Fin, AvPág y RePág. */
+export declare const optionDirections: readonly ["next", "previous", "first", "last", "nextPage", "previousPage"];
+export type OptionDirection = (typeof optionDirections)[number];
+/** Cuántas opciones salta AvPág o RePág. */
+export declare const OPTION_PAGE_SIZE = 10;
+/**
+ * La opción a la que lleva una tecla desde la actual, saltando las deshabilitadas. No da
+ * la vuelta: al llegar a un extremo se queda en él (ADR-042). Si no hay ninguna a la
+ * que ir, devuelve la actual.
+ */
+export declare function getOptionInDirection(options: readonly NavigableOption[], current: string | undefined, direction: OptionDirection): string | undefined;
+/**
+ * La opción habilitada cuyo texto empieza por lo que el usuario ha escrito, o `undefined`
+ * si no hay ninguna.
+ *
+ * - Una sola letra busca a partir de la siguiente a la actual, así que pulsarla varias
+ *   veces recorre las que empiezan por ella.
+ * - Un texto más largo se queda en la actual mientras siga coincidiendo.
+ * - La misma letra repetida ("bb") que no es el principio de ninguna opción vale como
+ *   pulsarla otra vez.
+ */
+export declare function findOptionByText(options: readonly NavigableOption[], text: string, current?: string): string | undefined;
+//#endregion
 //#region src/tabs/navigation.d.ts
 /** Lo mínimo que hace falta saber de una pestaña para moverse entre ellas. */
 export interface NavigableTab {
@@ -411,7 +441,7 @@ export interface SelectOption {
   label: string;
   disabled?: boolean | undefined;
 }
-/** Contrato de `Select`: elegir una opción de una lista (ADR-038). */
+/** Contrato de `Select`: elegir una opción de una lista (ADR-042). */
 export interface SelectProps {
   options: readonly SelectOption[];
   /** Opción elegida, controlada por la app. Sin ella, guarda su propio estado (ADR-037). */

package/dist/index.js

@@ -2,6 +2,68 @@
 import { n as resolveColorScheme, r as resolveTheme, t as mergeTheme } from "./resolve-theme-DbIlzBBD.js";
 import { themes } from "@satellatickets/tokens";
 export * from "./client.js";
+//#region src/select/navigation.ts
+/** Hacia dónde mueve el resaltado una tecla: flechas, Inicio, Fin, AvPág y RePág. */
+const optionDirections = [
+	"next",
+	"previous",
+	"first",
+	"last",
+	"nextPage",
+	"previousPage"
+];
+/** Cuántas opciones salta AvPág o RePág. */
+const OPTION_PAGE_SIZE = 10;
+const steps = {
+	next: 1,
+	previous: -1,
+	nextPage: 10,
+	previousPage: -10
+};
+/**
+* La opción a la que lleva una tecla desde la actual, saltando las deshabilitadas. No da
+* la vuelta: al llegar a un extremo se queda en él (ADR-042). Si no hay ninguna a la
+* que ir, devuelve la actual.
+*/
+function getOptionInDirection(options, current, direction) {
+	const enabled = options.filter((option) => option.disabled !== true).map(({ value }) => value);
+	const [first] = enabled;
+	const last = enabled[enabled.length - 1];
+	if (first === void 0 || last === void 0) return current;
+	if (direction === "first") return first;
+	if (direction === "last") return last;
+	const step = steps[direction];
+	const index = current === void 0 ? -1 : enabled.indexOf(current);
+	if (index === -1) return step > 0 ? first : last;
+	return enabled[Math.min(Math.max(index + step, 0), enabled.length - 1)] ?? current;
+}
+/** Sin mayúsculas ni acentos: al escribir "avila" se encuentra "Ávila". */
+function normalize(text) {
+	return text.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLocaleLowerCase();
+}
+/**
+* La opción habilitada cuyo texto empieza por lo que el usuario ha escrito, o `undefined`
+* si no hay ninguna.
+*
+* - Una sola letra busca a partir de la siguiente a la actual, así que pulsarla varias
+*   veces recorre las que empiezan por ella.
+* - Un texto más largo se queda en la actual mientras siga coincidiendo.
+* - La misma letra repetida ("bb") que no es el principio de ninguna opción vale como
+*   pulsarla otra vez.
+*/
+function findOptionByText(options, text, current) {
+	const query = normalize(text);
+	const [letter] = query;
+	if (letter === void 0) return void 0;
+	const enabled = options.filter((option) => option.disabled !== true);
+	const index = enabled.findIndex((option) => option.value === current);
+	const startingWith = (prefix, from) => [...enabled.slice(from), ...enabled.slice(0, from)].find((option) => normalize(option.label).startsWith(prefix))?.value;
+	if (query.length === 1) return startingWith(letter, index + 1);
+	const match = startingWith(query, Math.max(index, 0));
+	if (match !== void 0) return match;
+	return [...query].every((char) => char === letter) ? startingWith(letter, index + 1) : void 0;
+}
+//#endregion
 //#region src/tabs/navigation.ts
 /** Hacia dónde mueve el foco una tecla: flechas, Inicio y Fin. */
 const tabDirections = [
@@ -388,4 +450,4 @@ const themeModes = [
 	"system"
 ];
 //#endregion
-export { TOAST_DEFAULT_DURATION, TOAST_MAX_VISIBLE, backgroundTokens, badgeVariants, borderColorTokens, buttonIconSize, buttonVariants, cardVariants, controlSizes, createToastStore, dividerOrientations, feedbackTones, firstEnabledTab, getTabInDirection, iconButtonIconSize, iconSizePx, iconSizes, inputIconSize, inputTypes, isFeedbackTone, linkUnderlines, mergeTheme, modalPresentations, radiusTokens, resolveColorScheme, resolveTheme, shadowTokens, skeletonShapes, spaceTokens, spinnerSizePx, spinnerSizes, stackAligns, stackDirections, stackJustifies, tabDirections, textAligns, textColors, textVariantStyles, textVariants, themeModes };
+export { OPTION_PAGE_SIZE, TOAST_DEFAULT_DURATION, TOAST_MAX_VISIBLE, backgroundTokens, badgeVariants, borderColorTokens, buttonIconSize, buttonVariants, cardVariants, controlSizes, createToastStore, dividerOrientations, feedbackTones, findOptionByText, firstEnabledTab, getOptionInDirection, getTabInDirection, iconButtonIconSize, iconSizePx, iconSizes, inputIconSize, inputTypes, isFeedbackTone, linkUnderlines, mergeTheme, modalPresentations, optionDirections, radiusTokens, resolveColorScheme, resolveTheme, shadowTokens, skeletonShapes, spaceTokens, spinnerSizePx, spinnerSizes, stackAligns, stackDirections, stackJustifies, tabDirections, textAligns, textColors, textVariantStyles, textVariants, themeModes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satellatickets/core",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Lógica headless de satella-ui: contratos de props, constantes de variantes, contexto de tema y hooks compartidos por React y React Native",
   "license": "MIT",
   "repository": {
@@ -40,8 +40,8 @@
     "tsdown": "^0.23.0",
     "typescript": "^5.9.3",
     "vitest": "^5.0.3",
-    "@satellatickets/eslint-config": "0.0.0",
-    "@satellatickets/tsconfig": "0.0.0"
+    "@satellatickets/tsconfig": "0.0.0",
+    "@satellatickets/eslint-config": "0.0.0"
   },
   "scripts": {
     "build": "tsdown",