@beautinique/frontend-components 1.0.7 → 1.0.9

package/dist/file-input/media-type.d.ts

@@ -0,0 +1,8 @@
+import type { TMediaResource } from '../media/index.js';
+/**
+ * Whether a file or an address is a picture or a video. A file says it with its type (`video/mp4`);
+ * an address says it with its ending (`.mp4`, also before a `?` or a `#`). What is not known is a
+ * picture, so a preview is always drawn.
+ */
+export declare const getMediaType: (value: File | string) => TMediaResource;
+//# sourceMappingURL=media-type.d.ts.map

package/dist/file-input/media-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type.d.ts","sourceRoot":"","sources":["../../src/file-input/media-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAexD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,IAAI,GAAG,MAAM,KAAG,cAOnD,CAAC"}

package/dist/file-input/useObjectUrls.d.cts

@@ -0,0 +1,10 @@
+/**
+ * An address the browser can show for each file (`URL.createObjectURL`), made once for a file, and
+ * given back (`URL.revokeObjectURL`) when the file is no longer in the list and when the component
+ * goes away, so the memory of a file is not kept after it is not needed.
+ *
+ * The addresses are made after the render (it is an effect: making them is a change in the browser),
+ * so a file that was just added has none for one render; look for it with `urls.get(file)`.
+ */
+export declare const useObjectUrls: (files: readonly File[]) => ReadonlyMap<File, string>;
+//# sourceMappingURL=useObjectUrls.d.cts.map

package/dist/file-input/useObjectUrls.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectUrls.d.cts","sourceRoot":"","sources":["../../src/file-input/useObjectUrls.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,IAAI,EAAE,KAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAoC9E,CAAC"}

package/dist/file-input/useObjectUrls.d.ts

@@ -0,0 +1,10 @@
+/**
+ * An address the browser can show for each file (`URL.createObjectURL`), made once for a file, and
+ * given back (`URL.revokeObjectURL`) when the file is no longer in the list and when the component
+ * goes away, so the memory of a file is not kept after it is not needed.
+ *
+ * The addresses are made after the render (it is an effect: making them is a change in the browser),
+ * so a file that was just added has none for one render; look for it with `urls.get(file)`.
+ */
+export declare const useObjectUrls: (files: readonly File[]) => ReadonlyMap<File, string>;
+//# sourceMappingURL=useObjectUrls.d.ts.map

package/dist/file-input/useObjectUrls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectUrls.d.ts","sourceRoot":"","sources":["../../src/file-input/useObjectUrls.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,IAAI,EAAE,KAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAoC9E,CAAC"}

package/dist/hierarchy-select/HierarchySelect.d.cts

@@ -0,0 +1,58 @@
+import { type InputHTMLAttributes } from 'react';
+import { type IFieldBase, type ISelectOption, type ISelectProps, type TInputIcons } from '../inputs/index.js';
+import { type TDropdownPlacement } from '../lib/dropdown-position.js';
+export interface IHierarchySelectOption extends ISelectOption {
+    /**
+     * The options under this one. An option that has some is a branch: it opens and closes, and it is
+     * not chosen itself; only the options without children are.
+     */
+    children?: readonly IHierarchySelectOption[];
+}
+/** The words the field says to assistive technology and on the screen. English by default. */
+export interface IHierarchySelectLabels {
+    /** The name of the list when the field has no `label`. */
+    tree: string;
+    /** The name of the field where the person searches. */
+    search: string;
+    /** What the search field says while it is empty. */
+    searchPlaceholder: string;
+    /** The button that empties the search. */
+    clearSearch: string;
+    noResultsTitle: string;
+    noResultsDescription: string;
+    /** Said when a search changes how many options there are. */
+    results: (count: number) => string;
+}
+export interface IHierarchySelect extends IFieldBase {
+    selectProps: ISelectProps;
+    options: readonly IHierarchySelectOption[];
+    /** An icon at each end of the field. One with an `onClick` is a button and needs a `label`. */
+    icons?: TInputIcons;
+    /** Classes for the box that opens (the search and the options). */
+    optionsClassName?: string;
+    /** Which side of the field it opens on, unless there is no room there. @default 'bottom' */
+    position?: TDropdownPlacement;
+    /**
+     * Attributes of the search field. With a `value` that is text the search is the app's: it shows
+     * that text and says in `onChange` what the person typed (to search on a server, for example).
+     */
+    inputProps?: InputHTMLAttributes<HTMLInputElement>;
+    labels?: Partial<IHierarchySelectLabels>;
+}
+/**
+ * A field that opens a tree of options (categories with sub-categories) with a search field above
+ * it. Only an option without children can be chosen; the ones with children open and close.
+ *
+ * - The field is a button that opens a box with a search field and the tree. The focus goes to the
+ *   search field and stays there: the arrow keys move through the tree (assistive technology is told
+ *   which option is the active one), Right and Left open and close a branch or go to its first
+ *   option and to its parent, Enter chooses (or opens/closes a branch), Escape closes it and gives
+ *   the focus back to the field, and Tab closes it too.
+ * - A search shows the options that match and the branches that lead to them, all open. An option
+ *   that matches keeps what is under it.
+ * - The box is drawn in `document.body`, so a parent that scrolls or hides what overflows does not
+ *   cut it; it opens on the other side when there is no room, and follows the field while the page
+ *   scrolls.
+ */
+export declare const HierarchySelect: ({ label, className, error, containerClassName, optionsClassName, icons, selectProps, options, position, inputProps, labels, }: IHierarchySelect) => import("react").JSX.Element;
+//# sourceMappingURL=HierarchySelect.d.cts.map

