dinocollab-core 2.2.0 → 2.2.1

package/dist/types/lab/data-surface/view-grid.d.ts

@@ -0,0 +1,40 @@
+import { ComponentType, FC } from 'react';
+import { TGetterId } from './types';
+import { RenderStrategyRule } from './view-grid.types';
+import type { IViewGridItemProps, TGridSizes } from './view-grid.types';
+export type TVirtualizedConfig = {
+    scrollTop: number;
+    viewportHeight: number;
+    /** Number of extra rows/columns rendered outside the viewport as a buffer. Defaults to `4` (grid) / `6` (table). */
+    overscan?: number;
+    gap?: number;
+};
+export interface IViewGridBase<T> {
+    gap?: number;
+    sizes?: TGridSizes;
+    gridItemHeight?: number;
+    /**
+     * Controls how the list is rendered into the DOM.
+     * - `normal`      — all rows are mounted (suitable for small datasets)
+     * - `virtualized` — only visible rows are mounted (optimized for large datasets)
+     * @default 'normal'
+     */
+    renderStrategy?: RenderStrategyRule;
+    Component?: ComponentType<IViewGridItemProps<T>>;
+    virtualizedConfig?: TVirtualizedConfig;
+}
+export interface IViewGridConfig<T> extends IViewGridBase<T> {
+    getterId: TGetterId<T>;
+}
+export interface IViewGridProps<T> extends IViewGridBase<T> {
+    value: T[];
+}
+export declare function createViewGrid<T>(config: IViewGridConfig<T>): FC<IViewGridProps<T>>;
+export default createViewGrid;
+export declare const viewGridClasses: {
+    root: string;
+    scrollContainer: string;
+    grid: string;
+    gridVirtualized: string;
+    gridItem: string;
+};

package/dist/types/lab/data-surface/view-grid.types.d.ts

@@ -0,0 +1,22 @@
+export type TGridSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type TGridSizes = Partial<Record<TGridSize, number>>;
+/**
+ * Controls how the list is rendered into the DOM.
+ * - `normal`      — all rows are mounted (suitable for small datasets)
+ * - `virtualized` — only visible rows are mounted (optimized for large datasets)
+ */
+export declare const RenderStrategyRule: {
+    readonly normal: "normal";
+    readonly virtualized: "virtualized";
+};
+export type RenderStrategyRule = keyof typeof RenderStrategyRule;
+/**
+ * Props received by the custom render function for each card in Grid view.
+ * @template T - The shape of a single data row object.
+ */
+export interface IViewGridItemProps<T> {
+    /** The data object for this grid card. */
+    value: T;
+    /** Zero-based position of this item in the data array. */
+    index: number;
+}

package/dist/types/lab/data-surface/view-grid.units.d.ts

@@ -0,0 +1,11 @@
+import { IViewGridItemProps, TGridSizes } from './view-grid.types';
+import { FC } from 'react';
+export declare const DEFAULT_GRID_GAP_PX = 8;
+export declare const getMaxGridGap: (...gap: (number | undefined)[]) => number;
+export declare const DEFAULT_GRID_ITEM_MAX_HEIGHT = 200;
+export declare const getMaxGridItemHeight: (...height: (number | undefined)[]) => number;
+export declare const DEFAULT_GRID_ITEM_SIZES: TGridSizes;
+export declare const getGridItemSizes: (sizes?: TGridSizes) => TGridSizes;
+export declare const normalizeGridSizes: (sizes?: TGridSizes) => Required<TGridSizes>;
+export declare const resolveGridColumnsFromWidth: (width: number, sizes?: TGridSizes) => number;
+export declare const GridItemDefault: FC<IViewGridItemProps<any>>;

package/dist/types/lab/data-surface/view-switch-transition.d.ts

@@ -0,0 +1,24 @@
+import type { FC, ReactNode, ComponentType } from 'react';
+import { TAnimationConfig } from './view-switch-transition.units';
+type TViewSwitchTransitionConfig<T extends string = string> = {
+    value: T;
+    label?: string;
+    Content: ComponentType<{
+        value: T;
+    }>;
+    icon?: ReactNode;
+};
+type TViewSwitchTransitionParam<T extends string = string> = {
+    viewA?: TViewSwitchTransitionConfig<T>;
+    viewB?: TViewSwitchTransitionConfig<T>;
+    transitionConfig?: TAnimationConfig;
+};
+interface IViewSwitchTransitionProps<T extends string = string> {
+    value?: T;
+    viewA?: TViewSwitchTransitionConfig<T>;
+    viewB?: TViewSwitchTransitionConfig<T>;
+    transitionConfig?: TAnimationConfig;
+}
+export declare function createViewSwitchTransition<T extends string = string>(config?: TViewSwitchTransitionParam<T>): FC<IViewSwitchTransitionProps<T>>;
+export declare const ViewSwitchTransition: FC<IViewSwitchTransitionProps<string>>;
+export default ViewSwitchTransition;

