@agent-native/core-corpus 0.209.1 → 0.209.2-nightly-20261016005836

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 12398
+- template files: 12477

package/corpus/templates/analytics/.agents/skills/dashboard-management/SKILL.md

@@ -62,6 +62,13 @@ current state first, then syncs open dashboard editors.
 Saved analyses follow the same undo model with `analysis_revisions`,
 `list-analysis-revisions`, and `restore-analysis-revision`.
 
+Dashboards open in View mode. An editor switches the header toggle to Edit
+before drags, renames, and column edits on the page save for everyone; the chat
+context reports the current mode. A table column width dragged in View mode is
+stored only in that person's browser, so "widen this column for me" is a drag
+in View mode, not a dashboard change. `config.columns[].width` is the shared
+width everyone sees; set it only when asked to change the dashboard itself.
+
 Never use `db-patch`, raw SQL, or settings-key edits to create or modify a
 dashboard config. Those bypass the dashboard action's access checks, SQL
 validation, collab sync, and verification. If a dashboard action fails

package/corpus/templates/analytics/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","analytics-alert-jobs","analytics-rollup-backfill-jobs","auth","collab","config","core-routes","creative-context","dashboard-report-jobs","db","feature-flags","labs","onboarding","otel","session-replay-retention-jobs","transactional-emails","uptime-monitor-jobs"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -1221,6 +1221,13 @@ interface SqlChartProps {
   onCopyTableChange?: (handler: (() => Promise<void>) | null) => void;
   /** Passing this makes a table's columns editable; omit it for read-only tables. */
   onSaveColumns?: (columns: TableColumnConfig[]) => void;
+  /** One viewer's own column widths, drawn over the panel's saved ones. */
+  columnWidths?: Record<string, number>;
+  /**
+   * Passing this lets a viewer drag column widths for themselves; the drag
+   * calls this instead of `onSaveColumns`, and null resets the column.
+   */
+  onColumnWidthChange?: (columnKey: string, width: number | null) => void;
   dashboardId?: string;
   extensionContext?: Record<string, unknown> | null;
 }
