@design-factory/angular 21.0.3 → 21.1.0-next.0

package/node_modules/@agnos-ui/core/components/tree/tree.d.ts

@@ -0,0 +1,143 @@
+import type { Directive, WidgetFactory } from '../../types';
+import { type Widget } from '../../types';
+import type { WidgetsCommonPropsAndState } from '../commonProps';
+/**
+ * Represents a tree item component.
+ */
+export interface TreeItem {
+    /**
+     * Optional accessibility label for the node
+     */
+    ariaLabel?: string;
+    /**
+     * Optional array of children nodes
+     */
+    children?: TreeItem[];
+    /**
+     * If `true` the node is expanded
+     */
+    isExpanded?: boolean;
+    /**
+     * String title of the node
+     */
+    label: string;
+}
+/**
+ * Normalized TreeItem object
+ */
+export interface NormalizedTreeItem extends TreeItem {
+    /**
+     * Accessibility label for the node
+     */
+    ariaLabel: string;
+    /**
+     * Level in the hierarchy, starts with 0 for a root node
+     */
+    level: number;
+    /**
+     * An array of children nodes
+     */
+    children: NormalizedTreeItem[];
+}
+interface TreeCommonPropsAndState extends WidgetsCommonPropsAndState {
+}
+/**
+ * Interface representing the properties for the Tree component.
+ */
+export interface TreeProps extends TreeCommonPropsAndState {
+    /**
+     * Array of the tree nodes to display
+     *
+     * @defaultValue `[]`
+     */
+    nodes: TreeItem[];
+    /**
+     * An event emitted when the user toggles the expand of the TreeItem.
+     *
+     * Event payload is equal to the TreeItem clicked.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onExpandToggle: (node: NormalizedTreeItem) => void;
+    /**
+     * Retrieves expand items of the TreeItem
+     *
+     * @param node - HTML element that is representing the expand item
+     *
+     * @defaultValue
+     * ```ts
+     * (node: HTMLElement) => node.querySelectorAll('button')
+     * ```
+     */
+    navSelector(node: HTMLElement): NodeListOf<HTMLElement>;
+    /**
+     * Return the value for the 'aria-label' attribute of the toggle
+     * @param label - tree item label
+     *
+     * @defaultValue
+     * ```ts
+     * (label: string) => `Toggle ${label}`
+     * ```
+     */
+    ariaLabelToggleFn: (label: string) => string;
+}
+/**
+ * Represents the state of a Tree component.
+ */
+export interface TreeState extends TreeCommonPropsAndState {
+    /**
+     * Array of normalized tree nodes
+     */
+    normalizedNodes: NormalizedTreeItem[];
+    /**
+     * Getter of expanded state for each tree node
+     */
+    expandedMap: {
+        get(item: NormalizedTreeItem): boolean | undefined;
+    };
+}
+/**
+ * Interface representing the API for a Tree component.
+ */
+export interface TreeApi {
+}
+/**
+ * Interface representing various directives used in the Tree component.
+ */
+export interface TreeDirectives {
+    /**
+     * Directive to attach navManager for the tree
+     */
+    navigationDirective: Directive;
+    /**
+     * Directive to handle toggle for the tree item
+     */
+    itemToggleDirective: Directive<{
+        item: NormalizedTreeItem;
+    }>;
+    /**
+     * Directive to handle attributes for the tree item
+     */
+    itemAttributesDirective: Directive<{
+        item: NormalizedTreeItem;
+    }>;
+}
+/**
+ * Represents a Tree widget component.
+ */
+export type TreeWidget = Widget<TreeProps, TreeState, TreeApi, TreeDirectives>;
+/**
+ * Retrieve a shallow copy of the default Tree config
+ * @returns the default Tree config
+ */
+export declare function getTreeDefaultConfig(): TreeProps;
+/**
+ * Create a tree widget with given config props
+ * @param config - an optional tree config
+ * @returns a TreeWidget
+ */
+export declare const createTree: WidgetFactory<TreeWidget>;
+export {};

package/node_modules/@agnos-ui/core/config.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const tansu = require("@amadeus-it-group/tansu");
+const utils_func = require("./utils/func.cjs");
+const mergeInto = (destination, source, levels = Infinity) => {
+  if (source !== void 0) {
+    if (typeof source === "object" && source && levels >= 1) {
+      if (!destination) {
+        destination = {};
+      }
+      for (const key of Object.keys(source)) {
+        if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+        if (key === "__proto__" || key === "constructor") continue;
+        destination[key] = mergeInto(destination[key], source[key], levels - 1);
+      }
+    } else {
+      return source;
+    }
+  }
+  return destination;
+};
+const createWidgetsConfig = (parent$, adaptParentConfig = utils_func.identity) => {
+  const own$ = tansu.writable({});
+  const adaptedParent$ = adaptParentConfig === utils_func.identity ? parent$ : tansu.computed(() => adaptParentConfig(mergeInto({}, parent$?.(), 2)));
+  return tansu.asWritable(
+    tansu.computed(() => mergeInto(mergeInto({}, adaptedParent$?.(), 2), own$(), 2)),
+    {
+      ...own$,
+      own$,
+      adaptedParent$,
+      parent$
+    }
+  );
+};
+exports.createWidgetsConfig = createWidgetsConfig;
+exports.mergeInto = mergeInto;

package/node_modules/@agnos-ui/core/config.d.ts

