@ag2/weave 0.13.0 → 0.15.0

package/README.md

@@ -4,6 +4,27 @@
 
 The AG2 Space design system. Forked from [folds](https://github.com/cinnyapp/folds) 2.6.2 (Apache-2.0); `@ag2/weave@0.1.0` is folds@2.6.2 under the new name.
 
+## Temporary sidebar collapse
+
+Keep `PageNav` mounted and call `useRoomNavAutoCollapse` once from the room layout:
+
+```tsx
+import { useRoomNavAutoCollapse } from "@ag2/weave";
+
+useRoomNavAutoCollapse(commonsOpen && !isMobile, roomId);
+```
+
+The hook collapses the sidebar before paint without writing `roomNavCollapsed`.
+Closing Commons or unmounting the layout releases the request and restores the saved
+preference. Manual controls still use `useRoomNavCollapsed()`; they toggle the effective
+state, save the user's choice, and override requests already active. Switching tabs in
+the same room preserves that choice. Closing and reopening Commons, or changing `roomId`,
+starts a fresh automatic collapse. Leave the optional scope unchanged for the lifetime
+of one open panel, and disable the request on mobile.
+
+`useRoomNavCollapsed()` retains its existing tuple and animation options. The collapsed
+sidebar's restore button remains the way to expand it; no room-header control is needed.
+
 ## Ambient orb background
 
 `OrbBackground` renders the Absorb / Calm / Aura field and is the default background

package/dist/components/icon/Icons.d.ts

@@ -104,6 +104,7 @@ export declare const Icons: {
     RecentClock: IconSrc;
     Power: IconSrc;
     ReplyArrow: IconSrc;
+    ForwardArrow: IconSrc;
     ArrowGoRight: IconSrc;
     ArrowGoRightPlus: IconSrc;
     ArrowGoRightCross: IconSrc;

package/dist/components/index.d.ts

@@ -66,4 +66,5 @@ export * from "./surface-toolbar";
 export * from "./dock";
 export * from "./inspector-tabs";
 export * from "./activity-item";
+export * from "./quote-card";
 export * from "./orb-background";

package/dist/components/page/Page.d.ts

@@ -12,6 +12,12 @@ export declare type RoomNavToggleOptions = {
     animate?: boolean;
 };
 export declare function useRoomNavCollapsed(): [boolean, (options?: RoomNavToggleOptions) => void];
+/** Temporarily collapse the sidebar without writing its saved preference.
+ * Manual toggles win until this request ends. Changing scope starts a new request
+ * (for example, entering another room); switching surfaces in one scope does not.
+ * Call once from the layout owning the request, outside the collapsible content.
+ */
+export declare function useRoomNavAutoCollapse(active: boolean, scope?: string): void;
 declare type PageNavProps = ClientDrawerLayoutProps & css.PageNavVariants & {
     /** Decorative brand mark shown in the collapsed rail until hover or keyboard focus. */
     collapsedMark?: ReactNode;

package/dist/components/page/roomNavCollapseStore.d.ts

@@ -0,0 +1,7 @@
+/** One effective state shared by the sidebar and all of its manual controls. */
+export declare const createRoomNavCollapseStore: (storage: () => Pick<Storage, "getItem" | "setItem">) => {
+    getSnapshot: () => boolean;
+    subscribe: (listener: () => void) => () => void;
+    toggle: () => void;
+    requestCollapse: () => () => void;
+};

package/dist/components/quote-card/QuoteCard.css.d.ts

@@ -0,0 +1,9 @@
+export declare const QuoteCard: string;
+export declare const Head: string;
+export declare const Glyph: string;
+export declare const Face: string;
+export declare const Name: string;
+export declare const Time: string;
+export declare const Snippet: string;
+export declare const FileRow: string;
+export declare const Deleted: string;

package/dist/components/quote-card/QuoteCard.d.ts

@@ -0,0 +1,21 @@
+import React, { ReactNode } from "react";
+export declare type QuoteCardContext = "Reply" | "File" | "Forwarded" | "Deleted";
+export declare type QuoteCardProps = {
+    /** Reply, a file-only parent, a forwarded message, or a parent that was deleted. */
+    context?: QuoteCardContext;
+    /** 20px: a photo, an initial, or an agent's mark. */
+    avatar?: ReactNode;
+    /** "You" when it's yours. */
+    name?: string;
+    time?: string;
+    /** Forwarded: where it came from, after the time ("Direct message", "#Invoke Only"). */
+    source?: string;
+    /** The parent's text, flattened, at most two lines. For a file: "Type · title". */
+    snippet?: ReactNode;
+};
+/**
+ * The parent of a reply, or a forwarded message, as one card you can't mistake for the reply.
+ * A button that jumps to the message (`as="div"` for a card that isn't a target); a deleted
+ * parent is never a target.
+ */
+export declare const QuoteCard: <T extends React.ElementType<any> = "button">(props: import("..").AsOutProps<T, QuoteCardProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/dist/components/quote-card/ReplyBar.css.d.ts

@@ -0,0 +1,6 @@
+export declare const ReplyBar: string;
+export declare const Glyph: string;
+export declare const What: string;
+export declare const Name: string;
+export declare const Mention: string;
+export declare const Close: string;

package/dist/components/quote-card/ReplyBar.d.ts

@@ -0,0 +1,12 @@
+import React, { ReactNode } from "react";
+export declare type ReplyBarProps = {
+    /** Who you're replying to. */
+    name: string;
+    /** Their message, one line. */
+    snippet?: ReactNode;
+    /** Whether the reply mentions (notifies) them. Leave out to hide the control. */
+    mention?: boolean;
+    onMentionChange?: (mention: boolean) => void;
+    onCancel?: () => void;
+};
+export declare const ReplyBar: <T extends React.ElementType<any> = "div">(props: import("..").AsOutProps<T, ReplyBarProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/dist/components/quote-card/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./QuoteCard";
+export * from "./ReplyBar";