package/dist/hierarchy-select/HierarchySelect.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySelect.d.cts","sourceRoot":"","sources":["../../src/hierarchy-select/HierarchySelect.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EAOzB,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAexF,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC9C;AAED,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,WAAW,EAAE,YAAY,CAAC;IAC1B,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,+FAA+F;IAC/F,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC1C;AAiBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,+HAY7B,gBAAgB,gCAuZlB,CAAC"}

package/dist/hierarchy-select/HierarchySelect.d.ts

@@ -0,0 +1,58 @@
+import { type InputHTMLAttributes } from 'react';
+import { type IFieldBase, type ISelectOption, type ISelectProps, type TInputIcons } from '../inputs/index.js';
+import { type TDropdownPlacement } from '../lib/dropdown-position.js';
+export interface IHierarchySelectOption extends ISelectOption {
+    /**
+     * The options under this one. An option that has some is a branch: it opens and closes, and it is
+     * not chosen itself; only the options without children are.
+     */
+    children?: readonly IHierarchySelectOption[];
+}
+/** The words the field says to assistive technology and on the screen. English by default. */
+export interface IHierarchySelectLabels {
+    /** The name of the list when the field has no `label`. */
+    tree: string;
+    /** The name of the field where the person searches. */
+    search: string;
+    /** What the search field says while it is empty. */
+    searchPlaceholder: string;
+    /** The button that empties the search. */
+    clearSearch: string;
+    noResultsTitle: string;
+    noResultsDescription: string;
+    /** Said when a search changes how many options there are. */
+    results: (count: number) => string;
+}
+export interface IHierarchySelect extends IFieldBase {
+    selectProps: ISelectProps;
+    options: readonly IHierarchySelectOption[];
+    /** An icon at each end of the field. One with an `onClick` is a button and needs a `label`. */
+    icons?: TInputIcons;
+    /** Classes for the box that opens (the search and the options). */
+    optionsClassName?: string;
+    /** Which side of the field it opens on, unless there is no room there. @default 'bottom' */
+    position?: TDropdownPlacement;
+    /**
+     * Attributes of the search field. With a `value` that is text the search is the app's: it shows
+     * that text and says in `onChange` what the person typed (to search on a server, for example).
+     */
+    inputProps?: InputHTMLAttributes<HTMLInputElement>;
+    labels?: Partial<IHierarchySelectLabels>;
+}
+/**
+ * A field that opens a tree of options (categories with sub-categories) with a search field above
+ * it. Only an option without children can be chosen; the ones with children open and close.
+ *
+ * - The field is a button that opens a box with a search field and the tree. The focus goes to the
+ *   search field and stays there: the arrow keys move through the tree (assistive technology is told
+ *   which option is the active one), Right and Left open and close a branch or go to its first
+ *   option and to its parent, Enter chooses (or opens/closes a branch), Escape closes it and gives
+ *   the focus back to the field, and Tab closes it too.
+ * - A search shows the options that match and the branches that lead to them, all open. An option
+ *   that matches keeps what is under it.
+ * - The box is drawn in `document.body`, so a parent that scrolls or hides what overflows does not
+ *   cut it; it opens on the other side when there is no room, and follows the field while the page
+ *   scrolls.
+ */
+export declare const HierarchySelect: ({ label, className, error, containerClassName, optionsClassName, icons, selectProps, options, position, inputProps, labels, }: IHierarchySelect) => import("react").JSX.Element;
+//# sourceMappingURL=HierarchySelect.d.ts.map

package/dist/hierarchy-select/HierarchySelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySelect.d.ts","sourceRoot":"","sources":["../../src/hierarchy-select/HierarchySelect.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EAOzB,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAexF,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC9C;AAED,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,WAAW,EAAE,YAAY,CAAC;IAC1B,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,+FAA+F;IAC/F,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC1C;AAiBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,+HAY7B,gBAAgB,gCAuZlB,CAAC"}

package/dist/hierarchy-select/hierarchy-select-icons.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Registers the icons above with Iconify; the components of this entry call it when they render
+ * (calling it again is harmless).
+ */
+export declare const registerHierarchySelectIcons: () => void, HIERARCHY_SELECT_ICON_NAMES: string[];
+//# sourceMappingURL=hierarchy-select-icons.d.cts.map

package/dist/hierarchy-select/hierarchy-select-icons.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-select-icons.d.cts","sourceRoot":"","sources":["../../src/hierarchy-select/hierarchy-select-icons.ts"],"names":[],"mappings":"AAqDA;;;GAGG;AACH,eAAO,MAAkB,4BAA4B,cAAS,2BAA2B,UAC1D,CAAC"}

package/dist/hierarchy-select/hierarchy-select-icons.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Registers the icons above with Iconify; the components of this entry call it when they render
+ * (calling it again is harmless).
+ */
+export declare const registerHierarchySelectIcons: () => void, HIERARCHY_SELECT_ICON_NAMES: string[];
+//# sourceMappingURL=hierarchy-select-icons.d.ts.map

package/dist/hierarchy-select/hierarchy-select-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-select-icons.d.ts","sourceRoot":"","sources":["../../src/hierarchy-select/hierarchy-select-icons.ts"],"names":[],"mappings":"AAqDA;;;GAGG;AACH,eAAO,MAAkB,4BAA4B,cAAS,2BAA2B,UAC1D,CAAC"}