@agent-native/core-corpus 0.211.0 → 0.212.0-nightly-20261021010049

package/corpus/README.md

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

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

@@ -375,9 +375,11 @@ its owner organization's. Read them with `list-data-notes`, passing
   inside the chart, and a hoverable title. Rows sorted by something other than
   date shade each run of the note's rows, never a row between them, under one
   title. Incidents are red; open data problems amber; fixed data problems grey.
-  Other charts flag the note by the title and write it under the chart while it
-  is ongoing or ended in the last 30 days, as does a time chart whose x values
-  aren't dates.
+  Other charts, and a time chart whose x values aren't dates, flag the note by
+  the title and write it under the chart when its dates overlap the chart's
+  time range: the panel's own range if it overrides the dashboard's. A chart
+  whose SQL has no time range, or one the app can't read such as a quarter its
+  SQL works out, does so while the note is ongoing or ended in the last 30 days.
 - A dashboard hides a note on one chart with
   `setDashboard({ annotations: { hiddenDataNotes: [{ noteId, panelId }, ...] } })`,
   listing the notes already hidden that stay hidden; `hiddenKeyDateSets` is kept.
@@ -425,7 +427,7 @@ means the list was cut to fit, so read `list-key-dates` or `list-data-notes`
 with `dashboardId` before saying a marker isn't there. `keyDatesHint` means no
 chart on the dashboard draws key dates, so don't cite one there. A note's `panelIds` are the charts it is
 on, but a time chart draws it only over the dates it plots (and, if its x
-values aren't dates, only while the note is recent), so cite it for a change
+values aren't dates, only when they overlap its time range), so cite it for a change
 only when the change falls within the note's dates. `editable: false` means
 they are the owner organization's, so cite them but don't change them.
 
@@ -651,7 +653,7 @@ Use conditional blocks for optional filters:
 
 An unwrapped `{{<id>:list}}` with no selection fails the query on purpose. Option values must not contain commas.
 
-To offer a named group of values, give the multi-select `presets`, such as `"presets": [{ "label": "Launch apps", "values": ["clips", "slides", "design"] }]`. Each preset shows as a button beside Select all in the dropdown, and picking it replaces only that filter's selection, so the other filters keep their values. Every value must be one of the filter's options. Use a preset rather than a saved view when the user wants a shortcut for one filter: a saved view replaces every filter. In Edit mode, people add presets themselves: checking two or more values that no preset matches offers Save as group at the bottom of the dropdown, which appends the same `presets` entry, so treat a preset you did not write as someone's saved choice and keep it unless asked.
+To offer a named group of values, give the multi-select `presets`, such as `"presets": [{ "label": "Launch apps", "values": ["clips", "slides", "design"] }]`. Each preset shows as a button beside Select all in the dropdown, and picking it replaces only that filter's selection, so the other filters keep their values. Every value must be one of the filter's options. Use a preset rather than a saved view when the user wants a shortcut for one filter: a saved view replaces every filter. In Edit mode, people manage presets themselves at the bottom of the dropdown: checking two or more values that no preset matches offers Save as group, which appends the same `presets` entry, and a selection that matches a preset offers Rename group and Delete group for that entry. Treat a preset you did not write as someone's saved choice and keep it unless asked.
 
 Filters auto-apply on change — there is no Apply button. Each filter change writes to the URL and re-runs the affected panels. Other filters are preserved (the URL update is functional, not destructive). If you see a filter "reset" itself when another filter changes, look for a duplicate `id` first.
 

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","content-metrics-collection-jobs","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/actions/save-data-note.ts

@@ -23,7 +23,7 @@ export default defineAction({
     openWorldHint: false,
   },
   description:
-    'Add a data note, or change the given fields of one by id. A data note explains a stretch of data on charts: kind "data" for tracking problems such as an undercount, a gap, or a renamed event, kind "incident" for a product outage. It draws as a shaded band over its dates on time charts (red for incidents, amber for open data problems, grey once fixed) and as a line under charts without a date axis. It shows on every chart whose SQL filters on one of matchEvents, unless the SQL also filters on one of unlessEvents (the replacement event that covers the gap), and on the charts listed in panels. Leave endDate empty while the problem is ongoing; mark it fixed with status "fixed", endDate, and fix. State facts the data shows; leave out causes nobody has confirmed. Pass dashboardId for the dashboard on screen: then `dashboard.shownOn` in the result lists the charts there the note is on (a time chart draws it only over the dates it plots, and only while it is recent if its x values are not dates), and `hint` says why when it is on none.',
+    'Add a data note, or change the given fields of one by id. A data note explains a stretch of data on charts: kind "data" for tracking problems such as an undercount, a gap, or a renamed event, kind "incident" for a product outage. It draws as a shaded band over its dates on time charts (red for incidents, amber for open data problems, grey once fixed) and as a line under a chart without a date axis when its dates overlap the time range the chart shows. It shows on every chart whose SQL filters on one of matchEvents, unless the SQL also filters on one of unlessEvents (the replacement event that covers the gap), and on the charts listed in panels. Leave endDate empty while the problem is ongoing; mark it fixed with status "fixed", endDate, and fix. State facts the data shows; leave out causes nobody has confirmed. Pass dashboardId for the dashboard on screen: then `dashboard.shownOn` in the result lists the charts there the note is on at the default time range of the dashboard (a time chart draws it only over the dates it plots), and `hint` says why when it is on none.',
   schema: z.object({
     id: z
       .string()

package/corpus/templates/analytics/actions/view-screen.ts

@@ -229,6 +229,7 @@ export default defineAction({
                   { scope: { email, orgId }, editable: true },
                   nav.dashboardId,
                   builtin.config,
+                  url?.searchParams,
                 ),
               }),
               SCREEN_DASHBOARD_CHAR_BUDGET,
@@ -256,6 +257,7 @@ export default defineAction({
                         }),
                         dashboard.id,
                         dashboard.config as Record<string, unknown>,
+                        url?.searchParams,
                       )
                     : undefined,
               }),

