@mieweb/ui 0.2.2 → 0.3.0-dev.100

package/dist/datavis.js

@@ -0,0 +1,247 @@
+import { createContext, useRef, useContext, useMemo } from 'react';
+import { Source, ComputedView } from 'datavis-ace';
+import { DataGrid } from 'datavis/src/components/DataGrid';
+import { determineColumns } from 'datavis/src/adapters/colconfig-adapter';
+import { getBuiltinGroupFunctions } from 'datavis/src/adapters/group-adapter';
+import { buildAggregateFunctions } from 'datavis/src/adapters/wcdatavis-interop';
+import { useView } from 'datavis/src/adapters/use-data';
+import { TableRenderer } from 'datavis/src/components/table/TableRenderer';
+import { jsx } from 'react/jsx-runtime';
+
+// src/components/DataVisNITRO/DataVisNITRO.tsx
+var DataVisNitroContext = createContext(null);
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function normalizeTypeInfo(typeInfo) {
+  if (Array.isArray(typeInfo)) {
+    return Object.fromEntries(
+      typeInfo.filter(isObject).map((entry) => [entry.field, entry])
+    );
+  }
+  if (!isObject(typeInfo)) {
+    return {};
+  }
+  const maybeOrdMap = typeInfo;
+  if (typeof maybeOrdMap.keys === "function" && typeof maybeOrdMap.get === "function") {
+    return Object.fromEntries(
+      maybeOrdMap.keys().map((field) => [field, maybeOrdMap.get?.(field) ?? {}])
+    );
+  }
+  return Object.fromEntries(
+    Object.entries(typeInfo).filter(([, value]) => isObject(value))
+  );
+}
+function normalizeFieldType(type) {
+  if (!type) return void 0;
+  if (type === "integer") return "number";
+  if (type === "boolean") return "string";
+  return type;
+}
+function buildColumnFromField(field, typeInfo) {
+  const info = typeInfo[field];
+  const normalizedType = normalizeFieldType(info?.type);
+  return {
+    field,
+    header: info?.displayText ?? field,
+    sortable: true,
+    filterable: true,
+    resizable: true,
+    reorderable: true,
+    ...normalizedType ? {
+      typeInfo: {
+        type: normalizedType,
+        ...info?.format !== void 0 ? { format: info.format } : {},
+        ...info?.internalType !== void 0 ? { internalType: info.internalType } : {}
+      }
+    } : {}
+  };
+}
+function mergeColumnWithTypeInfo(column, typeInfo) {
+  const fallbackColumn = buildColumnFromField(column.field, typeInfo);
+  return {
+    ...fallbackColumn,
+    ...column,
+    header: column.header ?? fallbackColumn.header,
+    typeInfo: column.typeInfo ?? fallbackColumn.typeInfo
+  };
+}
+function buildResolvedColumns(columns, fallbackFields, typeInfo) {
+  if (columns && columns.length > 0) {
+    return columns.map((column) => {
+      if (typeof column === "string") {
+        return buildColumnFromField(column, typeInfo);
+      }
+      return mergeColumnWithTypeInfo(column, typeInfo);
+    });
+  }
+  return fallbackFields.map((field) => buildColumnFromField(field, typeInfo));
+}
+function buildFallbackFieldOrder(typeInfo, data) {
+  const rows = Array.isArray(data) ? data.filter((row) => isObject(row)) : null;
+  const normalizedEntries = Object.fromEntries(
+    Object.entries(typeInfo).map(([field, info]) => [
+      field,
+      {
+        type: normalizeFieldType(info.type) ?? "string",
+        ...info.displayText !== void 0 ? { displayText: info.displayText } : {}
+      }
+    ])
+  );
+  return determineColumns(null, normalizedEntries, rows);
+}
+function buildControlFields(columns) {
+  return columns.map((column) => ({
+    field: column.field,
+    displayName: column.header,
+    type: column.typeInfo?.type
+  }));
+}
+function buildAggregateFields(columns) {
+  return columns.map((column) => ({
+    field: column.field,
+    displayName: column.header
+  }));
+}
+function mergeTableDef(tableDef, features) {
+  if (!tableDef && !features) {
+    return void 0;
+  }
+  const { rowMode, ...featureFlags } = features ?? {};
+  return {
+    ...tableDef,
+    ...rowMode !== void 0 ? { rowMode } : {},
+    ...Object.keys(featureFlags).length > 0 ? {
+      features: {
+        ...tableDef?.features ?? {},
+        ...featureFlags
+      }
+    } : {}
+  };
+}
+function DataVisNitroSource(props) {
+  const { type, children } = props;
+  const url = props.type === "http" ? props.url : void 0;
+  const viewRef = useRef(null);
+  if (viewRef.current === null || viewRef.current._dvType !== type || viewRef.current._dvUrl !== url) {
+    const source = props.type === "http" ? new Source({ type, url: props.url }) : new Source({ type });
+    viewRef.current = Object.assign(
+      new ComputedView(source),
+      { _dvType: type, _dvUrl: url }
+    );
+  }
+  return /* @__PURE__ */ jsx(DataVisNitroContext.Provider, { value: viewRef.current, children });
+}
+function DataVisNitroGridInner({
+  computedView,
+  columns,
+  allColumns,
+  features,
+  filterColumns,
+  controlFields,
+  aggregateFields,
+  aggregateFunctions,
+  groupFunctionDefs,
+  tableDef,
+  formatCell,
+  onColumnReorder,
+  onColumnResize,
+  onHeaderContextMenu,
+  onRowClick,
+  onRowDoubleClick,
+  onSelectionChange,
+  style,
+  trans,
+  ...dataGridProps
+}) {
+  const viewState = useView(computedView, false);
+  const normalizedTypeInfo = useMemo(
+    () => normalizeTypeInfo(viewState.typeInfo ?? computedView?.typeInfo ?? null),
+    [computedView, viewState.typeInfo]
+  );
+  const fallbackFields = useMemo(
+    () => buildFallbackFieldOrder(normalizedTypeInfo, viewState.data?.data ?? null),
+    [normalizedTypeInfo, viewState.data?.data]
+  );
+  const resolvedAllColumns = useMemo(() => {
+    if (allColumns && allColumns.length > 0) {
+      return allColumns.map(
+        (column) => mergeColumnWithTypeInfo(column, normalizedTypeInfo)
+      );
+    }
+    return buildResolvedColumns(columns, fallbackFields, normalizedTypeInfo);
+  }, [allColumns, columns, fallbackFields, normalizedTypeInfo]);
+  const resolvedColumns = useMemo(() => {
+    if (columns && columns.length > 0) {
+      return buildResolvedColumns(
+        columns,
+        fallbackFields,
+        normalizedTypeInfo
+      ).filter((column) => column.visible !== false);
+    }
+    return resolvedAllColumns.filter((column) => column.visible !== false);
+  }, [columns, fallbackFields, normalizedTypeInfo, resolvedAllColumns]);
+  const effectiveAggregateFunctions = useMemo(
+    () => aggregateFunctions ?? buildAggregateFunctions(),
+    [aggregateFunctions]
+  );
+  const effectiveGroupFunctionDefs = useMemo(
+    () => groupFunctionDefs ?? getBuiltinGroupFunctions(trans),
+    [groupFunctionDefs, trans]
+  );
+  const effectiveTableDef = useMemo(
+    () => mergeTableDef(tableDef, features),
+    [tableDef, features]
+  );
+  const aggFnLabels = useMemo(
+    () => Object.fromEntries(
+      effectiveAggregateFunctions.map((fn) => [fn.name, fn.label])
+    ),
+    [effectiveAggregateFunctions]
+  );
+  return /* @__PURE__ */ jsx("div", { style, children: /* @__PURE__ */ jsx(
+    DataGrid,
+    {
+      ...dataGridProps,
+      view: computedView,
+      tableDef: effectiveTableDef,
+      allColumns: resolvedAllColumns,
+      filterColumns: filterColumns ?? [],
+      controlFields: controlFields ?? buildControlFields(resolvedAllColumns),
+      aggregateFields: aggregateFields ?? buildAggregateFields(resolvedAllColumns),
+      aggregateFunctions: effectiveAggregateFunctions,
+      groupFunctionDefs: effectiveGroupFunctionDefs,
+      children: /* @__PURE__ */ jsx(
+        TableRenderer,
+        {
+          viewData: viewState.data,
+          columns: resolvedColumns,
+          features: effectiveTableDef?.features ?? features,
+          totalRows: viewState.totalRowCount ?? viewState.rowCount,
+          loading: viewState.loading || !viewState.ready,
+          formatCell,
+          aggFnLabels,
+          onColumnReorder,
+          onColumnResize,
+          onHeaderContextMenu,
+          onRowClick,
+          onRowDoubleClick,
+          onSelectionChange
+        }
+      )
+    }
+  ) });
+}
+function DataVisNitroGrid(props) {
+  const computedView = useContext(DataVisNitroContext);
+  if (computedView === null) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx(DataVisNitroGridInner, { ...props, computedView });
+}
+DataVisNitroSource.displayName = "DataVisNitroSource";
+DataVisNitroGrid.displayName = "DataVisNitroGrid";
+
+export { DataVisNitroContext, DataVisNitroGrid, DataVisNitroSource };
+//# sourceMappingURL=datavis.js.map
+//# sourceMappingURL=datavis.js.map

