@stigmer/react 3.4.1 → 3.5.1

package/sidebar/WorkspaceSidebar.js

@@ -0,0 +1,95 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { memo, useMemo } from "react";
+import { Plus, LayoutDashboard, Library, MessageSquare, Workflow, } from "lucide-react";
+import { groupRecentActivityByTime } from "../activity/group-activity.js";
+import { formatRelativeTime } from "../activity/format-relative-time.js";
+import { recentActivityStatusBadge } from "../activity/entry-status-badge.js";
+import { ScrollArea } from "../internal/scroll-area.js";
+import { Tooltip, TooltipProvider, TooltipTrigger, TooltipContent, } from "../internal/tooltip.js";
+import { SidebarChrome, SidebarSeparator, navRowClassName } from "./chrome.js";
+/**
+ * The console's workspace-zone sidebar: org switcher, primary navigation
+ * (New Session / Dashboard / Library), time-bucketed recent activity,
+ * and a user footer.
+ *
+ * This is the same component the Stigmer web console and desktop app
+ * render — hosts differ only in what they return from `renderLink`
+ * (their router's link), what they pass as `recentActivity` (live hook
+ * data or frozen fixtures), and the `footer` slot. Documentation tours
+ * render it too, which is the point: the depicted chrome cannot drift
+ * from the product because it *is* the product (stigmer/stigmer#317).
+ *
+ * Layout note: the sidebar fills its container's height and defines no
+ * width — the console's app shell owns the `w-70` (280px) column.
+ *
+ * @example
+ * ```tsx
+ * <WorkspaceSidebar
+ *   activeNav="library"
+ *   renderLink={({ href, children, ...rest }) => (
+ *     <Link href={href} {...rest}>{children}</Link>
+ *   )}
+ *   recentActivity={useRecentActivity()}
+ *   footer={<UserMenu />}
+ * />
+ * ```
+ */
+export function WorkspaceSidebar({ activeNav = null, renderLink, recentActivity, activeSessionId = null, activeExecutionId = null, renderEntryAccessory, footer, isOpen = true, onCollapse, onOrgChanged, now, }) {
+    const { entries, isLoading = false, error = null } = recentActivity;
+    const groups = useMemo(() => groupRecentActivityByTime(entries, now), [entries, now]);
+    return (_jsxs(SidebarChrome, { ariaLabel: "Main navigation", isOpen: isOpen, onCollapse: onCollapse, onOrgChanged: onOrgChanged, footer: footer, children: [_jsx(PrimaryNavRow, { id: "new-session", href: "/", label: "New Session", icon: Plus, active: activeNav === "new-session", renderLink: renderLink }), _jsx(PrimaryNavRow, { id: "dashboard", href: "/dashboard", label: "Dashboard", icon: LayoutDashboard, active: activeNav === "dashboard", renderLink: renderLink }), _jsx(PrimaryNavRow, { id: "library", href: "/library", label: "Library", icon: Library, active: activeNav === "library", renderLink: renderLink }), _jsx(SidebarSeparator, {}), _jsx(ScrollArea, { className: "flex-1", children: _jsxs("div", { className: "p-3", children: [_jsx("p", { className: "text-sidebar-muted-foreground mb-2 px-1 text-[11px] font-semibold tracking-wider uppercase", children: "Recents" }), isLoading ? (_jsx(RecentsSkeletons, {})) : error ? (_jsx(RecentsError, { message: error.message })) : groups.length === 0 ? (_jsx(RecentsEmptyState, {})) : (_jsx(ActivityGroupList, { groups: groups, activeSessionId: activeSessionId, activeExecutionId: activeExecutionId, renderLink: renderLink, renderEntryAccessory: renderEntryAccessory, now: now }))] }) })] }));
+}
+// ---------------------------------------------------------------------------
+// Internals
+// ---------------------------------------------------------------------------
+function PrimaryNavRow({ id, href, label, icon: Icon, active, renderLink, }) {
+    return (_jsx("div", { className: "flex-none px-3 py-1", children: renderLink({
+            id,
+            href,
+            active,
+            className: navRowClassName(active),
+            "aria-current": active ? "page" : undefined,
+            children: (_jsxs(_Fragment, { children: [_jsx(Icon, { className: "size-4 shrink-0" }), label] })),
+        }) }));
+}
+function ActivityGroupList({ groups, activeSessionId, activeExecutionId, renderLink, renderEntryAccessory, now, }) {
+    return (_jsx(TooltipProvider, { children: _jsx("div", { className: "space-y-4", children: groups.map((group) => (_jsxs("div", { children: [_jsx("p", { className: "text-sidebar-muted-foreground mb-1 px-2 text-[10px] font-medium tracking-wider uppercase", children: group.label }), _jsx("ul", { className: "space-y-0.5", role: "list", children: group.entries.map((entry) => (_jsx(ActivityEntry, { entry: entry, activeSessionId: activeSessionId, activeExecutionId: activeExecutionId, renderLink: renderLink, renderEntryAccessory: renderEntryAccessory, now: now }, entry.id))) })] }, group.label))) }) }));
+}
+const ActivityEntry = memo(function ActivityEntry({ entry, activeSessionId, activeExecutionId, renderLink, renderEntryAccessory, now, }) {
+    const isSession = entry.type === "session";
+    const isActive = isSession
+        ? entry.id === activeSessionId
+        : entry.id === activeExecutionId;
+    const href = isSession ? `/sessions/${entry.id}` : `/executions/${entry.id}`;
+    const TypeIcon = isSession ? MessageSquare : Workflow;
+    const statusBadge = recentActivityStatusBadge(entry);
+    const row = renderLink({
+        id: entry.id,
+        href,
+        active: isActive,
+        "aria-current": isActive ? "page" : undefined,
+        entry,
+        className: cnActivityRow(isActive),
+        children: (_jsxs(_Fragment, { children: [_jsx(TypeIcon, { className: "mt-0.5 size-3 shrink-0 opacity-50", "aria-hidden": "true" }), _jsx("span", { className: "line-clamp-2 flex-1", children: entry.subject }), _jsxs("span", { className: "flex shrink-0 flex-col items-end gap-0.5 text-[10px] leading-tight", children: [_jsx("span", { className: "text-sidebar-muted-foreground tabular-nums", children: formatRelativeTime(entry.updatedAt, now) }), statusBadge && (_jsx("span", { className: statusBadge.tone === "destructive"
+                                ? "text-destructive"
+                                : "text-sidebar-muted-foreground", children: statusBadge.label }))] }), renderEntryAccessory?.(entry)] })),
+    });
+    return (_jsx("li", { children: _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { render: row }), _jsx(TooltipContent, { side: "right", sideOffset: 12, children: entry.subject })] }) }));
+});
+/** Recents rows are denser than primary nav: 12px text, top-aligned icon. */
+function cnActivityRow(active) {
+    return active
+        ? "flex items-start gap-2 rounded-lg px-2 py-1.5 text-xs transition-colors bg-sidebar-accent text-sidebar-accent-foreground font-medium"
+        : "flex items-start gap-2 rounded-lg px-2 py-1.5 text-xs transition-colors text-sidebar-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground";
+}
+function RecentsSkeletons() {
+    return (_jsx("div", { className: "space-y-2 px-2", "aria-busy": "true", "aria-label": "Loading sessions", children: Array.from({ length: 5 }, (_, i) => (_jsx("div", { className: "bg-sidebar-muted h-5 animate-pulse rounded", style: { width: `${70 + Math.sin(i * 1.5) * 20}%` } }, i))) }));
+}
+function RecentsError({ message }) {
+    return (_jsxs(_Fragment, { children: [_jsx("p", { className: "text-destructive mb-4 px-2 text-xs", role: "alert", children: message }), _jsx(RecentsEmptyState, {})] }));
+}
+function RecentsEmptyState() {
+    return (_jsxs("div", { className: "flex flex-col items-center gap-2 py-8 text-center", children: [_jsx(MessageSquare, { className: "text-sidebar-muted-foreground size-8" }), _jsx("p", { className: "text-sidebar-muted-foreground text-xs", children: "No recent activity" })] }));
+}
+//# sourceMappingURL=WorkspaceSidebar.js.map

