@abyss-project/commons-front-core 9.6.0 → 10.1.0

package/dist/components/editors/PdfEditor/toolbar/tool-options/ShapeOptions.d.ts

@@ -0,0 +1,6 @@
+import { PdfToolSettings } from '../tool-settings';
+export interface ShapeOptionsProps {
+    settings: PdfToolSettings;
+    onChange(patch: Partial<PdfToolSettings>): void;
+}
+export declare function ShapeOptions({ settings, onChange }: ShapeOptionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/editors/PdfEditor/toolbar/tool-options/SignatureOptions.d.ts

@@ -0,0 +1,5 @@
+export interface SignatureOptionsProps {
+    onOpenSignaturePicker(): void;
+}
+/** The picker itself belongs to the host: the panel only reaches it. */
+export declare function SignatureOptions({ onOpenSignaturePicker, }: SignatureOptionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/editors/PdfEditor/toolbar/tool-options/TextOptions.d.ts

@@ -0,0 +1,6 @@
+import { PdfToolSettings } from '../tool-settings';
+export interface TextOptionsProps {
+    settings: PdfToolSettings;
+    onChange(patch: Partial<PdfToolSettings>): void;
+}
+export declare function TextOptions({ settings, onChange }: TextOptionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/editors/PdfEditor/toolbar/tool-options/ToolOptions.d.ts

@@ -0,0 +1,14 @@
+import { Dispatch } from 'react';
+import { AcroFormField, EditorAction, PdfOperation, ToolKind } from '../../engine/types';
+import { PdfToolSettings } from '../tool-settings';
+export interface ToolOptionsProps {
+    tool: ToolKind;
+    settings: PdfToolSettings;
+    onSettingsChange(patch: Partial<PdfToolSettings>): void;
+    acroFormFields: AcroFormField[];
+    operations: PdfOperation[];
+    dispatch: Dispatch<EditorAction>;
+    onOpenSignaturePicker(): void;
+}
+/** The options panel of `tool`; `null` for a tool that has none (see `PDF_TOOLS`). */
+export declare function ToolOptions({ tool, settings, onSettingsChange, acroFormFields, operations, dispatch, onOpenSignaturePicker, }: ToolOptionsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/editors/PdfEditor/toolbar/tool-options/swatches.d.ts

@@ -0,0 +1,2 @@
+/** Swatches of the text, drawing and shape-outline colours: black, then four distinct hues. */
+export declare const PDF_INK_SWATCHES: readonly string[];

package/dist/components/editors/PdfEditor/toolbar/tool-settings.d.ts

@@ -0,0 +1,14 @@
+import { ShapeKind, TextFontFamily } from '../engine/types';
+/** What the option panels of the annotation tools edit; the host keeps it and hands it back. */
+export interface PdfToolSettings {
+    textColor: string;
+    textSize: number;
+    textFamily: TextFontFamily;
+    drawColor: string;
+    drawStrokeWidth: number;
+    shapeKind: ShapeKind;
+    /** Fill colour of a rectangle or an ellipse; `null` for no fill. */
+    shapeFill: string | null;
+    highlightColor: string;
+}
+export declare const DEFAULT_PDF_TOOL_SETTINGS: PdfToolSettings;

package/dist/components/editors/PdfEditor/viewer/InsertPagesButton.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { EditorAction, PdfEditorCloudImportProps } from '../engine/types';
+export interface InsertPagesButtonProps {
+    /** Virtual index of the page the new pages go after; -1 inserts at the start. */
+    afterVirtualIndex: number;
+    dispatch: React.Dispatch<EditorAction>;
+    cloudImport?: PdfEditorCloudImportProps;
+}
+/**
+ * The « Insert pages » button of the sidebar. It opens a modal that takes a PDF from a drop zone
+ * (device, drag and drop, AbyssCloud when wired); a single-page file is inserted at once, a longer
+ * one asks which pages to keep.
+ */
+export declare const InsertPagesButton: React.FC<InsertPagesButtonProps>;

package/dist/components/editors/PdfEditor/viewer/InsertPagesButton.spec.d.ts

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

package/dist/components/editors/PdfEditor/viewer/InsertPagesDialog.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { CloudImportWiring } from '../../../../hooks/cloud-picker.types';
+/** A PDF read from the device or AbyssCloud, waiting for its pages to be chosen. */
+export interface InsertPagesFile {
+    numPages: number;
+    fileName: string;
+}
+export interface InsertPagesDialogProps {
+    open: boolean;
+    /** The file once read; null while the dialog still asks for one. */
+    file: InsertPagesFile | null;
+    /** A file is being read: the drop zone gives way to a status line. */
+    busy: boolean;
+    /** Why the last file could not be used, written under the drop zone. */
+    error: string | null;
+    /** When set, the drop zone also offers AbyssCloud. */
+    cloudImport?: CloudImportWiring;
+    /** The PDF dropped or picked from the device. */
+    onFiles: (files: File[]) => void;
+    /** The pages kept, as 0-based indices in ascending order. */
+    onConfirm: (selectedPages: number[]) => void;
+    onCancel: () => void;
+}
+/**
+ * The modal of « Insert pages »: first it asks for a PDF (drop zone, device picker, AbyssCloud),
+ * then, for a file of several pages, which of them to insert.
+ */
+export declare const InsertPagesDialog: React.FC<InsertPagesDialogProps>;

package/dist/components/editors/PdfEditor/viewer/PageOverlay.d.ts

@@ -0,0 +1,37 @@
+import { default as React } from 'react';
+import { PdfOperation, ToolKind, EditorAction, ShapeKind, TextFontFamily } from '../engine/types';
+export interface PageOverlayProps {
+    pageIndex: number;
+    displayIndex: number;
+    width: number;
+    height: number;
+    operations: PdfOperation[];
+    activeTool: ToolKind;
+    activePageIndex: number;
+    pendingSignature: string | null;
+    pendingText: string | null;
+    pendingApplyAllPages: boolean;
+    /** Live virtual page indices (pageOrder) — the targets for "apply to all pages". */
+    pageIndices: number[];
+    dispatch: React.Dispatch<EditorAction>;
+    drawColor?: string;
+    drawStrokeWidth?: number;
+    /** New-text styling (existing text keeps its own values). */
+    textColor?: string;
+    textSize?: number;
+    textFamily?: TextFontFamily;
+    /** Active shape kind (rect/ellipse/line/arrow) when the shape tool is on. */
+    shapeKind?: ShapeKind;
+    /** Fill color for rect/ellipse shapes (hex), or null for outline only. */
+    shapeFill?: string | null;
+    /** Highlighter color (hex). */
+    highlightColor?: string;
+    /** Render scale (px per PDF point) — driven by the zoom control. */
+    scale?: number;
+    /** Total displayed rotation (page intrinsic /Rotate + user delta), clockwise.
+     *  Annotations are stored in unrotated content space; the overlay maps pointer
+     *  input back to content space and renders inside a rotated inner layer so the
+     *  preview matches the baked output. */
+    rotation?: number;
+}
+export declare const PageOverlay: React.FC<PageOverlayProps>;

package/dist/components/editors/PdfEditor/viewer/PageOverlay.spec.d.ts

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

package/dist/components/editors/PdfEditor/viewer/PageSidebar.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { PdfOperation, EditorAction, PdfEditorCloudImportProps } from '../engine/types';
+import { InsertedPageRef } from '../engine/operations/compute-page-order';
+/** Width of the sidebar in px; the host offsets the floating viewer controls by it. */
+export declare const PAGE_SIDEBAR_WIDTH = 220;
+export interface PageSidebarProps {
+    pdfDoc: PDFDocumentProxy;
+    operations: PdfOperation[];
+    activePageIndex: number;
+    uploadedDocs: Map<string, PDFDocumentProxy>;
+    insertionTable: Map<number, InsertedPageRef>;
+    dispatch: React.Dispatch<EditorAction>;
+    cloudImport?: PdfEditorCloudImportProps;
+}
+export declare const PageSidebar: React.FC<PageSidebarProps>;

package/dist/components/editors/PdfEditor/viewer/PageSidebar.spec.d.ts

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

package/dist/components/editors/PdfEditor/viewer/PageThumbnail.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { EditorAction, PdfOperation } from '../engine/types';
+import { InsertedPageRef } from '../engine/operations/compute-page-order';
+export interface PageThumbnailProps {
+    pdfDoc: PDFDocumentProxy;
+    uploadedDocs: Map<string, PDFDocumentProxy>;
+    virtualIndex: number;
+    insertedRef: InsertedPageRef | undefined;
+    displayIndex: number;
+    isActive: boolean;
+    rotation: number;
+    operations: PdfOperation[];
+    dispatch: React.Dispatch<EditorAction>;
+}
+export declare const PageThumbnail: React.FC<PageThumbnailProps>;

package/dist/components/editors/PdfEditor/viewer/PdfCanvas.d.ts

@@ -0,0 +1,26 @@
+import { default as React } from 'react';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { InsertedPageRef } from '../engine/operations/compute-page-order';
+declare const RENDER_SCALE = 1.5;
+export { RENDER_SCALE };
+interface PdfCanvasProps {
+    pdfDoc: PDFDocumentProxy;
+    uploadedDocs: Map<string, PDFDocumentProxy>;
+    insertionTable: Map<number, InsertedPageRef>;
+    blankPages?: Map<number, {
+        widthPt: number;
+        heightPt: number;
+    }>;
+    rotationMap?: Map<number, number>;
+    scale?: number;
+    activePageIndex: number;
+    pageOrder: number[];
+    onPageDimensions?: (pageIndex: number, width: number, height: number, totalRotation: number, pointWidth: number) => void;
+    /** Reports the display index of the page currently dominant in the viewport. */
+    onVisiblePageChange?: (displayIndex: number) => void;
+    children?: (virtualIndex: number, displayIndex: number) => React.ReactNode;
+}
+export interface PdfCanvasHandle {
+    scrollToPage: (displayIndex: number) => void;
+}
+export declare const PdfCanvas: React.ForwardRefExoticComponent<PdfCanvasProps & React.RefAttributes<PdfCanvasHandle>>;

package/dist/components/editors/PdfEditor/viewer/PdfCanvas.spec.d.ts

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

package/dist/components/editors/PdfEditor/viewer/ViewerControls.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+export interface ViewerControlsProps {
+    /** Current zoom as a fraction of the base scale (1 = 100%). */
+    zoom: number;
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onFitWidth: () => void;
+    onResetZoom: () => void;
+    canZoomIn: boolean;
+    canZoomOut: boolean;
+    currentPage: number;
+    totalPages: number;
+    onGoToPage: (index: number) => void;
+    /** Narrow viewport: dock as a flush full-width bottom bar (no floating pills). */
+    compact?: boolean;
+    /** Width (px) of the inline page sidebar, so the floating pills center over the
+     *  PAGE region rather than the whole area (kept in sync with the placement banner). */
+    sidebarWidth?: number;
+}
+/** The floating page navigation and zoom controls of the viewer. */
+export declare const ViewerControls: React.FC<ViewerControlsProps>;

package/dist/components/editors/PdfEditor/viewer/ViewerControls.spec.d.ts

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

package/dist/components/editors/PdfEditor/viewer/test-support/viewer-test-harness.d.ts

@@ -0,0 +1,30 @@
+import { ReactElement } from 'react';
+import { RenderResult } from '@testing-library/react';
+import { Theme } from '@mui/material/styles';
+import { UserLanguage } from '@abyss-project/main';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { EditorAction, PdfOperation } from '../../engine/types';
+import { ThemeMode } from '../../../../../theme';
+export interface ViewerRenderOptions {
+    mode?: ThemeMode;
+    width?: number;
+    language?: UserLanguage;
+}
+export interface ViewerRenderResult extends RenderResult {
+    theme: Theme;
+}
+/** Renders `ui` under the root theme, the messages of the language and the confirm-dialog host. */
+export declare const renderViewer: (ui: ReactElement, { mode, width, language, }?: ViewerRenderOptions) => ViewerRenderResult;
+/** The page width in points of every page of `fakePdfDoc`. */
+export declare const FAKE_PAGE_WIDTH_PT = 200;
+export declare const FAKE_PAGE_HEIGHT_PT = 300;
+/**
+ * A pdf.js document double: `numPages` pages of 200 x 300 pt whose render resolves at once. The
+ * viewer only reads `numPages` and `getPage`, so the double carries just those; the cast stands
+ * for the rest of the pdf.js proxy.
+ */
+export declare const fakePdfDoc: (numPages: number) => PDFDocumentProxy;
+/** jsdom has no 2D canvas: gives every canvas a context that accepts the calls the viewer makes. */
+export declare const stubCanvasContext: () => void;
+/** The operations a mocked `dispatch` was asked to append, in order. */
+export declare const addedOperations: (dispatch: (action: EditorAction) => void) => PdfOperation[];

package/dist/components/editors/editors-guard.spec.d.ts

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

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

@@ -0,0 +1,2 @@
+export * from './MarkdownEditor';
+export * from './PdfEditor';

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

@@ -10,6 +10,11 @@ export interface DropZoneProps {
     accept?: Accept;
     /** Largest accepted file, in bytes; shown under the zone. */
     maxSize?: number;
+    /**
+     * The line under the zone, in place of the default « Taille maximale par fichier : … » that
+     * `maxSize` writes: the host's own wording of the limit. Without `maxSize`, shown all the same.
+     */
+    caption?: string;
     /** Title above the zone, which names it. */
     title?: string;
     /**
@@ -20,4 +25,4 @@ export interface DropZoneProps {
     /** Replaces the icon and the prompt inside the zone (a preview of the current file, say). */
     children?: ReactNode;
 }
-export declare function DropZone({ onDrop, multiple, accept, maxSize, title, cloudImport, children, }: DropZoneProps): import("react/jsx-runtime").JSX.Element;
+export declare function DropZone({ onDrop, multiple, accept, maxSize, caption, title, cloudImport, children, }: DropZoneProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layers/ProductTour/product-tour-geometry.d.ts

@@ -39,6 +39,8 @@ export declare const placeBubble: (target: TourRect, bubble: TourSize, viewport:
 export declare const centerBubble: (bubble: TourSize, viewport: TourSize, margin: number) => Pick<BubblePlacement, "top" | "left">;
 /** The rectangle `rect` grown by `by` px on every side. */
 export declare const inflateRect: (rect: TourRect, by: number) => TourRect;
+/** The part of `rect` that lies `inset` px or more inside the viewport. */
+export declare const clampRect: (rect: TourRect, viewport: TourSize, inset: number) => TourRect;
 export declare const toTourRect: (rect: DOMRectReadOnly) => TourRect;
 export declare const sameRect: (a: TourRect | null, b: TourRect | null) => boolean;
 export declare const sameSize: (a: TourSize, b: TourSize) => boolean;

package/dist/components/structure/AccountMenu/AccountMenu.d.ts

@@ -22,6 +22,7 @@ export interface AccountMenuProps {
 }
 /**
  * The account entry of the top bar: the viewer's avatar opens a menu with their name and email,
- * the host's entries (account, settings, billing…), the dark theme switch and the logout.
+ * the host's entries (account, settings, billing…), « Report a problem » under an installed
+ * `AbyssRumProvider`, the dark theme switch and the logout.
  */
 export declare function AccountMenu({ user, themeMode, onThemeModeChange, items, onLogout, }: AccountMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/structure/AppShell/app-shell.types.d.ts

@@ -39,6 +39,11 @@ export interface NavItem {
      * drawer, absent from the rail.
      */
     action?: NavItemAction;
+    /**
+     * A sub-entry of the product entry above it: drawn without its icon, indented under it, in the
+     * sidebar and the drawer, and absent from the rail. `icon` stays required but is not rendered.
+     */
+    nested?: boolean;
 }
 export interface NavSection {
     id: string;

package/dist/cookie-consent.js

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