package/dist/datavis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/DataVisNITRO/DataVisNITRO.tsx"],"names":[],"mappings":"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","file":"datavis.js","sourcesContent":["import React, { createContext, useContext, useMemo, useRef } from 'react';\nimport { ComputedView, Source } from 'datavis-ace';\n\nimport {\n  DataGrid,\n  type DataGridProps,\n  type GridTableDef,\n} from 'datavis/src/components/DataGrid';\nimport { determineColumns } from 'datavis/src/adapters/colconfig-adapter';\nimport { getBuiltinGroupFunctions } from 'datavis/src/adapters/group-adapter';\nimport { buildAggregateFunctions } from 'datavis/src/adapters/wcdatavis-interop';\nimport { useView, type ViewInstance } from 'datavis/src/adapters/use-data';\nimport {\n  TableRenderer,\n  type TableRendererProps,\n} from 'datavis/src/components/table/TableRenderer';\nimport type {\n  TableColumn,\n  TableFeatures,\n} from 'datavis/src/components/table/types';\nimport type { ColumnFilterConfig } from 'datavis/src/components/filters/types';\nimport type { AggregateFunction } from 'datavis/src/components/controls/AggregateSection';\nimport type { GroupFunction as GroupFunctionDef } from 'datavis/src/components/dialogs/GroupFunctionDialog';\n\ntype TranslateFn = (key: string, ...args: unknown[]) => string;\n\ntype DataVisNitroSourceType = 'http' | 'local' | 'file';\n\ninterface HttpDataVisNitroSourceProps {\n  type: 'http';\n  url: string;\n  children?: React.ReactNode;\n}\n\ninterface LocalDataVisNitroSourceProps {\n  type: 'local';\n  children?: React.ReactNode;\n}\n\ninterface FileDataVisNitroSourceProps {\n  type: 'file';\n  children?: React.ReactNode;\n}\n\nexport type DataVisNitroSourceProps =\n  | HttpDataVisNitroSourceProps\n  | LocalDataVisNitroSourceProps\n  | FileDataVisNitroSourceProps;\n\ntype TrackedViewInstance = ViewInstance & {\n  _dvType: DataVisNitroSourceType;\n  _dvUrl: string | undefined;\n};\n\ntype DataVisTypeInfoEntry = {\n  type?: string;\n  displayText?: string;\n  format?: string | Record<string, unknown>;\n  internalType?: string;\n};\n\ntype DataVisTypeInfoMap = Record<string, DataVisTypeInfoEntry>;\n\ntype DataVisTypeInfoOrdMap = {\n  keys?: () => string[];\n  get?: (key: string) => DataVisTypeInfoEntry | undefined;\n};\n\nexport type DataVisNitroColumn = string | TableColumn;\n\nexport interface DataVisNitroGridProps\n  extends\n    Omit<DataGridProps, 'view' | 'children' | 'allColumns'>,\n    Pick<\n      TableRendererProps,\n      | 'formatCell'\n      | 'onColumnReorder'\n      | 'onColumnResize'\n      | 'onHeaderContextMenu'\n      | 'onRowClick'\n      | 'onRowDoubleClick'\n      | 'onSelectionChange'\n    > {\n  columns?: DataVisNitroColumn[];\n  allColumns?: TableColumn[];\n  features?: TableFeatures;\n  filterColumns?: ColumnFilterConfig[];\n  aggregateFunctions?: AggregateFunction[];\n  groupFunctionDefs?: GroupFunctionDef[];\n  style?: React.CSSProperties;\n  trans?: TranslateFn;\n}\n\nexport const DataVisNitroContext = createContext<ViewInstance | null>(null);\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction normalizeTypeInfo(typeInfo: unknown): DataVisTypeInfoMap {\n  if (Array.isArray(typeInfo)) {\n    return Object.fromEntries(\n      typeInfo.filter(isObject).map((entry) => [entry.field, entry])\n    ) as DataVisTypeInfoMap;\n  }\n\n  if (!isObject(typeInfo)) {\n    return {};\n  }\n\n  const maybeOrdMap = typeInfo as DataVisTypeInfoOrdMap;\n  if (\n    typeof maybeOrdMap.keys === 'function' &&\n    typeof maybeOrdMap.get === 'function'\n  ) {\n    return Object.fromEntries(\n      maybeOrdMap.keys().map((field) => [field, maybeOrdMap.get?.(field) ?? {}])\n    );\n  }\n\n  return Object.fromEntries(\n    Object.entries(typeInfo).filter(([, value]) => isObject(value))\n  ) as DataVisTypeInfoMap;\n}\n\nfunction normalizeFieldType(type: string | undefined): string | undefined {\n  if (!type) return undefined;\n  if (type === 'integer') return 'number';\n  if (type === 'boolean') return 'string';\n  return type;\n}\n\nfunction buildColumnFromField(\n  field: string,\n  typeInfo: DataVisTypeInfoMap\n): TableColumn {\n  const info = typeInfo[field];\n  const normalizedType = normalizeFieldType(info?.type);\n\n  return {\n    field,\n    header: info?.displayText ?? field,\n    sortable: true,\n    filterable: true,\n    resizable: true,\n    reorderable: true,\n    ...(normalizedType\n      ? {\n          typeInfo: {\n            type: normalizedType,\n            ...(info?.format !== undefined ? { format: info.format } : {}),\n            ...(info?.internalType !== undefined\n              ? { internalType: info.internalType }\n              : {}),\n          },\n        }\n      : {}),\n  };\n}\n\nfunction mergeColumnWithTypeInfo(\n  column: TableColumn,\n  typeInfo: DataVisTypeInfoMap\n): TableColumn {\n  const fallbackColumn = buildColumnFromField(column.field, typeInfo);\n  return {\n    ...fallbackColumn,\n    ...column,\n    header: column.header ?? fallbackColumn.header,\n    typeInfo: column.typeInfo ?? fallbackColumn.typeInfo,\n  };\n}\n\nfunction buildResolvedColumns(\n  columns: DataVisNitroColumn[] | undefined,\n  fallbackFields: string[],\n  typeInfo: DataVisTypeInfoMap\n): TableColumn[] {\n  if (columns && columns.length > 0) {\n    return columns.map((column) => {\n      if (typeof column === 'string') {\n        return buildColumnFromField(column, typeInfo);\n      }\n\n      return mergeColumnWithTypeInfo(column, typeInfo);\n    });\n  }\n\n  return fallbackFields.map((field) => buildColumnFromField(field, typeInfo));\n}\n\nfunction buildFallbackFieldOrder(\n  typeInfo: DataVisTypeInfoMap,\n  data: unknown[] | null\n): string[] {\n  const rows = Array.isArray(data)\n    ? data.filter((row): row is Record<string, unknown> => isObject(row))\n    : null;\n\n  const normalizedEntries = Object.fromEntries(\n    Object.entries(typeInfo).map(([field, info]) => [\n      field,\n      {\n        type: normalizeFieldType(info.type) ?? 'string',\n        ...(info.displayText !== undefined\n          ? { displayText: info.displayText }\n          : {}),\n      },\n    ])\n  );\n\n  return determineColumns(null, normalizedEntries, rows);\n}\n\nfunction buildControlFields(\n  columns: TableColumn[]\n): NonNullable<DataGridProps['controlFields']> {\n  return columns.map((column) => ({\n    field: column.field,\n    displayName: column.header,\n    type: column.typeInfo?.type,\n  }));\n}\n\nfunction buildAggregateFields(\n  columns: TableColumn[]\n): NonNullable<DataGridProps['aggregateFields']> {\n  return columns.map((column) => ({\n    field: column.field,\n    displayName: column.header,\n  }));\n}\n\nfunction mergeTableDef(\n  tableDef: GridTableDef | undefined,\n  features: TableFeatures | undefined\n): GridTableDef | undefined {\n  if (!tableDef && !features) {\n    return undefined;\n  }\n\n  const { rowMode, ...featureFlags } = features ?? {};\n\n  return {\n    ...tableDef,\n    ...(rowMode !== undefined ? { rowMode } : {}),\n    ...(Object.keys(featureFlags).length > 0\n      ? {\n          features: {\n            ...(tableDef?.features ?? {}),\n            ...featureFlags,\n          },\n        }\n      : {}),\n  };\n}\n\nfunction DataVisNitroSource(props: DataVisNitroSourceProps) {\n  const { type, children } = props;\n  const url = props.type === 'http' ? props.url : undefined;\n  const viewRef = useRef<TrackedViewInstance | null>(null);\n\n  if (\n    viewRef.current === null ||\n    viewRef.current._dvType !== type ||\n    viewRef.current._dvUrl !== url\n  ) {\n    const source =\n      props.type === 'http'\n        ? new Source({ type, url: props.url })\n        : new Source({ type });\n\n    viewRef.current = Object.assign(\n      new ComputedView(source) as unknown as ViewInstance,\n      { _dvType: type, _dvUrl: url }\n    );\n  }\n\n  return (\n    <DataVisNitroContext.Provider value={viewRef.current}>\n      {children}\n    </DataVisNitroContext.Provider>\n  );\n}\n\nfunction DataVisNitroGridInner({\n  computedView,\n  columns,\n  allColumns,\n  features,\n  filterColumns,\n  controlFields,\n  aggregateFields,\n  aggregateFunctions,\n  groupFunctionDefs,\n  tableDef,\n  formatCell,\n  onColumnReorder,\n  onColumnResize,\n  onHeaderContextMenu,\n  onRowClick,\n  onRowDoubleClick,\n  onSelectionChange,\n  style,\n  trans,\n  ...dataGridProps\n}: DataVisNitroGridProps & { computedView: ViewInstance }) {\n  const viewState = useView(computedView, false);\n\n  const normalizedTypeInfo = useMemo(\n    () =>\n      normalizeTypeInfo(viewState.typeInfo ?? computedView?.typeInfo ?? null),\n    [computedView, viewState.typeInfo]\n  );\n\n  const fallbackFields = useMemo(\n    () =>\n      buildFallbackFieldOrder(normalizedTypeInfo, viewState.data?.data ?? null),\n    [normalizedTypeInfo, viewState.data?.data]\n  );\n\n  const resolvedAllColumns = useMemo(() => {\n    if (allColumns && allColumns.length > 0) {\n      return allColumns.map((column) =>\n        mergeColumnWithTypeInfo(column, normalizedTypeInfo)\n      );\n    }\n\n    return buildResolvedColumns(columns, fallbackFields, normalizedTypeInfo);\n  }, [allColumns, columns, fallbackFields, normalizedTypeInfo]);\n\n  const resolvedColumns = useMemo(() => {\n    if (columns && columns.length > 0) {\n      return buildResolvedColumns(\n        columns,\n        fallbackFields,\n        normalizedTypeInfo\n      ).filter((column) => column.visible !== false);\n    }\n\n    return resolvedAllColumns.filter((column) => column.visible !== false);\n  }, [columns, fallbackFields, normalizedTypeInfo, resolvedAllColumns]);\n\n  const effectiveAggregateFunctions = useMemo(\n    () => aggregateFunctions ?? buildAggregateFunctions(),\n    [aggregateFunctions]\n  );\n\n  const effectiveGroupFunctionDefs = useMemo(\n    () =>\n      groupFunctionDefs ??\n      getBuiltinGroupFunctions(trans as TranslateFn | undefined),\n    [groupFunctionDefs, trans]\n  );\n\n  const effectiveTableDef = useMemo(\n    () => mergeTableDef(tableDef, features),\n    [tableDef, features]\n  );\n\n  const aggFnLabels = useMemo(\n    () =>\n      Object.fromEntries(\n        effectiveAggregateFunctions.map((fn) => [fn.name, fn.label])\n      ),\n    [effectiveAggregateFunctions]\n  );\n\n  return (\n    <div style={style}>\n      <DataGrid\n        {...dataGridProps}\n        view={computedView}\n        tableDef={effectiveTableDef}\n        allColumns={resolvedAllColumns}\n        filterColumns={filterColumns ?? []}\n        controlFields={controlFields ?? buildControlFields(resolvedAllColumns)}\n        aggregateFields={\n          aggregateFields ?? buildAggregateFields(resolvedAllColumns)\n        }\n        aggregateFunctions={effectiveAggregateFunctions}\n        groupFunctionDefs={effectiveGroupFunctionDefs}\n      >\n        <TableRenderer\n          viewData={viewState.data}\n          columns={resolvedColumns}\n          features={\n            (effectiveTableDef?.features as TableFeatures | undefined) ??\n            features\n          }\n          totalRows={viewState.totalRowCount ?? viewState.rowCount}\n          loading={viewState.loading || !viewState.ready}\n          formatCell={formatCell}\n          aggFnLabels={aggFnLabels}\n          onColumnReorder={onColumnReorder}\n          onColumnResize={onColumnResize}\n          onHeaderContextMenu={onHeaderContextMenu}\n          onRowClick={onRowClick}\n          onRowDoubleClick={onRowDoubleClick}\n          onSelectionChange={onSelectionChange}\n        />\n      </DataGrid>\n    </div>\n  );\n}\n\nfunction DataVisNitroGrid(props: DataVisNitroGridProps) {\n  const computedView = useContext(DataVisNitroContext);\n\n  if (computedView === null) {\n    return null;\n  }\n\n  return <DataVisNitroGridInner {...props} computedView={computedView} />;\n}\n\nDataVisNitroSource.displayName = 'DataVisNitroSource';\nDataVisNitroGrid.displayName = 'DataVisNitroGrid';\n\nexport { DataVisNitroGrid, DataVisNitroSource };\n"]}

