@athenaintel/react 0.57.1 → 0.59.0

package/dist/sheet-range/query-range.d.ts

@@ -0,0 +1,46 @@
+import { type RangePreview } from './range-preview';
+/** The layers a range query reads. */
+export type QuerySheetRangeLayer = 'values' | 'formatting';
+/** One range of a `query_sheet_range` call. */
+export interface QuerySheetRangeItem {
+    /** A1 notation: `A1:D10`, `'Sheet 2'!A1:C20`. */
+    range: string;
+    /**
+     * Optional on the wire: the backend defaults an omitted layer to `values`
+     * and tells the model it may omit it, which the model usually does.
+     */
+    layer?: QuerySheetRangeLayer;
+}
+/**
+ * A queried cell's value: plain when its formatted value is its value, else
+ * `[formatted, value]`, or `[formatted, value, formula]` for a formula.
+ */
+export type QuerySheetRangeCellValue = string | number | boolean | null | [string, unknown] | [string, unknown, string];
+/** One range's data in a `query_sheet_range` answer. */
+export interface QuerySheetRangeData {
+    /** A1 keys to cell values (the values layer). */
+    cells?: Record<string, QuerySheetRangeCellValue>;
+    /** Keys of cells and rectangles sharing a style (`A1:A3,B1`) to that style (the formatting layer). */
+    styles?: Record<string, unknown>;
+}
+/** A range's rows the card draws and copies at most. */
+export declare const QUERY_RANGE_MAX_DISPLAY_ROWS = 200;
+/** A cell value as its display text: the formatted value, with its formula after it. */
+export declare function queryCellValueText(cell: QuerySheetRangeCellValue | undefined): string;
+/**
+ * One queried range as a card shows and copies it: the range's first
+ * {@link QUERY_RANGE_MAX_DISPLAY_ROWS} rows (every column; the table draws
+ * the first ones), `tableData` for copying, and the range's full row count.
+ * Undefined without the layer's data or for a range that is not an A1
+ * reference.
+ */
+export declare function queryRangeItemTable({ item, data, }: {
+    item: QuerySheetRangeItem & {
+        layer: QuerySheetRangeLayer;
+    };
+    data: QuerySheetRangeData | null | undefined;
+}): {
+    tableData: string[][];
+    totalRows: number;
+    preview: RangePreview;
+} | undefined;

package/dist/sheet-range/query-range.js

@@ -0,0 +1,102 @@
+import { formatA1Range, a1RangeBounds, parseA1Range, formatA1Cell } from "./a1.js";
+import { rangePreviewFromCellMap, rangePreviewToTableData } from "./range-preview.js";
+const QUERY_RANGE_MAX_DISPLAY_ROWS = 200;
+function queryCellValueText(cell) {
+  if (cell == null) return "";
+  if (Array.isArray(cell)) {
+    const formattedValue = String(cell[0] ?? "");
+    if (cell.length === 3) {
+      const formula = String(cell[2] ?? "");
+      return formula ? `${formattedValue} (${formula})` : formattedValue;
+    }
+    return formattedValue;
+  }
+  if (typeof cell === "object") {
+    try {
+      return JSON.stringify(cell);
+    } catch {
+      return String(cell);
+    }
+  }
+  return String(cell);
+}
+const cellStyleText = (style) => style ? JSON.stringify(style) : "";
+const styleAreas = (styles) => Object.entries(styles).flatMap(
+  ([key, style]) => key.split(",").flatMap((part) => {
+    const area = a1RangeBounds(part);
+    return area ? [{ area, style }] : [];
+  })
+);
+const styledBounds = ({ range, areas }) => {
+  const parsed = parseA1Range(range);
+  if (!parsed) return null;
+  if (parsed.kind === "cell" || parsed.kind === "range") {
+    const { startRow, endRow, startColumn, endColumn } = parsed;
+    return { startRow, endRow, startColumn, endColumn };
+  }
+  let first = Number.POSITIVE_INFINITY;
+  let last = Number.NEGATIVE_INFINITY;
+  for (const { area } of areas) {
+    const inSpan = parsed.kind === "columns" ? area.startColumn <= parsed.endColumn && area.endColumn >= parsed.startColumn : area.startRow <= parsed.endRow && area.endRow >= parsed.startRow;
+    if (!inSpan) continue;
+    first = Math.min(first, parsed.kind === "columns" ? area.startRow : area.startColumn);
+    last = Math.max(last, parsed.kind === "columns" ? area.endRow : area.endColumn);
+  }
+  if (first > last) return null;
+  return parsed.kind === "columns" ? { startRow: first, endRow: last, startColumn: parsed.startColumn, endColumn: parsed.endColumn } : { startRow: parsed.startRow, endRow: parsed.endRow, startColumn: first, endColumn: last };
+};
+const stylesByCell = ({
+  areas,
+  bounds
+}) => {
+  const byCell = {};
+  for (const { area, style } of areas) {
+    const lastRow = Math.min(area.endRow, bounds.endRow);
+    const lastColumn = Math.min(area.endColumn, bounds.endColumn);
+    for (let row = Math.max(area.startRow, bounds.startRow); row <= lastRow; row += 1) {
+      for (let column = Math.max(area.startColumn, bounds.startColumn); column <= lastColumn; column += 1) {
+        const cell = formatA1Cell({ row, column });
+        if (!Object.hasOwn(byCell, cell)) byCell[cell] = style;
+      }
+    }
+  }
+  return byCell;
+};
+function queryRangeItemTable({
+  item,
+  data
+}) {
+  const limits = { maxRows: QUERY_RANGE_MAX_DISPLAY_ROWS, maxColumns: Number.POSITIVE_INFINITY };
+  let preview = null;
+  if (item.layer === "values") {
+    if (!(data == null ? void 0 : data.cells)) return void 0;
+    preview = rangePreviewFromCellMap({
+      range: item.range,
+      cells: data.cells,
+      formatCell: queryCellValueText,
+      ...limits
+    });
+  } else {
+    if (!(data == null ? void 0 : data.styles)) return void 0;
+    const areas = styleAreas(data.styles);
+    const bounds = styledBounds({ range: item.range, areas });
+    if (!bounds) return void 0;
+    const drawn = {
+      ...bounds,
+      endRow: Math.min(bounds.endRow, bounds.startRow + QUERY_RANGE_MAX_DISPLAY_ROWS - 1)
+    };
+    preview = rangePreviewFromCellMap({
+      range: formatA1Range(bounds),
+      cells: stylesByCell({ areas, bounds: drawn }),
+      formatCell: cellStyleText,
+      ...limits
+    });
+  }
+  return preview ? { tableData: rangePreviewToTableData(preview), totalRows: preview.totalRows, preview } : void 0;
+}
+export {
+  QUERY_RANGE_MAX_DISPLAY_ROWS,
+  queryCellValueText,
+  queryRangeItemTable
+};
+//# sourceMappingURL=query-range.js.map