package/sidebar/WorkspaceSidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSidebar.js","sourceRoot":"","sources":["../../src/sidebar/WorkspaceSidebar.tsx"],"names":[],"mappings":"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"}

package/sidebar/chrome.d.ts

@@ -0,0 +1,48 @@
+import type { ReactNode } from "react";
+import type { Organization } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/api_pb";
+/** Props shared by both sidebar variants' outer chrome. */
+export interface SidebarChromeProps {
+    /** Accessible name for the `<nav>` landmark. */
+    readonly ariaLabel: string;
+    /**
+     * Whether the sidebar is currently expanded, reflected as
+     * `aria-expanded` on the collapse toggle. @default true
+     */
+    readonly isOpen?: boolean;
+    /**
+     * Called when the collapse toggle is pressed. The sidebar renders the
+     * toggle either way (it is part of the depicted chrome); hosts that
+     * cannot collapse (fixed embeds) simply omit the handler.
+     */
+    readonly onCollapse?: () => void;
+    /** Passed through to {@link OrgSwitcher}. */
+    readonly onOrgChanged?: (org: Organization) => void;
+    /**
+     * Footer content — typically the host app's `UserMenu` wrapper, which
+     * bridges auth, theming, and routing. A slot rather than a built-in
+     * because every host wires those systems differently (DD-004).
+     */
+    readonly footer: ReactNode;
+    readonly children: ReactNode;
+}
+/**
+ * Outer sidebar frame: `<nav>` container, top row, content, footer band.
+ *
+ * The `id="sidebar"` / `aria-controls` pairing matches the console's DOM
+ * contract (the app shell's floating "Open sidebar" button targets it);
+ * only one sidebar renders at a time, so the id cannot collide.
+ */
+export declare function SidebarChrome({ ariaLabel, isOpen, onCollapse, onOrgChanged, footer, children, }: SidebarChromeProps): import("react/jsx-runtime").JSX.Element;
+/** Hairline separator between sidebar sections. */
+export declare function SidebarSeparator(): import("react/jsx-runtime").JSX.Element;
+/**
+ * The one nav-row class recipe both sidebars share: 14px medium labels,
+ * 16px icons (sized by callers), 8px/6px padding, rounded row highlight.
+ *
+ * `muted` renders the resting label in the muted sidebar tone — used by
+ * "Back to Sessions", which is an exit, not a destination.
+ */
+export declare function navRowClassName(active: boolean, { muted }?: {
+    muted?: boolean;
+}): string;
+//# sourceMappingURL=chrome.d.ts.map

