@ai-matrx/design-system 0.31.0 → 0.34.0

package/dist/index.d.cts

@@ -1469,6 +1469,62 @@ declare const SheetFooter: {
 };
 declare const SheetTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
 
+/**
+ * OrganizationPicker — THE ONE "which organization am I acting in" control,
+ * identical on every Matrx surface (the main app's user menu and header nudge,
+ * Workflow Studio's sidebar, the admin dashboard's settings).
+ *
+ * Ported from matrx-frontend `features/organizations/components/
+ * OrganizationPickerPanel.tsx` + `UserMenuOrgSection.tsx` + `DefaultOrgSwitch.tsx`
+ * (2026-09-08), which until then were the ONLY surfaces with the full picker;
+ * Studio and the dashboard each had a bare `<Select>` with different copy,
+ * different placement and no default control. Three UIs for one fact.
+ *
+ * WHAT IT SAYS, IN WORDS (the rule the origin learned the hard way, five
+ * reports across three rounds): the panel states which organization is
+ * ACTIVE — "Working in Acme" — because a check mark and an accent colour are
+ * not an answer to "which one am I in", and the default switch's sentence is
+ * about STARTUP, not about now. A control whose only sentence describes a
+ * different fact than the one the reader is looking for lies by omission.
+ *
+ * It is PRESENTATIONAL. The host supplies the memberships, the active id, the
+ * default id, and two callbacks; it owns no fetch, no storage, no resolution.
+ * The resolution order (this device's stored selection → sole membership →
+ * make the person pick) and the shared cookie that carries the stored
+ * selection live in the host's org-context module and `@ai-matrx/data/db`'s
+ * `createActiveOrgCookie`. Persistence boundary (C10): none.
+ *
+ * 🚨 THE STAR DOES NOT PICK AN ORGANIZATION, AND MUST NOT SAY IT DOES.
+ * Until 2026-09-21 this switch read "Set as my default" and promised "Next
+ * startup opens Acme" / "Auto-select this at startup". That stopped being true
+ * on 2026-09-19, when the owner deleted the durable-default rung from the
+ * resolver — "a default organization is at most a per-client DISPLAY
+ * preference; the org picker may show it and nothing else may read it" — and
+ * nobody changed the words. Crew D2 met exactly that on 2026-09-21: the
+ * selection gone on a fresh browser profile "with no persistence despite a
+ * 'Set as my default' toggle implying it should stick". A control wearing a
+ * false sentence is the one thing a screen may never do, so the switch now
+ * says the thing it actually does — and DOES it: the starred organization is
+ * drawn first, which is what a star is for in Slack and in Linear, and which
+ * is the difference between finding your own workspace instantly and hunting
+ * it among ninety.
+ *
+ * 🚨 A HUNDRED ROWS IS NOT A LIST (VERIFIER-8 MEDIUM-3, 2026-09-21).
+ * The first screen of the data product offered the admin account's 116
+ * organizations nine at a time, with no search, most of them lane fixtures.
+ * Three things answer that, and all three are here rather than in one host:
+ *   • SEARCH over name and abbreviation, once the list passes eight rows.
+ *   • TEST ORGANIZATIONS HIDDEN by default behind the platform's one
+ *     archive-style disclosure (`ArchivedDisclosure`), with their count always
+ *     on screen. Hidden, never dropped.
+ *   • THE PERSON'S OWN organizations drawn first, under the starred one.
+ * The host classifies (`isTestFixture`, `isOwn`); this component decides
+ * nothing about a name it is given.
+ *
+ * Seam inversions from the origin: lucide `Check`/`Star` become package
+ * SVGs (C19); the host `Switch` becomes this package's; `cn` is local.
+ */
+
 interface OrganizationPickerOrganization {
     id: string;
     name: string;
@@ -1491,6 +1547,27 @@ interface OrganizationPickerOrganization {
      * was, because a second line under every row is noise a person learns to skip.
      */
     distinguisher?: string | null;
+    /**
+     * This organization is a TEST FIXTURE — a lane's scratch organization, not a
+     * business anybody works in. Classified in `iam.organizations.settings`
+     * (`test_fixture`), never guessed from its name.
+     *
+     * 🚨 WHY (VERIFIER-8 MEDIUM-3, 2026-09-21). The admin account belongs to 116
+     * organizations and 59 of them are fixtures. The first screen of the data
+     * product offered all of them, nine at a time, with no search — so the two
+     * or three a person actually works in were buried under lane debris. The
+     * archived-items law already answers this shape everywhere else in the
+     * platform: hide by default, ONE disclosure to reveal, and the count of what
+     * is hidden is always on screen. It is hidden, never dropped: a fixture the
+     * person genuinely wants is one click away.
+     */
+    isTestFixture?: boolean;
+    /**
+     * The signed-in person created this organization. Drawn before the rest,
+     * under the starred one — the same reason Slack puts your own workspace
+     * first: in a list of a hundred, yours must not be something you search for.
+     */
+    isOwn?: boolean;
 }
 interface OrganizationPickerProps {
     organizations: readonly OrganizationPickerOrganization[];

package/dist/index.d.ts

@@ -1469,6 +1469,62 @@ declare const SheetFooter: {
 };
 declare const SheetTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
 
+/**
+ * OrganizationPicker — THE ONE "which organization am I acting in" control,
+ * identical on every Matrx surface (the main app's user menu and header nudge,
+ * Workflow Studio's sidebar, the admin dashboard's settings).
+ *
+ * Ported from matrx-frontend `features/organizations/components/
+ * OrganizationPickerPanel.tsx` + `UserMenuOrgSection.tsx` + `DefaultOrgSwitch.tsx`
+ * (2026-09-08), which until then were the ONLY surfaces with the full picker;
+ * Studio and the dashboard each had a bare `<Select>` with different copy,
+ * different placement and no default control. Three UIs for one fact.
+ *
+ * WHAT IT SAYS, IN WORDS (the rule the origin learned the hard way, five
+ * reports across three rounds): the panel states which organization is
+ * ACTIVE — "Working in Acme" — because a check mark and an accent colour are
+ * not an answer to "which one am I in", and the default switch's sentence is
+ * about STARTUP, not about now. A control whose only sentence describes a
+ * different fact than the one the reader is looking for lies by omission.
+ *
+ * It is PRESENTATIONAL. The host supplies the memberships, the active id, the
+ * default id, and two callbacks; it owns no fetch, no storage, no resolution.
+ * The resolution order (this device's stored selection → sole membership →
+ * make the person pick) and the shared cookie that carries the stored
+ * selection live in the host's org-context module and `@ai-matrx/data/db`'s
+ * `createActiveOrgCookie`. Persistence boundary (C10): none.
+ *
+ * 🚨 THE STAR DOES NOT PICK AN ORGANIZATION, AND MUST NOT SAY IT DOES.
+ * Until 2026-09-21 this switch read "Set as my default" and promised "Next
+ * startup opens Acme" / "Auto-select this at startup". That stopped being true
+ * on 2026-09-19, when the owner deleted the durable-default rung from the
+ * resolver — "a default organization is at most a per-client DISPLAY
+ * preference; the org picker may show it and nothing else may read it" — and
+ * nobody changed the words. Crew D2 met exactly that on 2026-09-21: the
+ * selection gone on a fresh browser profile "with no persistence despite a
+ * 'Set as my default' toggle implying it should stick". A control wearing a
+ * false sentence is the one thing a screen may never do, so the switch now
+ * says the thing it actually does — and DOES it: the starred organization is
+ * drawn first, which is what a star is for in Slack and in Linear, and which
+ * is the difference between finding your own workspace instantly and hunting
+ * it among ninety.
+ *
+ * 🚨 A HUNDRED ROWS IS NOT A LIST (VERIFIER-8 MEDIUM-3, 2026-09-21).
+ * The first screen of the data product offered the admin account's 116
+ * organizations nine at a time, with no search, most of them lane fixtures.
+ * Three things answer that, and all three are here rather than in one host:
+ *   • SEARCH over name and abbreviation, once the list passes eight rows.
+ *   • TEST ORGANIZATIONS HIDDEN by default behind the platform's one
+ *     archive-style disclosure (`ArchivedDisclosure`), with their count always
+ *     on screen. Hidden, never dropped.
+ *   • THE PERSON'S OWN organizations drawn first, under the starred one.
+ * The host classifies (`isTestFixture`, `isOwn`); this component decides
+ * nothing about a name it is given.
+ *
+ * Seam inversions from the origin: lucide `Check`/`Star` become package
+ * SVGs (C19); the host `Switch` becomes this package's; `cn` is local.
+ */
+
 interface OrganizationPickerOrganization {
     id: string;
     name: string;
@@ -1491,6 +1547,27 @@ interface OrganizationPickerOrganization {
      * was, because a second line under every row is noise a person learns to skip.
      */
     distinguisher?: string | null;
+    /**
+     * This organization is a TEST FIXTURE — a lane's scratch organization, not a
+     * business anybody works in. Classified in `iam.organizations.settings`
+     * (`test_fixture`), never guessed from its name.
+     *
+     * 🚨 WHY (VERIFIER-8 MEDIUM-3, 2026-09-21). The admin account belongs to 116
+     * organizations and 59 of them are fixtures. The first screen of the data
+     * product offered all of them, nine at a time, with no search — so the two
+     * or three a person actually works in were buried under lane debris. The
+     * archived-items law already answers this shape everywhere else in the
+     * platform: hide by default, ONE disclosure to reveal, and the count of what
+     * is hidden is always on screen. It is hidden, never dropped: a fixture the
+     * person genuinely wants is one click away.
+     */
+    isTestFixture?: boolean;
+    /**
+     * The signed-in person created this organization. Drawn before the rest,
+     * under the starred one — the same reason Slack puts your own workspace
+     * first: in a list of a hundred, yours must not be something you search for.
+     */
+    isOwn?: boolean;
 }
 interface OrganizationPickerProps {
     organizations: readonly OrganizationPickerOrganization[];