package/dist/sheet-range/query-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-range.js","sources":["../../src/sheet-range/query-range.ts"],"sourcesContent":["/**\n * What a `query_sheet_range` call read, as a range preview: the values layer\n * (each cell's formatted value, with its formula after it) or the formatting\n * layer (each cell's style as JSON), for the SDK's sheet tool card and\n * Olympus's alike.\n */\nimport { a1RangeBounds, formatA1Cell, formatA1Range, parseA1Range, type SheetRangeBounds } from './a1';\nimport { type RangePreview, rangePreviewFromCellMap, rangePreviewToTableData } from './range-preview';\n\n/** The layers a range query reads. */\nexport type QuerySheetRangeLayer = 'values' | 'formatting';\n\n/** One range of a `query_sheet_range` call. */\nexport interface QuerySheetRangeItem {\n  /** A1 notation: `A1:D10`, `'Sheet 2'!A1:C20`. */\n  range: string;\n  /**\n   * Optional on the wire: the backend defaults an omitted layer to `values`\n   * and tells the model it may omit it, which the model usually does.\n   */\n  layer?: QuerySheetRangeLayer;\n}\n\n/**\n * A queried cell's value: plain when its formatted value is its value, else\n * `[formatted, value]`, or `[formatted, value, formula]` for a formula.\n */\nexport type QuerySheetRangeCellValue =\n  | string\n  | number\n  | boolean\n  | null\n  | [string, unknown]\n  | [string, unknown, string];\n\n/** One range's data in a `query_sheet_range` answer. */\nexport interface QuerySheetRangeData {\n  /** A1 keys to cell values (the values layer). */\n  cells?: Record<string, QuerySheetRangeCellValue>;\n  /** Keys of cells and rectangles sharing a style (`A1:A3,B1`) to that style (the formatting layer). */\n  styles?: Record<string, unknown>;\n}\n\n/** A range's rows the card draws and copies at most. */\nexport const QUERY_RANGE_MAX_DISPLAY_ROWS = 200;\n\n/** A cell value as its display text: the formatted value, with its formula after it. */\nexport function queryCellValueText(cell: QuerySheetRangeCellValue | undefined): string {\n  if (cell == null) return '';\n  if (Array.isArray(cell)) {\n    const formattedValue = String(cell[0] ?? '');\n    if (cell.length === 3) {\n      const formula = String(cell[2] ?? '');\n      return formula ? `${formattedValue} (${formula})` : formattedValue;\n    }\n    return formattedValue;\n  }\n  if (typeof cell === 'object') {\n    try {\n      return JSON.stringify(cell);\n    } catch {\n      return String(cell);\n    }\n  }\n  return String(cell);\n}\n\n/** A cell's style in the formatting layer, as JSON. */\nconst cellStyleText = (style: unknown): string => (style ? JSON.stringify(style) : '');\n\n/** One cell or rectangle of a formatting-layer key, with the style it carries. */\ninterface StyleArea {\n  area: SheetRangeBounds;\n  style: unknown;\n}\n\n/**\n * The formatting layer's styles as areas. The backend gives the cells that\n * share a style one key of comma-separated rectangles and cells (`A1:A3,B1`);\n * a part that is neither is skipped.\n */\nconst styleAreas = (styles: Record<string, unknown>): StyleArea[] =>\n  Object.entries(styles).flatMap(([key, style]) =>\n    key.split(',').flatMap((part) => {\n      const area = a1RangeBounds(part);\n      return area ? [{ area, style }] : [];\n    }),\n  );\n\n/**\n * The cells a formatting query covers: the queried cell or rectangle, or for\n * whole columns (rows) the rows (columns) its styles reach within them. Null\n * when the range is not an A1 reference, or whole columns or rows hold no\n * style.\n */\nconst styledBounds = ({ range, areas }: { range: string; areas: StyleArea[] }): SheetRangeBounds | null => {\n  const parsed = parseA1Range(range);\n  if (!parsed) return null;\n  if (parsed.kind === 'cell' || parsed.kind === 'range') {\n    const { startRow, endRow, startColumn, endColumn } = parsed;\n    return { startRow, endRow, startColumn, endColumn };\n  }\n  let first = Number.POSITIVE_INFINITY;\n  let last = Number.NEGATIVE_INFINITY;\n  for (const { area } of areas) {\n    const inSpan =\n      parsed.kind === 'columns'\n        ? area.startColumn <= parsed.endColumn && area.endColumn >= parsed.startColumn\n        : area.startRow <= parsed.endRow && area.endRow >= parsed.startRow;\n    if (!inSpan) continue;\n    first = Math.min(first, parsed.kind === 'columns' ? area.startRow : area.startColumn);\n    last = Math.max(last, parsed.kind === 'columns' ? area.endRow : area.endColumn);\n  }\n  if (first > last) return null;\n  return parsed.kind === 'columns'\n    ? { startRow: first, endRow: last, startColumn: parsed.startColumn, endColumn: parsed.endColumn }\n    : { startRow: parsed.startRow, endRow: parsed.endRow, startColumn: first, endColumn: last };\n};\n\n/**\n * Each cell's style within `bounds`, a cell keeping the first area that names\n * it. Only `bounds` is visited, however large an area is.\n */\nconst stylesByCell = ({\n  areas,\n  bounds,\n}: {\n  areas: StyleArea[];\n  bounds: SheetRangeBounds;\n}): Record<string, unknown> => {\n  const byCell: Record<string, unknown> = {};\n  for (const { area, style } of areas) {\n    const lastRow = Math.min(area.endRow, bounds.endRow);\n    const lastColumn = Math.min(area.endColumn, bounds.endColumn);\n    for (let row = Math.max(area.startRow, bounds.startRow); row <= lastRow; row += 1) {\n      for (let column = Math.max(area.startColumn, bounds.startColumn); column <= lastColumn; column += 1) {\n        const cell = formatA1Cell({ row, column });\n        if (!Object.hasOwn(byCell, cell)) byCell[cell] = style;\n      }\n    }\n  }\n  return byCell;\n};\n\n/**\n * One queried range as a card shows and copies it: the range's first\n * {@link QUERY_RANGE_MAX_DISPLAY_ROWS} rows (every column; the table draws\n * the first ones), `tableData` for copying, and the range's full row count.\n * Undefined without the layer's data or for a range that is not an A1\n * reference.\n */\nexport function queryRangeItemTable({\n  item,\n  data,\n}: {\n  item: QuerySheetRangeItem & { layer: QuerySheetRangeLayer };\n  data: QuerySheetRangeData | null | undefined;\n}): { tableData: string[][]; totalRows: number; preview: RangePreview } | undefined {\n  const limits = { maxRows: QUERY_RANGE_MAX_DISPLAY_ROWS, maxColumns: Number.POSITIVE_INFINITY };\n  let preview: RangePreview | null = null;\n  if (item.layer === 'values') {\n    if (!data?.cells) return undefined;\n    preview = rangePreviewFromCellMap({\n      range: item.range,\n      cells: data.cells,\n      formatCell: queryCellValueText,\n      ...limits,\n    });\n  } else {\n    if (!data?.styles) return undefined;\n    const areas = styleAreas(data.styles);\n    const bounds = styledBounds({ range: item.range, areas });\n    if (!bounds) return undefined;\n    const drawn = {\n      ...bounds,\n      endRow: Math.min(bounds.endRow, bounds.startRow + QUERY_RANGE_MAX_DISPLAY_ROWS - 1),\n    };\n    preview = rangePreviewFromCellMap({\n      range: formatA1Range(bounds),\n      cells: stylesByCell({ areas, bounds: drawn }),\n      formatCell: cellStyleText,\n      ...limits,\n    });\n  }\n  return preview ? { tableData: rangePreviewToTableData(preview), totalRows: preview.totalRows, preview } : undefined;\n}\n"],"names":[],"mappings":"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"}