package/sidebar/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/sidebar/chrome.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAc9F,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,MAAa,EACb,UAAU,EACV,YAAY,EACZ,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,2CAsCpB;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,4CAM/B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,EAAE,KAAa,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,MAAM,CAUR"}

package/sidebar/chrome.js

@@ -0,0 +1,32 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PanelLeft } from "lucide-react";
+import { cn } from "@stigmer/theme";
+import { OrgSwitcher } from "../organization/OrgSwitcher.js";
+/**
+ * Outer sidebar frame: `<nav>` container, top row, content, footer band.
+ *
+ * The `id="sidebar"` / `aria-controls` pairing matches the console's DOM
+ * contract (the app shell's floating "Open sidebar" button targets it);
+ * only one sidebar renders at a time, so the id cannot collide.
+ */
+export function SidebarChrome({ ariaLabel, isOpen = true, onCollapse, onOrgChanged, footer, children, }) {
+    return (_jsxs("nav", { id: "sidebar", "aria-label": ariaLabel, className: "bg-sidebar text-sidebar-foreground flex h-full flex-col", children: [_jsxs("div", { className: "flex flex-none items-center gap-1 px-2 py-2", children: [_jsx("button", { type: "button", onClick: onCollapse, "aria-expanded": isOpen, "aria-controls": "sidebar", "aria-label": "Collapse sidebar", className: cn("inline-flex size-7 shrink-0 items-center justify-center rounded-md", "text-sidebar-foreground transition-colors motion-reduce:transition-none", "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", "aria-expanded:bg-sidebar-accent aria-expanded:text-sidebar-accent-foreground", "focus-visible:ring-sidebar-ring focus-visible:ring-2 focus-visible:outline-none"), children: _jsx(PanelLeft, { className: "size-4" }) }), _jsx("div", { className: "min-w-0 flex-1", children: _jsx(OrgSwitcher, { onOrgChanged: onOrgChanged }) })] }), children, _jsx("div", { className: "border-sidebar-border flex-none border-t px-3 py-2", children: footer })] }));
+}
+/** Hairline separator between sidebar sections. */
+export function SidebarSeparator() {
+    return (_jsx("div", { className: "px-3 py-1", children: _jsx("div", { className: "bg-sidebar-border h-px" }) }));
+}
+/**
+ * The one nav-row class recipe both sidebars share: 14px medium labels,
+ * 16px icons (sized by callers), 8px/6px padding, rounded row highlight.
+ *
+ * `muted` renders the resting label in the muted sidebar tone — used by
+ * "Back to Sessions", which is an exit, not a destination.
+ */
+export function navRowClassName(active, { muted = false } = {}) {
+    return cn("flex items-center gap-2 rounded-lg px-2 py-1.5 text-sm font-medium transition-colors", active
+        ? "bg-sidebar-accent text-sidebar-accent-foreground"
+        : cn(muted ? "text-sidebar-muted-foreground" : "text-sidebar-foreground", "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"));
+}
+//# sourceMappingURL=chrome.js.map