@@ -1238,6 +1245,8 @@ export function SqlChart({
   onExportCsvChange,
   onCopyTableChange,
   onSaveColumns,
+  columnWidths,
+  onColumnWidthChange,
   dashboardId,
   extensionContext,
 }: SqlChartProps) {
@@ -1469,6 +1478,8 @@ export function SqlChart({
         onExportCsvChange={onExportCsvChange}
         onCopyTableChange={onCopyTableChange}
         onSaveColumns={onSaveColumns}
+        columnWidths={columnWidths}
+        onColumnWidthChange={onColumnWidthChange}
       />,
     );
   }
@@ -1936,20 +1947,26 @@ function TableRenderer({
   onExportCsvChange,
   onCopyTableChange,
   onSaveColumns,
+  columnWidths,
+  onColumnWidthChange,
 }: {
   rows: Record<string, unknown>[];
   panel: SqlPanel;
   onExportCsvChange?: (handler: (() => void) | null) => void;
   onCopyTableChange?: (handler: (() => Promise<void>) | null) => void;
   onSaveColumns?: (columns: TableColumnConfig[]) => void;
+  columnWidths?: Record<string, number>;
+  onColumnWidthChange?: (columnKey: string, width: number | null) => void;
 }) {
   const t = useT();
   const config = panel.config;
   const sortable = config?.sortable !== false;
   const editable = onSaveColumns !== undefined;
+  const personalResize = onColumnWidthChange !== undefined;
+  const resizable = editable || personalResize;
   const rowKeys = useMemo(() => new Set(Object.keys(rows[0] ?? {})), [rows]);
 
-  const columns = useMemo<TableColumnConfig[]>(() => {
+  const savedColumns = useMemo<TableColumnConfig[]>(() => {
     if (config?.columns?.length) {
       const configured = config.columns.filter(
         (c) => !c.hidden && rowKeys.has(c.key),
@@ -1959,6 +1976,18 @@ function TableRenderer({
     return Object.keys(rows[0]).map((key) => ({ key }));
   }, [config?.columns, rows, rowKeys]);
 
+  // A viewer's own widths are drawn over the saved ones but never saved:
+  // edits start from `editableColumns`, which reads the panel config.
+  const columns = useMemo<TableColumnConfig[]>(
+    () =>
+      columnWidths
+        ? savedColumns.map((c) =>
+            columnWidths[c.key] ? { ...c, width: columnWidths[c.key] } : c,
+          )
+        : savedColumns,
+    [savedColumns, columnWidths],
+  );
+
   // Edits start from the persisted list, hidden entries included, so a change
   // never drops a key the agent configured. Visible keys missing from it (the
   // all-keys fallback above) are appended so every visible column is editable.
@@ -2060,7 +2089,9 @@ function TableRenderer({
       MIN_TABLE_COLUMN_WIDTH,
       Math.round(resize.startWidth + event.clientX - resize.startX),
     );
-    if (width !== resize.startWidth) updateColumn(resize.key, { width });
+    if (width === resize.startWidth) return;
+    if (personalResize) onColumnWidthChange(resize.key, width);
+    else updateColumn(resize.key, { width });
   };
 
   const renderHeaderCell = (col: TableColumnConfig) => {
@@ -2112,7 +2143,7 @@ function TableRenderer({
         }
         className={`text-left align-bottom py-1.5 px-2 font-medium text-muted-foreground ${
           sortable ? "cursor-pointer select-none hover:text-foreground" : ""
-        } ${editable ? "relative" : ""} ${width ? "overflow-hidden text-ellipsis whitespace-nowrap" : ""}`}
+        } ${resizable ? "relative" : ""} ${width ? "overflow-hidden text-ellipsis whitespace-nowrap" : ""}`}
         onClick={(event) => {
           // The second click of a double-click renames the column and must not
           // toggle the sort a second time.
@@ -2165,18 +2196,31 @@ function TableRenderer({
             </>
           )}
         </span>
-        {editable &&
+        {resizable &&
         !isRenaming &&
         col.key !== columns[columns.length - 1]?.key ? (
           <span
             role="separator"
             aria-orientation="vertical"
             aria-label={t("sqlDashboard.columnResize")}
+            title={
+              personalResize
+                ? t("dashboardMode.columnResizePersonal")
+                : t("dashboardMode.columnResizeShared")
+            }
             className="absolute inset-y-0 end-0 w-1.5 cursor-col-resize hover:bg-border"
             onPointerDown={(event) => handleResizeStart(col.key, event)}
             onPointerMove={handleResizeMove}
             onPointerUp={handleResizeEnd}
             onClick={(event) => event.stopPropagation()}
+            onDoubleClick={
+              personalResize
+                ? (event) => {
+                    event.stopPropagation();
+                    onColumnWidthChange(col.key, null);
+                  }
+                : undefined
+            }
           />
         ) : null}
       </th>

package/corpus/templates/analytics/app/hooks/use-dashboard-chat-context.ts

@@ -26,6 +26,7 @@ export interface DashboardChatContextArgs {
   title?: string | null;
   panelCount?: number;
   canEdit?: boolean;
+  editing?: boolean;
 }
 
 export interface DashboardPanelChatContextArgs {
@@ -56,6 +57,7 @@ function dashboardContext(
     title: string;
     panelCount?: number;
     canEdit?: boolean;
+    editing?: boolean;
   },
 ): string {
   const lines = [
@@ -69,6 +71,13 @@ function dashboardContext(
   if (typeof args.canEdit === "boolean") {
     lines.push(`User can edit: ${args.canEdit ? "yes" : "no"}`);
   }
+  if (args.canEdit && typeof args.editing === "boolean") {
+    lines.push(
+      args.editing
+        ? "Dashboard mode: edit (the user's own drags and renames save for everyone)"
+        : "Dashboard mode: view (moving or editing panels, renaming, and undo on the page wait for edit mode, and the user's column drags stay in their browser; saving a view, restoring history, archiving, deleting, and adding a first panel still work and apply to everyone)",
+    );
+  }
   if (typeof window !== "undefined") {
     lines.push(
       `Current URL: ${window.location.pathname}${window.location.search}`,
@@ -115,7 +124,7 @@ function isAgentSidebarOpenInDocument(): boolean {
 export function useDashboardChatContext(
   args: DashboardChatContextArgs,
 ): DashboardChatContextResult {
-  const { id, kind, title, panelCount, canEdit } = args;
+  const { id, kind, title, panelCount, canEdit, editing } = args;
   const [isAgentSidebarOpen, setIsAgentSidebarOpen] = useState(
     isAgentSidebarOpenInDocument,
   );
@@ -249,13 +258,14 @@ export function useDashboardChatContext(
           title: displayTitle,
           panelCount,
           canEdit,
+          editing,
         }),
         openSidebar: false,
         focus: false,
       });
     }, CONTEXT_PUBLISH_DELAY_MS);
     return () => clearTimeout(timer);
-  }, [canEdit, id, kind, panelCount, title]);
+  }, [canEdit, editing, id, kind, panelCount, title]);
 
   useEffect(() => {
     if (!id || hasSelectedPanel) return;
@@ -268,6 +278,9 @@ export function useDashboardChatContext(
       title: displayTitle,
       panelCount,
       canEdit,
+      ...(canEdit && typeof editing === "boolean"
+        ? { mode: editing ? "edit" : "view" }
+        : {}),
       [SELECTED_OBJECT_SOURCE_FIELD]: TAB_ID,
     };
     const timer = setTimeout(() => {
@@ -279,7 +292,7 @@ export function useDashboardChatContext(
       publishedSelectionRef.current = selection;
     }, CONTEXT_PUBLISH_DELAY_MS);
     return () => clearTimeout(timer);
-  }, [canEdit, hasSelectedPanel, id, kind, panelCount, title]);
+  }, [canEdit, editing, hasSelectedPanel, id, kind, panelCount, title]);
 
   useEffect(() => {
     if (!id) return;

package/corpus/templates/analytics/app/i18n/en-US.ts

@@ -167,6 +167,16 @@ export default {
     templateCatalog: "Catalog",
     semanticLayer: "Semantic Layer",
   },
+  dashboardMode: {
+    label: "Dashboard mode",
+    view: "View",
+    edit: "Edit",
+    viewHint:
+      "Look without changing anything. Column widths you drag stay yours.",
+    editHint: "Changes save for everyone",
+    columnResizePersonal: "Drag to resize for you only. Double-click to reset.",
+    columnResizeShared: "Drag to resize for everyone",
+  },
   dashboardHeader: {
     updated: "Updated {{date}}",
     created: "Created {{date}}",

package/corpus/templates/analytics/app/lib/personal-column-widths.ts

@@ -0,0 +1,167 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+
+import type { TableColumnConfig } from "@/pages/adhoc/sql-dashboard/types";
+
+const STORAGE_PREFIX = "analytics-column-widths:v1:";
+
+/**
+ * A width someone dragged while viewing a dashboard, kept in their browser.
+ * `base` is the dashboard's own width for the column at the time (null when it
+ * had none): once the dashboard's width changes, the personal one is dropped,
+ * so a later edit for everyone is never hidden behind an old personal drag.
+ */
+export interface PersonalColumnWidth {
+  width: number;
+  base: number | null;
+}
+
+export type PersonalColumnWidths = Record<string, PersonalColumnWidth>;
+
+export function personalColumnWidthsKey(
+  dashboardId: string,
+  panelId: string,
+): string {
+  return `${STORAGE_PREFIX}${dashboardId}:${panelId}`;
+}
+
+function isPersonalColumnWidth(value: unknown): value is PersonalColumnWidth {
+  if (!value || typeof value !== "object") return false;
+  const entry = value as Record<string, unknown>;
+  return (
+    typeof entry.width === "number" &&
+    Number.isFinite(entry.width) &&
+    entry.width > 0 &&
+    (entry.base === null ||
+      (typeof entry.base === "number" && Number.isFinite(entry.base)))
+  );
+}
+
+/** Parses a stored value, keeping only well-formed entries. */
+export function parsePersonalColumnWidths(
+  raw: string | null,
+): PersonalColumnWidths {
+  if (!raw) return {};
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    // coercion-ok: a corrupt entry means no personal widths; the dashboard's own widths apply.
+    return {};
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return {};
+  }
+  const widths: PersonalColumnWidths = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (isPersonalColumnWidth(value)) widths[key] = value;
+  }
+  return widths;
+}
+
+/** The stored entries still based on the dashboard's current widths. */
+export function currentPersonalColumnWidths(
+  stored: PersonalColumnWidths,
+  columns: TableColumnConfig[] | undefined,
+): PersonalColumnWidths {
+  const sharedWidth = new Map(
+    (columns ?? []).map((column) => [column.key, column.width ?? null]),
+  );
+  const current: PersonalColumnWidths = {};
+  for (const [key, entry] of Object.entries(stored)) {
+    if ((sharedWidth.get(key) ?? null) === entry.base) current[key] = entry;
+  }
+  return current;
+}
+
+/** The personal widths that apply against the dashboard's current widths. */
+export function activePersonalColumnWidths(
+  stored: PersonalColumnWidths,
+  columns: TableColumnConfig[] | undefined,
+): Record<string, number> {
+  const active: Record<string, number> = {};
+  for (const [key, entry] of Object.entries(
+    currentPersonalColumnWidths(stored, columns),
+  )) {
+    active[key] = entry.width;
+  }
+  return active;
+}
+
+function readStoredWidths(key: string | null): PersonalColumnWidths {
+  if (!key || typeof window === "undefined") return {};
+  let raw: string | null;
+  try {
+    raw = window.localStorage.getItem(key);
+  } catch {
+    // coercion-ok: storage blocked by the browser; widths then last for this visit only.
+    return {};
+  }
+  return parsePersonalColumnWidths(raw);
+}
+
+function writeStoredWidths(key: string, widths: PersonalColumnWidths): void {
+  try {
+    if (Object.keys(widths).length === 0) window.localStorage.removeItem(key);
+    else window.localStorage.setItem(key, JSON.stringify(widths));
+  } catch {
+    // coercion-ok: storage blocked or full; the width still applies until the page reloads.
+  }
+}
+
+/**
+ * Column widths one person dragged on one dashboard table. They live in this
+ * browser only and never change the dashboard for anyone else.
+ */
+export function usePersonalColumnWidths(
+  dashboardId: string | undefined,
+  panelId: string,
+  columns: TableColumnConfig[] | undefined,
+): {
+  widths: Record<string, number>;
+  setWidth: (columnKey: string, width: number | null) => void;
+} {
+  const key = dashboardId
+    ? personalColumnWidthsKey(dashboardId, panelId)
+    : null;
+  const [stored, setStored] = useState<PersonalColumnWidths>(() =>
+    readStoredWidths(key),
+  );
+  useEffect(() => {
+    setStored(readStoredWidths(key));
+  }, [key]);
+  // Hiding a stale width is not enough: kept in storage, it would come back
+  // if the dashboard's width returned to its base and hide that newer change.
+  useEffect(() => {
+    if (!key) return;
+    setStored((current) => {
+      const kept = currentPersonalColumnWidths(current, columns);
+      if (Object.keys(kept).length === Object.keys(current).length) {
+        return current;
+      }
+      writeStoredWidths(key, kept);
+      return kept;
+    });
+  }, [columns, key]);
+
+  const setWidth = useCallback(
+    (columnKey: string, width: number | null) => {
+      if (!key) return;
+      const base =
+        columns?.find((column) => column.key === columnKey)?.width ?? null;
+      setStored((current) => {
+        const next = { ...current };
+        if (width === null) delete next[columnKey];
+        else next[columnKey] = { width, base };
+        writeStoredWidths(key, next);
+        return next;
+      });
+    },
+    [columns, key],
+  );
+
+  const widths = useMemo(
+    () => activePersonalColumnWidths(stored, columns),
+    [stored, columns],
+  );
+  return { widths, setWidth };
+}

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/SqlChartCard.tsx

@@ -59,6 +59,7 @@ import {
 } from "@/components/ui/tooltip";
 import type { SelectDashboardPanelOptions } from "@/hooks/use-dashboard-chat-context";
 import { buildCustomBlockPromotionRequest } from "@/lib/custom-block-promotion";
+import { usePersonalColumnWidths } from "@/lib/personal-column-widths";
 import { cn } from "@/lib/utils";
 
 import { timeRangeDays } from "./pivot";
@@ -164,6 +165,22 @@ export function SqlChartCard({
   const exportToGoogleSheets = useActionMutation(
     "export-dashboard-panel-to-google-sheet",
   );
+  // While viewing, dragging a column edge sizes it for this person only. A
+  // table offers rename, reorder, and format whenever it gets onSaveColumns,
+  // so only edit mode passes it on.
+  const personalColumnWidths = usePersonalColumnWidths(
+    dashboardId,
+    panel.id,
+    panel.config?.columns,
+  );
+  const tableColumnProps = editable
+    ? { onSaveColumns }
+    : dashboardId && panel.chartType === "table"
+      ? {
+          columnWidths: personalColumnWidths.widths,
+          onColumnWidthChange: personalColumnWidths.setWidth,
+        }
+      : {};
 
   const [confirmOpen, setConfirmOpen] = useState(false);
   const [menuOpen, setMenuOpen] = useState(false);
@@ -811,7 +828,7 @@ export function SqlChartCard({
             dashboardId={dashboardId}
             onExportCsvChange={handleExportCsvChange}
             onCopyTableChange={handleCopyTableChange}
-            onSaveColumns={onSaveColumns}
+            {...tableColumnProps}
             extensionContext={extensionContext}
           />
         </CardContent>
@@ -832,7 +849,7 @@ export function SqlChartCard({
                 reportScreenshot={reportScreenshot}
                 refreshToken={refreshToken}
                 onRefreshRequested={handleRefresh}
-                onSaveColumns={onSaveColumns}
+                {...tableColumnProps}
                 dashboardId={dashboardId}
                 extensionContext={extensionContext}
               />