@abyss-project/commons-front-core 16.0.0 → 16.1.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog — @abyss-project/commons-front-core
 
+## 16.1.0
+
+Additions only (card #227, lot D2, ADR-0248). No export removed, no signature changed.
+
+### Motion
+
+- `motion.enter` / `motion.exit`, `Appear`, `AppearList` (props `enter`, `exit`, `itemSx`) and `useAddedKeys` (`src/motion/README.md`): items added after the first render fade in with a 4 px rise, removed ones fade out; nothing is animated at the first render. The animation sits on a wrapper, so an inline `transform` (dnd-kit) is kept.
+- `transitionOf` is exported.
+- `DataTable` gains `animateAdded`.
+
+### Reduced motion, global
+
+- `createAbyssTheme(mode, { reducedMotion })` (and the legacy `createAbyssTheme(mode, { reducedMotion })`) sets every duration of the theme to 0. `AbyssThemeProvider` follows `prefers-reduced-motion: reduce`; `DesignCssVariables` writes the rule that sets `--abyss-duration-*` to `0ms`. Visible effect on every front that takes this version: no motion when the system asks for reduced motion. A legacy host has to read `REDUCED_MOTION_QUERY` and pass the option.
+
+### File drop
+
+- `useFileDropTarget` (reacts only to a drag that carries files, the innermost target wins) and `DropTargetOverlay` (README), label `ds.inputs.drop-target.label`.
+- `MarkdownEditor` takes a `ref`: `MarkdownEditorHandle.appendFiles(files)` adds files at the end of the document.
+
 ## 16.0.0
 
 ### Feedback intake moves from Console to Workspace (P4a, D25)

package/dist/{CookieConsentSettings-B7NfjgaI.js → CookieConsentSettings-DM0P2po1.js}

@@ -3,7 +3,7 @@ import { useState as y, useCallback as p, useEffect as T, useId as h, useRef as
 import I from "@mui/material/Button";
 import H from "@mui/material/Switch";
 import { styled as d } from "@mui/material/styles";
-import { p as o, h as ee, d as D, D as O, a as $, t as V, u as A, S as Y, M as te, b as ne } from "./Surface-BEhoEhyC.js";
+import { p as o, h as ee, d as D, D as O, a as $, t as V, u as A, S as Y, M as te, b as ne } from "./Surface-DW78GtlG.js";
 import { useQuery as ie, useMutation as oe } from "@tanstack/react-query";
 import { AbyssCore as W } from "@abyss-project/main";
 import se from "@mui/material/Link";

package/dist/{Surface-BEhoEhyC.js → Surface-DW78GtlG.js}

@@ -2131,6 +2131,9 @@ const xe = {
         "too-many": "Déposez un seul fichier à la fois.",
         "rejected-type": "Ce type de fichier n’est pas accepté ici."
       },
+      "drop-target": {
+        label: "Déposez pour ajouter à {target}"
+      },
       "import-button": {
         file: "Mon ordinateur",
         url: "Lien URL",
@@ -4322,6 +4325,9 @@ const xe = {
         "too-many": "Drop a single file at a time.",
         "rejected-type": "This file type is not accepted here."
       },
+      "drop-target": {
+        label: "Drop to add to {target}"
+      },
       "import-button": {
         file: "My computer",
         url: "URL link",

package/dist/{Tabs-DJ9_ZFjM.js → Tabs-DGh_2Lgc.js}

@@ -8,7 +8,7 @@ import mn from "@mui/material/Select";
 import { styled as d, useTheme as hn, getContrastRatio as Ce } from "@mui/material/styles";
 import { visuallyHidden as bn } from "@mui/utils";
 import { useIntl as L } from "react-intl";
-import { a as R, p as o, h as A, d as Z, D as K, c as yn, t as $e, s as de, e as oe, g as te, M as De, b as Pe, i as vn, B as wn } from "./Surface-BEhoEhyC.js";
+import { a as R, p as o, h as A, d as Z, D as K, c as yn, t as $e, s as de, e as oe, g as te, M as De, b as Pe, i as vn, B as wn } from "./Surface-DW78GtlG.js";
 import { i as xn, b as Cn, r as kn, u as Sn, A as In, E as Fn } from "./index-C27b790L.js";
 import X from "@mui/material/Button";
 import { byteSizeIEC as Mn } from "@abyss-project/main";

package/dist/components/data/DataTable/DataTableDesktop.d.ts

@@ -3,4 +3,4 @@ import { DataTableProps } from './data-table.types';
  * The table form of `DataTable`, from 768 px up. From 768 to 1199 px (next to the icon rail) the
  * `Optional` columns are hidden.
  */
-export declare function DataTableDesktop<T>({ columns: allColumns, rows, getRowId, density, selection, sort, onRowClick, loading, empty, label, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataTableDesktop<T>({ columns: allColumns, rows, getRowId, density, selection, sort, onRowClick, loading, empty, label, animateAdded, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/data/DataTable/DataTableMobile.d.ts

@@ -3,4 +3,4 @@ import { DataTableProps } from './data-table.types';
  * The two-level list form of `DataTable` below 768 px (`.mli`): the selection stays, and the bulk
  * actions move into an `ActionBar` at the bottom of the screen.
  */
-export declare function DataTableMobile<T>({ rows, getRowId, selection, onRowClick, loading, empty, mobileRow, label, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataTableMobile<T>({ rows, getRowId, selection, onRowClick, loading, empty, mobileRow, label, animateAdded, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/data/DataTable/data-table.types.d.ts

@@ -85,4 +85,9 @@ export interface DataTableProps<T> {
      * « Lignes ».
      */
     label?: string;
+    /**
+     * Rows added while the table is on screen fade in and rise 4 px (`motion.enter`); the rows of
+     * the first render never do. Off by default.
+     */
+    animateAdded?: boolean;
 }

package/dist/components/editors/MarkdownEditor/MarkdownEditor.d.ts

@@ -12,8 +12,29 @@ export type MarkdownEditorProps = {
     enableImageUpload?: boolean;
     enableFileUpload?: boolean;
 } & CrepeConfig;
+/** What a host drives from outside the editor. */
+export type MarkdownEditorHandle = {
+    /**
+     * Uploads the files by `onUploadFile`, one after the other, and appends each as its own block at
+     * the end of the document (`![name](url)` for an image, `[name](url)` otherwise). A file whose
+     * upload fails is left out: the host's handler reports it. Does nothing when the editor is
+     * read-only, lacks `enableFileUpload` or `onUploadFile`, or is not ready yet.
+     */
+    appendFiles: (files: File[]) => Promise<void>;
+};
 /**
  * Markdown editor of the design system: Milkdown Crepe, themed from `theme.design`, with its
  * labels translated by the core. The same rendering serves reading (`readOnly`) and editing.
  */
-export declare const MarkdownEditor: React.FC<MarkdownEditorProps>;
+export declare const MarkdownEditor: React.ForwardRefExoticComponent<{
+    placeholder?: string;
+    defaultValue?: string;
+    /** For external updates (SSE): replaces the document without triggering `onChange`. */
+    externalValue?: string;
+    onChange?: (md: string) => void;
+    readOnly?: boolean;
+    /** Uploads a file and returns its URL. */
+    onUploadFile?: (file: File) => Promise<string>;
+    enableImageUpload?: boolean;
+    enableFileUpload?: boolean;
+} & CrepeConfig & React.RefAttributes<MarkdownEditorHandle>>;

package/dist/components/editors/MarkdownEditor/index.d.ts

@@ -1,2 +1,2 @@
 export { MarkdownEditor } from './MarkdownEditor';
-export type { MarkdownEditorProps } from './MarkdownEditor';
+export type { MarkdownEditorHandle, MarkdownEditorProps, } from './MarkdownEditor';

package/dist/components/inputs/DropTargetOverlay/DropTargetOverlay.d.ts

@@ -0,0 +1,12 @@
+export interface DropTargetOverlayProps {
+    /** Shown while a file is over the target (`isFileOver` of `useFileDropTarget`). */
+    visible: boolean;
+    /** What receives the files, in the label: « Déposez pour ajouter à {target} ». */
+    target: string;
+}
+/**
+ * The cue of a drop target: a dashed accent frame over its parent, with « Déposez pour ajouter à
+ * {target} ». The parent must be `position: relative`. It lets every pointer event through
+ * (`pointer-events: none`) and appears with `Appear`. Pair it with `useFileDropTarget`.
+ */
+export declare function DropTargetOverlay({ visible, target, }: DropTargetOverlayProps): JSX.Element;

package/dist/components/inputs/DropTargetOverlay/DropTargetOverlay.spec.d.ts

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

package/dist/components/inputs/index.d.ts

@@ -10,6 +10,7 @@ export * from './SettingsRow/SettingsRow';
 export * from './CopyField/CopyField';
 export * from './ContextSelector/ContextSelector';
 export * from './DropZone/DropZone';
+export * from './DropTargetOverlay/DropTargetOverlay';
 export * from './ImportButton/ImportButton';
 export * from './UserPicker/UserPicker';
 export * from './CompanySearchField/CompanySearchField';

package/dist/cookie-consent.js

@@ -1,5 +1,5 @@
-import { A as e, d as a, C as n, b as C, D as i, R as t, V as r, e as A, r as k, f as c, u as l, c as f, a as b, w as u } from "./CookieConsentSettings-B7NfjgaI.js";
-import { f as E } from "./Surface-BEhoEhyC.js";
+import { A as e, d as a, C as n, b as C, D as i, R as t, V as r, e as A, r as k, f as c, u as l, c as f, a as b, w as u } from "./CookieConsentSettings-DM0P2po1.js";
+import { f as E } from "./Surface-DW78GtlG.js";
 export {
   e as AbyssCookieConsentProvider,
   a as COOKIE_NAME,