package/sidebar/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../src/sidebar/chrome.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAuC7D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,SAAS,EACT,MAAM,GAAG,IAAI,EACb,UAAU,EACV,YAAY,EACZ,MAAM,EACN,QAAQ,GACW;IACnB,OAAO,CACL,eACE,EAAE,EAAC,SAAS,gBACA,SAAS,EACrB,SAAS,EAAC,yDAAyD,aAGnE,eAAK,SAAS,EAAC,6CAA6C,aAC1D,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,UAAU,mBACJ,MAAM,mBACP,SAAS,gBACZ,kBAAkB,EAC7B,SAAS,EAAE,EAAE,CACX,oEAAoE,EACpE,yEAAyE,EACzE,8DAA8D,EAC9D,8EAA8E,EAC9E,iFAAiF,CAClF,YAED,KAAC,SAAS,IAAC,SAAS,EAAC,QAAQ,GAAG,GACzB,EACT,cAAK,SAAS,EAAC,gBAAgB,YAC7B,KAAC,WAAW,IAAC,YAAY,EAAE,YAAY,GAAI,GACvC,IACF,EAEL,QAAQ,EAGT,cAAK,SAAS,EAAC,oDAAoD,YAChE,MAAM,GACH,IACF,CACP,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,cAAK,SAAS,EAAC,WAAW,YACxB,cAAK,SAAS,EAAC,wBAAwB,GAAG,GACtC,CACP,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAe,EACf,EAAE,KAAK,GAAG,KAAK,KAA0B,EAAE;IAE3C,OAAO,EAAE,CACP,sFAAsF,EACtF,MAAM;QACJ,CAAC,CAAC,kDAAkD;QACpD,CAAC,CAAC,EAAE,CACA,KAAK,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,yBAAyB,EACnE,8DAA8D,CAC/D,CACN,CAAC;AACJ,CAAC"}