@@ -0,0 +1,117 @@
+import type { ReadableSignal, WritableSignal } from '@amadeus-it-group/tansu';
+import type { ModalProps } from './components/modal/modal';
+import type { AlertProps } from './components/alert/alert';
+import type { PaginationProps } from './components/pagination/pagination';
+import type { RatingProps } from './components/rating/rating';
+import type { AccordionProps } from './components/accordion/accordion';
+import type { ProgressbarProps } from './components/progressbar/progressbar';
+import type { SliderProps } from './components/slider/slider';
+import type { ToastProps } from './components/toast/toast';
+import type { TreeProps } from './components/tree/tree';
+import type { CarouselProps } from './components/carousel';
+import type { CollapseProps } from './components/collapse';
+import type { DrawerProps } from './components/drawer/drawer';
+/**
+ * A utility type that makes all properties of an object type `T` optional,
+ * and also makes all properties of the nested objects within `T` optional.
+ *
+ * @template T - The object type to be transformed.
+ */
+export type Partial2Levels<T> = Partial<{
+    [Level1 in keyof T]: Partial<T[Level1]>;
+}>;
+/**
+ * Represents a store for widget configurations with support for partial updates
+ * at two levels of depth. This store includes signals for its own state, an optional
+ * parent state, and an optional adapted parent state.
+ *
+ * @template T - The type of the widget configuration.
+ */
+export type WidgetsConfigStore<T> = WritableSignal<Partial2Levels<T>> & {
+    own$: WritableSignal<Partial2Levels<T>>;
+    parent$: undefined | WritableSignal<Partial2Levels<T>>;
+    adaptedParent$: undefined | ReadableSignal<Partial2Levels<T>>;
+};
+/**
+ * Merges source object into destination object, up to the provided number of levels.
+ * @param destination - destination object
+ * @param source - source object
+ * @param levels - number of levels to merge
+ * @returns the destination object in most cases, or the source in some cases (if the source is not undefined and either levels is smaller than 1
+ * or the source is not an object)
+ */
+export declare const mergeInto: <T>(destination: T, source: T | undefined, levels?: number) => T;
+/**
+ * Creates a new widgets default configuration store, optionally inheriting from a parent store, and containing
+ * its own set of widgets configuration properties that override the same properties form the parent configuration.
+ *
+ * @remarks
+ * The resulting store has a value computed from the parent store in two steps:
+ * - first step: the parent configuration is transformed by the adaptParentConfig function (if specified).
+ * If adaptParentConfig is not specified, this step is skipped.
+ * - second step: the configuration from step 1 is merged (2-levels deep) with the own$ store. The own$ store initially contains
+ * an empty object (i.e. no property from the parent is overridden). It can be changed by calling set on the store returned by this function.
+ *
+ * @param parent$ - optional parent widgets default configuration store.
+ * @param adaptParentConfig - optional function that receives a 2-levels copy of the widgets default configuration
+ * from parent$ (or an empty object if parent$ is not specified) and returns the widgets default configuration to be used.
+ * It is called only if the configuration is needed, and was not yet computed for the current value of the parent configuration.
+ * It is called in a tansu reactive context, so it can use any tansu store and will be called again if those stores change.
+ * @returns the resulting widgets default configuration store, which contains 3 additional properties that are stores:
+ * parent$, adaptedParent$ (containing the value computed after the first step), and own$ (that contains only overridding properties).
+ * The resulting store is writable, its set function is actually the set function of the own$ store.
+ */
+export declare const createWidgetsConfig: <T>(parent$?: WidgetsConfigStore<T>, adaptParentConfig?: (config: Partial2Levels<T>) => Partial2Levels<T>) => WidgetsConfigStore<T>;
+/**
+ * Configuration for various widgets used in the application.
+ */
+export type WidgetsConfig = {
+    /**
+     * the pagination widget config
+     */
+    pagination: PaginationProps;
+    /**
+     * the rating widget config
+     */
+    rating: RatingProps;
+    /**
+     * the modal widget config
+     */
+    modal: ModalProps;
+    /**
+     * the alert widget config
+     */
+    alert: AlertProps;
+    /**
+     * the accordion widget config
+     */
+    accordion: AccordionProps;
+    /**
+     * the progress bar widget config
+     */
+    progressbar: ProgressbarProps;
+    /**
+     * slider widget config
+     */
+    slider: SliderProps;
+    /**
+     * toast widget config
+     */
+    toast: ToastProps;
+    /**
+     * tree widget config
+     */
+    tree: TreeProps;
+    /**
+     * carousel widget config
+     */
+    carousel: CarouselProps;
+    /**
+     * collapse widget config
+     */
+    collapse: CollapseProps;
+    /**
+     * drawer widget config
+     */
+    drawer: DrawerProps;
+};

package/node_modules/@agnos-ui/core/config.js

@@ -0,0 +1,36 @@
+import { writable, computed, asWritable } from "@amadeus-it-group/tansu";
+import { identity } from "./utils/func.js";
+const mergeInto = (destination, source, levels = Infinity) => {
+  if (source !== void 0) {
+    if (typeof source === "object" && source && levels >= 1) {
+      if (!destination) {
+        destination = {};
+      }
+      for (const key of Object.keys(source)) {
+        if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+        if (key === "__proto__" || key === "constructor") continue;
+        destination[key] = mergeInto(destination[key], source[key], levels - 1);
+      }
+    } else {
+      return source;
+    }
+  }
+  return destination;
+};
+const createWidgetsConfig = (parent$, adaptParentConfig = identity) => {
+  const own$ = writable({});
+  const adaptedParent$ = adaptParentConfig === identity ? parent$ : computed(() => adaptParentConfig(mergeInto({}, parent$?.(), 2)));
+  return asWritable(
+    computed(() => mergeInto(mergeInto({}, adaptedParent$?.(), 2), own$(), 2)),
+    {
+      ...own$,
+      own$,
+      adaptedParent$,
+      parent$
+    }
+  );
+};
+export {
+  createWidgetsConfig,
+  mergeInto
+};