@stigmer/react 3.10.0 → 3.11.1-dev.20260812192248

package/src/schedule/__tests__/cadence-tooltips.layout.test.tsx

@@ -0,0 +1,86 @@
+// The disabled-control tooltip contract from the native-title sweep
+// (stigmer-cloud#268), pinned in a real Chromium on CadenceField's
+// weekday toggles — the sweep's canonical "explanation on a disabled
+// control" site. Browsers suppress pointer events on disabled form
+// controls, so the old native `title` was unreachable by EVERY input
+// method exactly when it mattered (the always-disabled last selected
+// day). The fix hangs the house tooltip off a wrapper span; this suite
+// proves a mouse user really gets the reason while the button is
+// disabled.
+
+import "../../../dist/styles.css";
+
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { render, cleanup } from "@testing-library/react";
+import { userEvent } from "@vitest/browser/context";
+import { CadenceField } from "../CadenceField.js";
+
+function renderWeekly() {
+  const pane = document.createElement("div");
+  pane.className = "stgm";
+  pane.style.width = "480px";
+  document.body.appendChild(pane);
+  render(
+    <CadenceField
+      value={{ kind: "weekly", days: [1], hour: 9, minute: 0 }}
+      onChange={() => {}}
+    />,
+    { container: pane },
+  );
+  return pane;
+}
+
+afterEach(() => {
+  cleanup();
+  document.querySelectorAll(".stgm").forEach((node) => node.remove());
+});
+
+describe("CadenceField disabled-day tooltip", () => {
+  it("explains the locked last-selected day on hover while the button is disabled", async () => {
+    const pane = renderWeekly();
+    expect(pane.querySelector("[title]")).toBeNull();
+
+    const monday = Array.from(pane.querySelectorAll("button")).find(
+      (el) => el.getAttribute("aria-label") === "Monday",
+    );
+    expect(monday!.disabled).toBe(true);
+
+    // Hover the wrapper span — the disabled button itself receives no
+    // pointer events, which is the entire reason the wrapper exists.
+    const wrapper = monday!.parentElement!;
+    await userEvent.hover(wrapper);
+    await vi.waitFor(
+      () => {
+        const portaled = Array.from(document.body.children)
+          .filter((node) => node !== pane)
+          .map((node) => node.textContent ?? "")
+          .join(" ");
+        expect(portaled).toContain("A weekly schedule needs at least one day");
+      },
+      { timeout: 3000, interval: 50 },
+    );
+    await userEvent.unhover(wrapper);
+  });
+
+  it("names an enabled weekday on hover", async () => {
+    const pane = renderWeekly();
+
+    const tuesday = Array.from(pane.querySelectorAll("button")).find(
+      (el) => el.getAttribute("aria-label") === "Tuesday",
+    );
+    expect(tuesday!.disabled).toBe(false);
+
+    await userEvent.hover(tuesday!.parentElement!);
+    await vi.waitFor(
+      () => {
+        const portaled = Array.from(document.body.children)
+          .filter((node) => node !== pane)
+          .map((node) => node.textContent ?? "")
+          .join(" ");
+        expect(portaled).toContain("Tuesday");
+      },
+      { timeout: 3000, interval: 50 },
+    );
+    await userEvent.unhover(tuesday!.parentElement!);
+  });
+});

package/src/schedule/__tests__/scheduleCreation.test.tsx

@@ -21,13 +21,6 @@ import { CadenceField } from "../CadenceField";
 import { ScheduleForm } from "../ScheduleForm";
 import type { CadencePreset } from "../cadence";
 