package/sidebar/index.d.ts

@@ -0,0 +1,6 @@
+export { WorkspaceSidebar } from "./WorkspaceSidebar.js";
+export type { WorkspaceSidebarProps, WorkspaceSidebarActivity, WorkspaceNavId, } from "./WorkspaceSidebar.js";
+export { SettingsSidebar } from "./SettingsSidebar.js";
+export type { SettingsSidebarProps } from "./SettingsSidebar.js";
+export type { SidebarLinkRenderProps, RenderSidebarLink } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/sidebar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sidebar/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/sidebar/index.js

@@ -0,0 +1,9 @@
+// Sidebar — the console's navigation chrome as shared SDK components.
+//
+// One source of truth for the sidebar the web console, desktop app, and
+// documentation tours all render (stigmer/stigmer#317): hosts inject their
+// router via `renderLink`, their data via props, and their user menu via
+// the `footer` slot.
+export { WorkspaceSidebar } from "./WorkspaceSidebar.js";
+export { SettingsSidebar } from "./SettingsSidebar.js";
+//# sourceMappingURL=index.js.map

package/sidebar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sidebar/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AACxE,2EAA2E;AAC3E,yEAAyE;AACzE,qBAAqB;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/sidebar/types.d.ts

@@ -0,0 +1,54 @@
+import type { ReactElement, ReactNode } from "react";
+import type { RecentActivityEntry } from "../activity/types.js";
+/**
+ * Everything a sidebar hands to {@link RenderSidebarLink} to draw one
+ * interactive row.
+ *
+ * The sidebar owns the row's look (`className`, `children`) and state
+ * (`active`, `aria-current`); the consumer owns only the interactive
+ * element wrapping them. That split is what keeps one component serving
+ * three very different hosts: the web console returns `next/link`, the
+ * desktop app returns a `react-router` link, and documentation embeds
+ * return inert rows decorated with capture markers.
+ */
+export interface SidebarLinkRenderProps {
+    /**
+     * Stable row identifier, for consumers that vary behavior per row:
+     * `"new-session"` / `"dashboard"` / `"library"` in the workspace
+     * sidebar, `"back-to-sessions"` or the settings route basename (e.g.
+     * `"api-keys"`) in the settings sidebar, and the entry id for recent
+     * activity rows.
+     */
+    readonly id: string;
+    /** Console route this row targets (e.g. `/library`, `/sessions/<id>`). */
+    readonly href: string;
+    /** Whether the row is the current location. */
+    readonly active: boolean;
+    /**
+     * Fully-styled row classes computed by the sidebar. Apply verbatim —
+     * the row's geometry and type scale are the product surface tours and
+     * embeds depict, so consumers must not restyle them.
+     */
+    readonly className: string;
+    /** `"page"` when active, for assistive tech. Spread onto the element. */
+    readonly "aria-current": "page" | undefined;
+    /** Row content (icon, label, timestamps). Render inside the element. */
+    readonly children: ReactNode;
+    /**
+     * The recent-activity entry behind this row. Present only for recents
+     * rows in the workspace sidebar — consumers use it to pick the right
+     * navigation flow (session viewer vs. execution viewer) without
+     * parsing `href`.
+     */
+    readonly entry?: RecentActivityEntry;
+}
+/**
+ * Renders one sidebar row as the consumer's interactive element.
+ *
+ * Must return a single element that spreads unknown props onto its
+ * underlying DOM node (all DOM elements, `next/link`, and `react-router`
+ * links qualify): the sidebar composes tooltip triggers around recents
+ * rows by cloning the returned element with merged event handlers.
+ */
+export type RenderSidebarLink = (props: SidebarLinkRenderProps) => ReactElement;
+//# sourceMappingURL=types.d.ts.map

package/sidebar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sidebar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,sBAAsB,KAAK,YAAY,CAAC"}

package/sidebar/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/sidebar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sidebar/types.ts"],"names":[],"mappings":""}