package/corpus/templates/analytics/app/components/AnalyticsReviewArtifactPreview.tsx

@@ -9,6 +9,7 @@ import { isValidPanelEvent } from "@shared/panel-events";
 import { useEffect, useMemo, useRef, useState } from "react";
 
 import { ResolvedAnnotationsProvider } from "@/components/dashboard/dashboard-annotations-context";
+import { DataNoteRangeProvider } from "@/components/dashboard/data-note-bands";
 import { SqlChart } from "@/components/dashboard/SqlChart";
 import Markdown from "@/components/Markdown";
 import type { SqlQueryResult } from "@/lib/sql-query";
@@ -17,7 +18,10 @@ import {
   reviewDashboardFilters,
   reviewDashboardVariables,
 } from "@/pages/adhoc/sql-dashboard/filter-vars";
-import { interpolateDashboardPanelSql } from "@/pages/adhoc/sql-dashboard/interpolate";
+import {
+  interpolateDashboardPanelSql,
+  panelTimeRange,
+} from "@/pages/adhoc/sql-dashboard/interpolate";
 import { serializePanelSql } from "@/pages/adhoc/sql-dashboard/panel-sql";
 import { timeRangeDays } from "@/pages/adhoc/sql-dashboard/pivot";
 import type {
@@ -355,15 +359,17 @@ function ReviewDashboardPanel({
       {!compact && (
         <h3 className="mb-2 truncate text-sm font-medium">{panel.title}</h3>
       )}
-      <SqlChart
-        panel={panel}
-        resolvedSql={resolvedSql}
-        timeRange={timeRangeDays(variables.timeRange)}
-        loadData={false}
-        resultOverride={result}
-        showLoadingWhenDisabled={false}
-        dashboardId={artifactId}
-      />
+      <DataNoteRangeProvider value={panelTimeRange(panel, variables)}>
+        <SqlChart
+          panel={panel}
+          resolvedSql={resolvedSql}
+          timeRange={timeRangeDays(variables.timeRange)}
+          loadData={false}
+          resultOverride={result}
+          showLoadingWhenDisabled={false}
+          dashboardId={artifactId}
+        />
+      </DataNoteRangeProvider>
     </div>
   );
 }

package/corpus/templates/analytics/app/components/dashboard/data-note-bands.tsx

@@ -36,6 +36,7 @@ import {
   HoverCardContent,
   HoverCardTrigger,
 } from "@/components/ui/hover-card";
+import type { PanelTimeRange } from "@/pages/adhoc/sql-dashboard/interpolate";
 
 import { isPendingAnnotation } from "./annotation-mutations";
 import { useChartHoverCardOpen } from "./chart-hover-card";
@@ -225,6 +226,13 @@ const UnplacedDataNotesContext = createContext<
 /** Hears which notes a time chart writes under its plot, so its card can flag them by the title. */
 export const UnplacedDataNotesListener = UnplacedDataNotesContext.Provider;
 
+const DataNoteRangeContext = createContext<PanelTimeRange>({
+  kind: "absent",
+});
+
+/** The dates a card's query covers, so a chart whose x values aren't dates lists the notes in them. */
+export const DataNoteRangeProvider = DataNoteRangeContext.Provider;
+
 /**
  * Where each note falls on a chart's x values: bands over the dates it
  * covers, or a line under the chart when it can't be placed on them.
@@ -234,12 +242,13 @@ export function useDataNoteLayout(
   rows: readonly Record<string, unknown>[],
   xKey: string,
 ): { shaded: ShadedDataNote[]; unplaced: DataNote[] } {
+  const range = useContext(DataNoteRangeContext);
   const layout = useMemo(() => {
     if (notes.length === 0) return { shaded: [], unplaced: [] };
     const shown = dataNotesOnChart(
       notes,
       rows.map((row) => row[xKey]),
-      { xKey },
+      { xKey, range },
     );
     return {
       shaded: shown.filter(({ bands }) => bands.length > 0),
@@ -247,7 +256,7 @@ export function useDataNoteLayout(
         bands.length > 0 ? [] : [note],
       ),
     };
-  }, [notes, rows, xKey]);
+  }, [notes, rows, xKey, range]);
   const listen = useContext(UnplacedDataNotesContext);
   useEffect(() => {
     if (!listen) return;

package/corpus/templates/analytics/app/components/dashboard/event-markers.tsx

@@ -6,7 +6,7 @@ import {
   type PanelEventGroup,
 } from "@shared/panel-events";
 import { useMemo, type ReactNode } from "react";
-import { ReferenceLine } from "recharts";
+import { DefaultZIndexes, ReferenceLine, ZIndexLayer } from "recharts";
 
 import {
   HoverCard,
@@ -19,6 +19,12 @@ import { useChartHoverCardOpen } from "./chart-hover-card";
 const DEFAULT_EVENT_COLOR = "hsl(var(--foreground))";
 /** How far a marker's hover target reaches from its x, the widest part of it. */
 const MARKER_REACH = 11;
+/**
+ * Above the cursor line and dots Recharts draws on the hovered day. In the
+ * reference line's own layer, a dot on the x-axis covered the marker and took
+ * its hover.
+ */
+const MARKER_Z_INDEX = DefaultZIndexes.activeDot + 1;
 
 interface MarkerViewBox {
   x?: number;
@@ -45,73 +51,80 @@ function EventMarkerBadge({
   const cy = viewBox.y + viewBox.height;
   const headerDate = group.events[0].date;
   return (
-    // The card renders in a portal: drawn inside the SVG it was clipped at
-    // the chart's edges and painted under series dots.
-    <HoverCard open={open} onOpenChange={setOpen} openDelay={0} closeDelay={80}>
-      <HoverCardTrigger asChild>
-        <g
-          data-event-marker=""
-          style={{ cursor: "default" }}
-          onMouseMove={(e) => e.stopPropagation()}
-        >
-          <circle cx={cx} cy={cy} r={11} fill="transparent" />
-          {group.events.length > 1 && (
+    <ZIndexLayer zIndex={MARKER_Z_INDEX}>
+      {/* The card renders in a portal: drawn inside the SVG it was clipped at
+        the chart's edges and painted under series dots. */}
+      <HoverCard
+        open={open}
+        onOpenChange={setOpen}
+        openDelay={0}
+        closeDelay={80}
+      >
+        <HoverCardTrigger asChild>
+          <g
+            data-event-marker=""
+            style={{ cursor: "default" }}
+            onMouseMove={(e) => e.stopPropagation()}
+          >
+            <circle cx={cx} cy={cy} r={11} fill="transparent" />
+            {group.events.length > 1 && (
+              <circle
+                cx={cx}
+                cy={cy}
+                r={9}
+                fill="none"
+                stroke={color}
+                strokeOpacity={0.45}
+                strokeWidth={1.5}
+              />
+            )}
             <circle
               cx={cx}
               cy={cy}
-              r={9}
-              fill="none"
-              stroke={color}
-              strokeOpacity={0.45}
-              strokeWidth={1.5}
+              r={6}
+              fill={color}
+              stroke="hsl(var(--background))"
+              strokeWidth={2}
             />
-          )}
-          <circle
-            cx={cx}
-            cy={cy}
-            r={6}
-            fill={color}
-            stroke="hsl(var(--background))"
-            strokeWidth={2}
-          />
-        </g>
-      </HoverCardTrigger>
-      {/* Markers sit on the x-axis, so the card opens up over the chart, as a
+          </g>
+        </HoverCardTrigger>
+        {/* Markers sit on the x-axis, so the card opens up over the chart, as a
           data note's opens down from its pill. */}
-      <HoverCardContent
-        side="top"
-        collisionPadding={8}
-        className="w-auto max-w-72 p-2.5 text-xs"
-      >
-        <div className="mb-1.5 text-[11px] text-muted-foreground">
-          {formatPanelEventDate(headerDate)}
-        </div>
-        <ul className="space-y-1">
-          {group.events.map((event, index) => {
-            const when = formatPanelEventWhen(event, headerDate);
-            return (
-              <li
-                key={`${event.date}-${event.time ?? ""}-${index}`}
-                className="flex items-center gap-2"
-              >
-                <span
-                  className="size-2 shrink-0 rounded-full"
-                  style={{ background: event.color ?? DEFAULT_EVENT_COLOR }}
-                />
-                <span className="font-medium text-popover-foreground">
-                  {event.label}
-                </span>
-                {when && (
-                  <span className="ml-auto pl-3 tabular-nums text-muted-foreground">
-                    {when}
+        <HoverCardContent
+          side="top"
+          collisionPadding={8}
+          className="w-auto max-w-72 p-2.5 text-xs"
+        >
+          <div className="mb-1.5 text-[11px] text-muted-foreground">
+            {formatPanelEventDate(headerDate)}
+          </div>
+          <ul className="space-y-1">
+            {group.events.map((event, index) => {
+              const when = formatPanelEventWhen(event, headerDate);
+              return (
+                <li
+                  key={`${event.date}-${event.time ?? ""}-${index}`}
+                  className="flex items-center gap-2"
+                >
+                  <span
+                    className="size-2 shrink-0 rounded-full"
+                    style={{ background: event.color ?? DEFAULT_EVENT_COLOR }}
+                  />
+                  <span className="font-medium text-popover-foreground">
+                    {event.label}
                   </span>
-                )}
-              </li>
-            );
-          })}
-        </ul>
-      </HoverCardContent>
-    </HoverCard>
+                  {when && (
+                    <span className="ml-auto pl-3 tabular-nums text-muted-foreground">
+                      {when}
+                    </span>
+                  )}
+                </li>
+              );
+            })}
+          </ul>
+        </HoverCardContent>
+      </HoverCard>
+    </ZIndexLayer>
   );
 }
 

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

@@ -887,6 +887,8 @@ export default {
     groupName: "Group name",
     saveForEveryone: "Save for everyone",
     groupNameTaken: "A group with this name already exists",
+    renameGroup: "Rename group…",
+    deleteGroup: "Delete group",
     untitledDashboard: "Untitled Dashboard",
     dashboardFallback: "dashboard",
     viewOnly: "You have view-only access to this dashboard.",