package/dist/types/lab/data-surface/view-switch-transition.units.d.ts

@@ -0,0 +1,71 @@
+import { CSSProperties, FC, ReactElement } from 'react';
+export declare const viewSwitchTransitionClasses: {
+    root: string;
+    viewWrapper: string;
+    view: string;
+    viewA: string;
+    viewB: string;
+};
+export declare const ViewSwitchTransitionStyled: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material").Theme>, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const ViewDefault: FC;
+/**
+ * Fine-grained control over the animation that plays when switching between Grid and Table view.
+ * All timing values are in milliseconds unless noted.
+ */
+export type TAnimationConfig = {
+    /** Duration of the enter (fade-in) animation. Defaults to `220`. */
+    enter?: number;
+    /** Duration of the exit (fade-out) animation. Defaults to `140`. */
+    exit?: number;
+    /** CSS easing function for both enter and exit. Defaults to `'cubic-bezier(0.22, 0.61, 0.36, 1)'`. */
+    ease?: string;
+    /** Delay before the enter animation starts. Defaults to `12`. */
+    delayEnter?: number;
+    /** Delay before the exit animation starts. Defaults to `0`. */
+    delayExit?: number;
+    /** CSS `transform-origin` used during the Grid enter/exit. Defaults to `'top center'`. */
+    transformOriginGrid?: string;
+    /** CSS `transform-origin` used during the Table enter/exit. Defaults to `'top center'`. */
+    transformOriginTable?: string;
+    /** Vertical translation offset (px) applied at the start of the enter animation. Defaults to `6`. */
+    translateY?: number;
+    /** Horizontal scale factor applied at the start of the enter animation. Defaults to `0.992`. */
+    horizontalScale?: number;
+    /** Delay after the new pane mounts before its enter animation begins. Defaults to `12`. */
+    mountDelay?: number;
+    /** Extra wait time (ms) after the exit animation completes before swapping the DOM. Defaults to `30`. */
+    hold?: number;
+};
+/**
+ * Default motion profile used when callers do not provide custom switch config.
+ *
+ * The values are tuned for a quick but readable transition between Grid and Table
+ * while minimizing layout jump perception.
+ */
+export declare const DEFAULT_ANIMATION: Required<TAnimationConfig>;
+/**
+ * Props for `CombinedTransition`, the low-level transition wrapper.
+ */
+interface ICombinedTransitionProps {
+    /** Controls whether the child should be shown. */
+    open: boolean;
+    /** Enter/exit durations in milliseconds. */
+    timeout: {
+        enter: number;
+        exit: number;
+    };
+    /** Delay before applying the enter animation after mount. */
+    mountDelay: number;
+    /** Resolved animation config (fully required). */
+    animationConfig: Required<TAnimationConfig>;
+    /** Optional style overrides (commonly transform origin). */
+    style?: CSSProperties;
+    /** Single child element to receive animated inline style. */
+    children: ReactElement;
+}
+/**
+ * Reusable transition wrapper combining fade + transform with controlled
+ * mount/unmount timing to avoid abrupt content flashing.
+ */
+export declare const CombinedTransition: FC<ICombinedTransitionProps>;
+export {};

package/dist/types/lab/data-viewer/index.d.ts

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

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "dinocollab-core",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Dinocollab core - libraries for building collaborative applications with React 18",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "sideEffects": false,
+  "scripts": {
+    "build": "npx rimraf dist && rollup -c && node create-proxy-files.js",
+    "build:watch": "rollup -c -w",
+    "build:analyze": "npx rimraf dist && rollup -c && node create-proxy-files.js",
+    "calc-size": "node calc-build-size.js",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
   "bin": {
     "dinocollab-codegen-cli": "bin/codegen.js"
   },
@@ -172,13 +180,5 @@
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "reflect-metadata": "0.2.2"
-  },
-  "scripts": {
-    "build": "npx rimraf dist && rollup -c && node create-proxy-files.js",
-    "build:watch": "rollup -c -w",
-    "build:analyze": "npx rimraf dist && rollup -c && node create-proxy-files.js",
-    "calc-size": "node calc-build-size.js",
-    "test": "jest --passWithNoTests",
-    "test:watch": "jest --watch"
   }
-}
+}