package/dist/default-BTEIFIZJ.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var chunkX7S76WB7_cjs = require('./chunk-X7S76WB7.cjs');
+
+
+
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () { return chunkX7S76WB7_cjs.defaultBrand; }
+});
+Object.defineProperty(exports, "defaultBrand", {
+  enumerable: true,
+  get: function () { return chunkX7S76WB7_cjs.defaultBrand; }
+});
+//# sourceMappingURL=default-BTEIFIZJ.cjs.map
+//# sourceMappingURL=default-BTEIFIZJ.cjs.map

package/dist/{default-ZGHKI5WF.cjs.map → default-BTEIFIZJ.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"default-ZGHKI5WF.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"default-BTEIFIZJ.cjs"}

package/dist/default-ORBRVZRZ.js

@@ -0,0 +1,3 @@
+export { defaultBrand as default, defaultBrand } from './chunk-PSTGFXQG.js';
+//# sourceMappingURL=default-ORBRVZRZ.js.map
+//# sourceMappingURL=default-ORBRVZRZ.js.map

package/dist/{default-LIRPABBK.js.map → default-ORBRVZRZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"default-LIRPABBK.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"default-ORBRVZRZ.js"}

package/dist/hooks/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkR4DM4635_cjs = require('../chunk-R4DM4635.cjs');
+var chunkFSBFQBNE_cjs = require('../chunk-FSBFQBNE.cjs');
 var chunk2O7D6F67_cjs = require('../chunk-2O7D6F67.cjs');
 var chunk6HFFWEM3_cjs = require('../chunk-6HFFWEM3.cjs');
+var chunkIKMR2ADM_cjs = require('../chunk-IKMR2ADM.cjs');
 var chunkNNEFAUHV_cjs = require('../chunk-NNEFAUHV.cjs');
-var chunkSWMRCGL4_cjs = require('../chunk-SWMRCGL4.cjs');
 var chunkFHY3K6PL_cjs = require('../chunk-FHY3K6PL.cjs');
 require('../chunk-SCV7C55E.cjs');
 
@@ -12,39 +12,43 @@ require('../chunk-SCV7C55E.cjs');
 
 Object.defineProperty(exports, "useCommandK", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useCommandK; }
+  get: function () { return chunkFSBFQBNE_cjs.useCommandK; }
 });
 Object.defineProperty(exports, "useIsDesktop", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsDesktop; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsDesktop; }
 });
 Object.defineProperty(exports, "useIsLargeDesktop", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsLargeDesktop; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsLargeDesktop; }
 });
 Object.defineProperty(exports, "useIsMobile", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsMobile; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsMobile; }
 });
 Object.defineProperty(exports, "useIsMobileOrTablet", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsMobileOrTablet; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsMobileOrTablet; }
 });
 Object.defineProperty(exports, "useIsSmallTablet", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsSmallTablet; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsSmallTablet; }
 });
 Object.defineProperty(exports, "useIsTablet", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useIsTablet; }