-// Without a StigmerProvider the portal container is null, and Base UI's
-// Portal renders nothing — pin it to document.body so the agent-picker
-// popover mounts.
-vi.mock("../../portal-container", () => ({
-  useStigmerPortalContainer: () => document.body,
-}));
-
 // Base UI's Popover positioner observes its anchor; happy-dom lacks
 // ResizeObserver, so provide a no-op shim.
 beforeAll(() => {

package/src/schedule/scheduleColumns.tsx

@@ -40,7 +40,7 @@ export function createScheduleColumns(
       id: "name",
       header: "Name",
       cell: (item) => (
-        <span className="font-medium text-foreground">
+        <span className="stg:font-medium stg:text-foreground">
           {item.metadata?.name || item.metadata?.slug}
         </span>
       ),
@@ -59,11 +59,11 @@ export function createScheduleColumns(
       id: "cron",
       header: "Cadence",
       cell: (item) => (
-        <span className="inline-flex items-baseline gap-1.5">
-          <code className="font-mono text-xs text-foreground">
+        <span className="stg:inline-flex stg:items-baseline stg:gap-1.5">
+          <code className="stg:font-mono stg:text-xs stg:text-foreground">
             {item.spec?.cron || "—"}
           </code>
-          <span className="text-xs text-muted-foreground">
+          <span className="stg:text-xs stg:text-muted-foreground">
             {item.spec?.timeZone}
           </span>
         </span>
@@ -77,7 +77,7 @@ export function createScheduleColumns(
         const info = deriveScheduleState(item.spec, item.status);
         const nextFireAt = item.status?.nextFireAt;
         return (
-          <span className="text-muted-foreground">
+          <span className="stg:text-muted-foreground">
             {info.state === "active" && nextFireAt
               ? formatNextFire(timestampDate(nextFireAt), now())
               : "—"}
@@ -90,7 +90,7 @@ export function createScheduleColumns(
       id: "last-run",
       header: "Last run",
       cell: (item) => (
-        <span className="text-muted-foreground">
+        <span className="stg:text-muted-foreground">
           {item.status?.lastFireAt
             ? formatRelativeTime(timestampDate(item.status.lastFireAt), now())
             : "Never"}
@@ -105,7 +105,7 @@ export function createScheduleColumns(
         const target =
           item.spec?.target?.case === "agent" ? item.spec.target.value : undefined;
         return (
-          <span className="text-muted-foreground">
+          <span className="stg:text-muted-foreground">
             {target?.agentRef
               ? `${target.agentRef.org}/${target.agentRef.slug}`
               : "—"}

package/src/session/NewSessionViewer.tsx

@@ -327,9 +327,9 @@ export function NewSessionViewer({
     // Do NOT reintroduce a context-driven position flip: the composer must not
     // move as context is attached (DD-16's layout-stability rationale — chrome
     // that shifts with attached context reads as instability).
-    <div className="flex h-full flex-col items-center overflow-y-auto px-4 py-6">
-      <div className="my-auto w-full max-w-2xl space-y-6">
-        <h1 className="text-center text-lg font-medium text-foreground">
+    <div className="stg:flex stg:h-full stg:flex-col stg:items-center stg:overflow-y-auto stg:px-4 stg:py-6">
+      <div className="stg:my-auto stg:w-full stg:max-w-2xl stg:space-y-6">
+        <h1 className="stg:text-center stg:text-lg stg:font-medium stg:text-foreground">
           {heading}
         </h1>
 
@@ -374,7 +374,7 @@ export function NewSessionViewer({
 
         {footerContent}
 
-        <p className="text-center text-[0.65rem] text-muted-foreground">
+        <p className="stg:text-center stg:text-[0.65rem] stg:text-muted-foreground">
           Press Enter to send, Shift+Enter for a new line
         </p>
       </div>
@@ -428,7 +428,7 @@ export function NewSessionViewer({
             onCloseEditor={panel.closeEditor}
             onCollapse={panel.closePanel}
             reveal={activeReveal}
-            className="h-full"
+            className="stg:h-full"
           />
         ) : null
       }

package/src/session/PlanEditor.tsx

@@ -109,14 +109,14 @@ export function PlanEditor({
   if (error || effectiveText === null) {
     return (
       <PlanEditorFrame>
-        <div className="flex flex-col items-center gap-2 px-4 py-8 text-center">
-          <p className="text-xs text-muted-foreground">
+        <div className="stg:flex stg:flex-col stg:items-center stg:gap-2 stg:px-4 stg:py-8 stg:text-center">
+          <p className="stg:text-xs stg:text-muted-foreground">
             Couldn&rsquo;t load the plan{error ? `: ${error.message}` : "."}
           </p>
           <button
             type="button"
             onClick={refetch}
-            className="rounded text-xs font-medium text-foreground underline-offset-2 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+            className="stg:rounded stg:text-xs stg:font-medium stg:text-foreground stg:underline-offset-2 stg:hover:underline stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring"
           >
             Retry
           </button>
@@ -131,9 +131,9 @@ export function PlanEditor({
           Narrow panes are first-class: rows wrap (flex-wrap) and every item
           can shrink (min-w-0 + truncating labels), so the toolbar reflows
           instead of forcing the document pane to scroll sideways. */}
-      <div className="flex min-w-0 flex-wrap items-center gap-2">
+      <div className="stg:flex stg:min-w-0 stg:flex-wrap stg:items-center stg:gap-2">
         <div
-          className="inline-flex shrink-0 rounded-md bg-muted p-0.5"
+          className="stg:inline-flex stg:shrink-0 stg:rounded-md stg:bg-muted stg:p-0.5"
           role="tablist"
           aria-label="Plan view"
         >
@@ -153,28 +153,32 @@ export function PlanEditor({
               onClick={() => setView("edit")}
               label="Edit"
               disabled={!canEdit}
-              title={
-                !canEdit
-                  ? "This plan is too large to edit in place — download it instead."
-                  : undefined
-              }
             />
           )}
         </div>
-        <span className="text-[0.65rem] tabular-nums text-muted-foreground-faint">
+        <span className="stg:text-[0.65rem] stg:tabular-nums stg:text-muted-foreground-faint">
           {formatArtifactSize(plan.artifact.sizeBytes)}
         </span>
+        {/* The reason the Edit tab is disabled must be visible text: a
+            disabled tab leaves the tab order and drops pointer events, so
+            no hover- or focus-dependent hint can ever reach the user who
+            needs it. */}
+        {activeDraft !== undefined && !canEdit && (
+          <span className="stg:min-w-0 stg:text-[0.65rem] stg:text-muted-foreground">
+            This plan is too large to edit in place — download it instead.
+          </span>
+        )}
 
-        <div className="ml-auto flex min-w-0 flex-wrap items-center gap-3">
+        <div className="stg:ml-auto stg:flex stg:min-w-0 stg:flex-wrap stg:items-center stg:gap-3">
           {activeDraft?.isEdited && (
-            <span className="inline-flex items-center gap-2">
-              <span className="rounded-md bg-accent px-1.5 py-0.5 text-[0.65rem] font-medium text-muted-foreground">
+            <span className="stg:inline-flex stg:items-center stg:gap-2">
+              <span className="stg:rounded-md stg:bg-accent stg:px-1.5 stg:py-0.5 stg:text-[0.65rem] stg:font-medium stg:text-muted-foreground">
                 Edited
               </span>
               <button
                 type="button"
                 onClick={() => activeDraft.setDraft(null)}
-                className="rounded text-[0.65rem] font-medium text-muted-foreground underline-offset-2 hover:text-foreground hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                className="stg:rounded stg:text-[0.65rem] stg:font-medium stg:text-muted-foreground stg:underline-offset-2 stg:hover:text-foreground stg:hover:underline stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring"
               >
                 Revert
               </button>
@@ -183,7 +187,7 @@ export function PlanEditor({
           {readOnly ? (
             <span
               role="status"
-              className="rounded-md bg-muted px-2 py-0.5 text-[0.65rem] font-medium text-muted-foreground"
+              className="stg:rounded-md stg:bg-muted stg:px-2 stg:py-0.5 stg:text-[0.65rem] stg:font-medium stg:text-muted-foreground"
             >
               Superseded by a newer plan
             </span>
@@ -194,15 +198,15 @@ export function PlanEditor({
                 disabled={buildDisabled}
                 onClick={onBuildFromPlan}
                 className={cn(
-                  "inline-flex min-w-0 items-center gap-1.5 rounded-md px-3 py-1.5",
-                  "text-xs font-medium transition-colors",
-                  "bg-primary text-primary-foreground hover:bg-primary-hover",
-                  "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
-                  "disabled:pointer-events-none disabled:opacity-50",
+                  "stg:inline-flex stg:min-w-0 stg:items-center stg:gap-1.5 stg:rounded-md stg:px-3 stg:py-1.5",
+                  "stg:text-xs stg:font-medium stg:transition-colors",
+                  "stg:bg-primary stg:text-primary-foreground stg:hover:bg-primary-hover",
+                  "stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring",
+                  "stg:disabled:pointer-events-none stg:disabled:opacity-50",
                 )}
               >
                 <ImplementIcon />
-                <span className="truncate">
+                <span className="stg:truncate">
                   {buildDisabled ? "Starting build…" : "Build"}
                 </span>
               </button>
@@ -213,7 +217,7 @@ export function PlanEditor({
 
       {activeView === "rendered" && <RenderedPlan text={effectiveText} />}
       {activeView === "source" && (
-        <pre className="overflow-x-auto rounded-md bg-muted p-3 font-mono text-xs whitespace-pre-wrap text-foreground">
+        <pre className="stg:overflow-x-auto stg:rounded-md stg:bg-muted stg:p-3 stg:font-mono stg:text-xs stg:whitespace-pre-wrap stg:text-foreground">
           {effectiveText}
         </pre>
       )}
@@ -225,15 +229,15 @@ export function PlanEditor({
           spellCheck={false}
           rows={28}
           className={cn(
-            "w-full flex-1 resize-y rounded-md border border-border bg-card p-3",
-            "font-mono text-xs leading-relaxed text-foreground",
-            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+            "stg:w-full stg:flex-1 stg:resize-y stg:rounded-md stg:border stg:border-border stg:bg-card stg:p-3",
+            "stg:font-mono stg:text-xs stg:leading-relaxed stg:text-foreground",
+            "stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring",
           )}
         />
       )}
 
       {isTruncated && (
-        <p role="status" className="text-[0.65rem] text-muted-foreground">
+        <p role="status" className="stg:text-[0.65rem] stg:text-muted-foreground">
           Preview truncated — download the artifact for the full plan.
         </p>
       )}
@@ -257,7 +261,7 @@ function PlanEditorFrame({
       role="article"
       aria-label="Plan document"
       onKeyDown={onKeyDown}
-      className="mx-auto flex w-full max-w-3xl flex-col gap-3 px-4 py-3"
+      className="stg:mx-auto stg:flex stg:w-full stg:max-w-3xl stg:flex-col stg:gap-3 stg:px-4 stg:py-3"
     >
       {children}
     </div>
@@ -276,15 +280,15 @@ function RenderedPlan({ text }: { readonly text: string }) {
   );
 
   return (
-    <div className="overflow-hidden rounded-lg border border-border-muted bg-card">
+    <div className="stg:overflow-hidden stg:rounded-lg stg:border stg:border-border-muted stg:bg-card">
       {title && (
-        <header className="border-b border-border-muted bg-muted-faint px-4 py-2.5">
-          <span className="block truncate text-sm font-semibold text-foreground">
+        <header className="stg:border-b stg:border-border-muted stg:bg-muted-faint stg:px-4 stg:py-2.5">
+          <span className="stg:block stg:truncate stg:text-sm stg:font-semibold stg:text-foreground">
             {title}
           </span>
         </header>
       )}
-      <div className="stgm-prose px-4 py-4">
+      <div className="stgm-prose stg:px-4 stg:py-4">
         <Markdown
           remarkPlugins={REMARK_PLUGINS}
           components={PLAN_DOCUMENT_MARKDOWN_COMPONENTS}
@@ -298,11 +302,11 @@ function RenderedPlan({ text }: { readonly text: string }) {
 
 function PlanEditorSkeleton() {
   return (
-    <div className="space-y-2 py-2" aria-hidden="true">
-      <div className="h-8 w-full animate-pulse rounded-md bg-muted" />
-      <div className="h-4 w-2/3 animate-pulse rounded bg-muted" />
-      <div className="h-4 w-full animate-pulse rounded bg-muted" />
-      <div className="h-4 w-5/6 animate-pulse rounded bg-muted" />
+    <div className="stg:space-y-2 stg:py-2" aria-hidden="true">
+      <div className="stg:h-8 stg:w-full stg:animate-pulse stg:rounded-md stg:bg-muted" />
+      <div className="stg:h-4 stg:w-2/3 stg:animate-pulse stg:rounded stg:bg-muted" />
+      <div className="stg:h-4 stg:w-full stg:animate-pulse stg:rounded stg:bg-muted" />
+      <div className="stg:h-4 stg:w-5/6 stg:animate-pulse stg:rounded stg:bg-muted" />
     </div>
   );
 }
@@ -312,13 +316,11 @@ function ViewTab({
   onClick,
   label,
   disabled,
-  title,
 }: {
   readonly active: boolean;
   readonly onClick: () => void;
   readonly label: string;
   readonly disabled?: boolean;
-  readonly title?: string;
 }) {
   return (
     <button
@@ -327,14 +329,13 @@ function ViewTab({
       aria-selected={active}
       onClick={onClick}
       disabled={disabled}
-      title={title}
       className={cn(
-        "rounded px-2 py-0.5 text-[0.65rem] font-medium transition-colors",
-        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        "stg:rounded stg:px-2 stg:py-0.5 stg:text-[0.65rem] stg:font-medium stg:transition-colors",
+        "stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring",
         active
-          ? "bg-card text-foreground shadow-sm"
-          : "text-muted-foreground hover:text-foreground",
-        "disabled:pointer-events-none disabled:opacity-50",
+          ? "stg:bg-card stg:text-foreground stg:shadow-sm"
+          : "stg:text-muted-foreground stg:hover:text-foreground",
+        "stg:disabled:pointer-events-none stg:disabled:opacity-50",
       )}
     >
       {label}

package/src/session/PlanStreamingDocument.tsx

@@ -49,27 +49,27 @@ export function PlanStreamingDocument({
       role="article"
       aria-label="Plan document"
       aria-busy="true"
-      className="mx-auto flex w-full max-w-3xl flex-col gap-3 px-4 py-3"
+      className="stg:mx-auto stg:flex stg:w-full stg:max-w-3xl stg:flex-col stg:gap-3 stg:px-4 stg:py-3"
     >
-      <div className="flex min-w-0 flex-wrap items-center gap-2">
+      <div className="stg:flex stg:min-w-0 stg:flex-wrap stg:items-center stg:gap-2">
         <span
           role="status"
-          className="inline-flex items-center gap-1.5 rounded-md bg-muted px-2 py-0.5 text-[0.65rem] font-medium text-muted-foreground"
+          className="stg:inline-flex stg:items-center stg:gap-1.5 stg:rounded-md stg:bg-muted stg:px-2 stg:py-0.5 stg:text-[0.65rem] stg:font-medium stg:text-muted-foreground"
         >
           <WritingDot />
           Writing…
         </span>
       </div>
 
-      <div className="overflow-hidden rounded-lg border border-border-muted bg-card">
+      <div className="stg:overflow-hidden stg:rounded-lg stg:border stg:border-border-muted stg:bg-card">
         {title && (
-          <header className="border-b border-border-muted bg-muted-faint px-4 py-2.5">
-            <span className="block truncate text-sm font-semibold text-foreground">
+          <header className="stg:border-b stg:border-border-muted stg:bg-muted-faint stg:px-4 stg:py-2.5">
+            <span className="stg:block stg:truncate stg:text-sm stg:font-semibold stg:text-foreground">
               {title}
             </span>
           </header>
         )}
-        <div className="stgm-prose px-4 py-4">
+        <div className="stgm-prose stg:px-4 stg:py-4">
           <Streamdown
             components={PLAN_DOCUMENT_MARKDOWN_COMPONENTS}
             isAnimating
@@ -91,7 +91,7 @@ function WritingDot() {
   return (
     <span
       aria-hidden="true"
-      className="size-1.5 animate-pulse rounded-full bg-primary"
+      className="stg:size-1.5 stg:animate-pulse stg:rounded-full stg:bg-primary"
     />
   );
 }