@octaviaflow/core 3.1.0-beta.94 → 3.1.0-beta.96

package/dist/components/OrgSwitcher/OrgSwitcher.d.ts

@@ -0,0 +1,78 @@
+/**
+ * OrgSwitcher — move between the organizations a person belongs to.
+ *
+ * FOUR variants, because "switch org" is a different job depending on where it
+ * sits and how many orgs a person has. They are offered side by side so a
+ * product can pick the one that fits its chrome, not so it can use all four.
+ *
+ *   menu    a labelled trigger in the top bar → dropdown list.
+ *           The default. Reads as "you are in X"; the switch is secondary.
+ *   rail    a vertical column of org avatars, always visible.
+ *           For people who live in 2–5 orgs and switch constantly; costs
+ *           permanent horizontal space and does not scale past ~8.
+ *   search  a trigger that opens a filtered list.
+ *           The only one that works at 20+ orgs; slower for 3.
+ *   inline  a flat list, no popover.
+ *           For settings pages and the post-login picker, where the choice
+ *           IS the screen.
+ *
+ * ── The thing that shapes the whole component ──────────────────────────────
+ * Switching organization is NOT a client-side filter. The org a session can
+ * see is a signed claim in the access token, so switching re-mints the
+ * session server-side. That means it is a round-trip that can fail, and the
+ * UI must not pretend otherwise: pass `switchingOrgId` while it is in flight
+ * and the target row shows a pending state, the control is disabled, and
+ * nothing appears to have changed until the caller says it has.
+ *
+ * Rendering a switch as instant would be a lie, and a confusing one — the
+ * data on screen still belongs to the previous org until the new token
+ * arrives.
+ */
+import { type ComponentPropsWithoutRef } from "react";
+export type OrgSwitcherVariant = "menu" | "rail" | "search" | "inline";
+export interface OrgSwitcherOrg {
+    id: string;
+    name: string;
+    /** Falls back to initials derived from `name`. */
+    initials?: string;
+    avatarUrl?: string;
+    /** Plan or tier, e.g. "Enterprise". Rendered as quiet secondary text. */
+    plan?: string;
+    /** The person's role in THAT org, e.g. "Owner". Also quiet. */
+    role?: string;
+}
+export interface OrgSwitcherProps extends Omit<ComponentPropsWithoutRef<"div">, "onSelect"> {
+    organizations: OrgSwitcherOrg[];
+    /** The org the current session is scoped to. */
+    currentOrgId: string;
+    /** Called with the org to switch to. The caller performs the round-trip. */
+    onSwitch: (orgId: string) => void;
+    variant?: OrgSwitcherVariant;
+    /**
+     * The org currently being switched TO. While set, that row shows a spinner
+     * and the control is inert — switching re-mints the session, so it is a
+     * request, not a toggle.
+     */
+    switchingOrgId?: string | null;
+    /** Optional "create organization" action, appended to the list. */
+    onCreate?: () => void;
+    createLabel?: string;
+    size?: "sm" | "md";
+    /**
+     * Render the trigger as the PRIMARY identity in a top bar's lead slot —
+     * the position a product wordmark would otherwise occupy.
+     *
+     * Inside the app the wordmark is redundant (you know which product you are
+     * in; the tab, the URL and the sidebar all say so) while the organization is
+     * not, so the switcher replaces it rather than sitting beside it. Showing
+     * both reads as "OctaviaFlow / Octaviaflow" — two names, one of them noise.
+     *
+     * This matches the wordmark's weight and size so the corner keeps its
+     * anchor. `menu` and `search` only.
+     */
+    lead?: boolean;
+    /** Accessible name for the trigger. */
+    ariaLabel?: string;
+}
+export declare function OrgSwitcher({ organizations, currentOrgId, onSwitch, variant, switchingOrgId, onCreate, createLabel, size, lead, ariaLabel, className, ...rest }: Readonly<OrgSwitcherProps>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OrgSwitcher.d.ts.map

package/dist/components/OrgSwitcher/OrgSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrgSwitcher.d.ts","sourceRoot":"","sources":["../../../src/components/OrgSwitcher/OrgSwitcher.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAO9B,MAAM,OAAO,CAAC;AAOf,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACzD,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4DD,wBAAgB,WAAW,CAAC,EAC1B,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAgB,EAChB,cAAqB,EACrB,QAAQ,EACR,WAAmC,EACnC,IAAW,EACX,IAAY,EACZ,SAAiC,EACjC,SAAS,EACT,GAAG,IAAI,EACR,EAAE,QAAQ,CAAC,gBAAgB,CAAC,2CAoN5B"}

package/dist/components/OrgSwitcher/index.d.ts

@@ -0,0 +1,2 @@
+export { OrgSwitcher, type OrgSwitcherOrg, type OrgSwitcherProps, type OrgSwitcherVariant, } from "./OrgSwitcher";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/OrgSwitcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/OrgSwitcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/components/PresenceBar/PresenceBar.d.ts

@@ -0,0 +1,72 @@
+/**
+ * PresenceBar — who else has this open right now.
+ *
+ * A stack of overlapping avatars, each ringed in that person's colour so the
+ * same colour identifies them wherever they appear: their ring here, their
+ * ring on a node they are looking at, their cursor. Surplus people collapse
+ * into a `+N` chip that names them on hover.
+ *
+ * ── What this component deliberately does NOT do ────────────────────────────
+ *
+ * It renders OTHER people, and that is all it does. There is no callback that
+ * changes the host's view — no `onMemberClick` that scrolls, selects, or opens
+ * anything.
+ *
+ * Presence is decoration. Seeing that a colleague is looking at a node must
+ * never move your panel, your selection, or your viewport; that is the classic
+ * multiplayer failure where one person's click moves another person's UI.
+ * Keeping this component output-only is part of how that guarantee holds —
+ * there is simply nothing here to wire the wrong way.
+ *
+ * If a future version wants "jump to what they are doing", it belongs behind an
+ * explicit, user-initiated control — never as a side effect of receiving
+ * presence.
+ *
+ * ── Host responsibilities ───────────────────────────────────────────────────
+ *
+ * - Filter the local user out before passing `members` if you don't want to see
+ *   yourself. This component shows exactly who it is given.
+ * - `colour` is supplied per member rather than derived here, so the same
+ *   person keeps the same colour across every surface (the ring on a node, a
+ *   cursor label) — including surfaces this component knows nothing about.
+ */
+import { type ComponentPropsWithoutRef } from "react";
+import { type AvatarSize } from "../Avatar/Avatar";
+export interface PresenceMember {
+    /** Stable identity. Used as the React key. */
+    userId: string;
+    /** Display name — the tooltip text and the avatar's accessible name. */
+    name: string;
+    /** Optional photo. Falls back to initials derived from `name`. */
+    avatarUrl?: string;
+    /**
+     * This person's identity colour, as any valid CSS colour.
+     *
+     * Supplied by the host rather than hashed here on purpose: the same value
+     * has to drive the ring drawn on a node and a cursor elsewhere in the app,
+     * so one source decides it and every surface reads it.
+     */
+    colour: string;
+    /**
+     * Whether this person can edit. Someone read-only is present but cannot
+     * collide, so they are shown more quietly — rendering them identically to an
+     * editor would misrepresent the risk of a clash.
+     */
+    canEdit?: boolean;
+}
+export interface PresenceBarProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    /** The people to show, in the order they should appear. */
+    members: PresenceMember[];
+    /**
+     * How many avatars to show before collapsing into `+N`. Deliberately small:
+     * a wall of faces in a toolbar is noise, and the count carries the rest.
+     */
+    max?: number;
+    size?: AvatarSize;
+    /** Group label for assistive technology. */
+    label?: string;
+    /** Suffix appended to a read-only person's tooltip. */
+    viewingLabel?: string;
+}
+export declare const PresenceBar: import("react").ForwardRefExoticComponent<PresenceBarProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=PresenceBar.d.ts.map

package/dist/components/PresenceBar/PresenceBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceBar.d.ts","sourceRoot":"","sources":["../../../src/components/PresenceBar/PresenceBar.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,wBAAwB,EAAkC,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAU,KAAK,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAGxE,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACzF,2DAA2D;IAC3D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4BD,eAAO,MAAM,WAAW,6GAyDtB,CAAC"}

package/dist/components/PresenceBar/index.d.ts

@@ -0,0 +1,3 @@
+export type { PresenceBarProps, PresenceMember } from "./PresenceBar";
+export { PresenceBar } from "./PresenceBar";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/PresenceBar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/PresenceBar/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}