+  get: function () { return chunkFSBFQBNE_cjs.useIsTablet; }
 });
 Object.defineProperty(exports, "useKeyboardShortcut", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useKeyboardShortcut; }
+  get: function () { return chunkFSBFQBNE_cjs.useKeyboardShortcut; }
 });
 Object.defineProperty(exports, "useMediaQuery", {
   enumerable: true,
-  get: function () { return chunkR4DM4635_cjs.useMediaQuery; }
+  get: function () { return chunkFSBFQBNE_cjs.useMediaQuery; }
+});
+Object.defineProperty(exports, "useScrollSpy", {
+  enumerable: true,
+  get: function () { return chunkFSBFQBNE_cjs.useScrollSpy; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
@@ -54,13 +58,13 @@ Object.defineProperty(exports, "usePrefersReducedMotion", {
   enumerable: true,
   get: function () { return chunk6HFFWEM3_cjs.usePrefersReducedMotion; }
 });
-Object.defineProperty(exports, "useFocusTrap", {
+Object.defineProperty(exports, "useClickOutside", {
   enumerable: true,
-  get: function () { return chunkNNEFAUHV_cjs.useFocusTrap; }
+  get: function () { return chunkIKMR2ADM_cjs.useClickOutside; }
 });
-Object.defineProperty(exports, "useClickOutside", {
+Object.defineProperty(exports, "useFocusTrap", {
   enumerable: true,
-  get: function () { return chunkSWMRCGL4_cjs.useClickOutside; }
+  get: function () { return chunkNNEFAUHV_cjs.useFocusTrap; }
 });
 Object.defineProperty(exports, "useEscapeKey", {
   enumerable: true,

package/dist/hooks/index.d.cts

@@ -1,6 +1,42 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.cjs';
 import { RefObject } from 'react';
 
+interface UseScrollSpyOptions {
+    /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */
+    selectors?: string;
+    /** Explicit list of element IDs to observe (alternative to selectors) */
+    ids?: string[];
+    /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */
+    rootMargin?: string;
+    /** IntersectionObserver threshold (default: 0) */
+    threshold?: number | number[];
+    /** Scroll container element ref. Defaults to document viewport. */
+    root?: RefObject<HTMLElement | null>;
+    /** Whether the hook is active (default: true) */
+    enabled?: boolean;
+}
+interface UseScrollSpyReturn {
+    /** The ID of the currently active (in-view) element */
+    activeId: string | null;
+}
+/**
+ * Tracks which section is currently in the viewport using IntersectionObserver.
+ * Pairs naturally with `TableOfContents` to highlight the active heading.
+ *
+ * @example
+ * ```tsx
+ * function DocsPage() {
+ *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });
+ *   return (
+ *     <aside>
+ *       <TableOfContents activeId={activeId} />
+ *     </aside>
+ *   );
+ * }
+ * ```
+ */
+declare function useScrollSpy({ selectors, ids, rootMargin, threshold, root, enabled, }?: UseScrollSpyOptions): UseScrollSpyReturn;
+
 /**
  * Hook that detects if the user prefers reduced motion.
  * Useful for disabling animations for accessibility.
@@ -29,7 +65,7 @@ declare function usePrefersReducedMotion(): boolean;
  *   const [isOpen, setIsOpen] = useState(false);
  *   const ref = useRef<HTMLDivElement>(null);
  *
- *   useClickOutside(ref, () => setIsOpen(false));
+ *   useClickOutside(ref, () => setIsOpen(false), isOpen);
  *
  *   return (
  *     <div ref={ref}>
@@ -40,7 +76,7 @@ declare function usePrefersReducedMotion(): boolean;
  * }
  * ```
  */
-declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, callback: () => void): void;
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, callback: () => void, enabled?: boolean): void;
 
 /**
  * Hook that triggers a callback when the Escape key is pressed.
@@ -176,4 +212,4 @@ declare function useIsLargeDesktop(): boolean;
 /** Returns true when viewport is smaller than 1024px (mobile/tablet) */
 declare function useIsMobileOrTablet(): boolean;
 
-export { type KeyboardShortcutOptions, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion };
+export { type KeyboardShortcutOptions, type UseScrollSpyOptions, type UseScrollSpyReturn, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.d.ts

@@ -1,6 +1,42 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.js';
 import { RefObject } from 'react';
 
+interface UseScrollSpyOptions {
+    /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */
+    selectors?: string;
+    /** Explicit list of element IDs to observe (alternative to selectors) */
+    ids?: string[];
+    /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */
+    rootMargin?: string;
+    /** IntersectionObserver threshold (default: 0) */
+    threshold?: number | number[];
+    /** Scroll container element ref. Defaults to document viewport. */
+    root?: RefObject<HTMLElement | null>;
+    /** Whether the hook is active (default: true) */
+    enabled?: boolean;
+}
+interface UseScrollSpyReturn {
+    /** The ID of the currently active (in-view) element */
+    activeId: string | null;
+}
+/**
+ * Tracks which section is currently in the viewport using IntersectionObserver.
+ * Pairs naturally with `TableOfContents` to highlight the active heading.
+ *
+ * @example
+ * ```tsx
+ * function DocsPage() {
+ *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });
+ *   return (
+ *     <aside>
+ *       <TableOfContents activeId={activeId} />
+ *     </aside>
+ *   );
+ * }
+ * ```
+ */
+declare function useScrollSpy({ selectors, ids, rootMargin, threshold, root, enabled, }?: UseScrollSpyOptions): UseScrollSpyReturn;
+
 /**
  * Hook that detects if the user prefers reduced motion.
  * Useful for disabling animations for accessibility.
@@ -29,7 +65,7 @@ declare function usePrefersReducedMotion(): boolean;
  *   const [isOpen, setIsOpen] = useState(false);
  *   const ref = useRef<HTMLDivElement>(null);
  *
- *   useClickOutside(ref, () => setIsOpen(false));
+ *   useClickOutside(ref, () => setIsOpen(false), isOpen);
  *
  *   return (
  *     <div ref={ref}>
@@ -40,7 +76,7 @@ declare function usePrefersReducedMotion(): boolean;
  * }
  * ```
  */
-declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, callback: () => void): void;
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, callback: () => void, enabled?: boolean): void;
 
 /**
  * Hook that triggers a callback when the Escape key is pressed.
@@ -176,4 +212,4 @@ declare function useIsLargeDesktop(): boolean;
 /** Returns true when viewport is smaller than 1024px (mobile/tablet) */
 declare function useIsMobileOrTablet(): boolean;
 
-export { type KeyboardShortcutOptions, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion };
+export { type KeyboardShortcutOptions, type UseScrollSpyOptions, type UseScrollSpyReturn, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
-export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery } from '../chunk-CP7NPDQW.js';
+export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, useScrollSpy } from '../chunk-Q7NBJFEB.js';
 export { useTheme } from '../chunk-KJZNEVYM.js';
 export { usePrefersReducedMotion } from '../chunk-HB7C7NB5.js';
+export { useClickOutside } from '../chunk-OKBR6PX4.js';
 export { useFocusTrap } from '../chunk-4SMSH4OY.js';
-export { useClickOutside } from '../chunk-OT36EMM5.js';
 export { useEscapeKey } from '../chunk-T4ME7QCT.js';
 import '../chunk-VSQF22GL.js';
 //# sourceMappingURL=index.js.map