@ag2/weave 0.11.0 → 0.13.0

package/README.md

@@ -4,6 +4,21 @@
 
 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.
 
+## Ambient orb background
+
+`OrbBackground` renders the Absorb / Calm / Aura field and is the default background
+of `SplashScreen`. Place it inside an element with the exported `OrbBackgroundHost`
+class so its decorative canvas sits behind content and is clipped at the surface edge.
+The parent supplies its background colour through the normal theme tokens.
+
+It follows the resolved `color.Background.Container` token, including nested and custom
+themes. An optional `appearance="light" | "dark"` prop lets a framing host override the
+colour intensity. Reduced motion renders a static field; hidden documents pause animation.
+All animation frames, resize observers, and theme listeners are removed on unmount.
+`Starfield` and `StarfieldHost` remain exported for existing consumers.
+
+The field is adapted from [matty-morgs/octo-space](https://github.com/matty-morgs/octo-space/blob/7f5536888eaf0068200e1d339318ba2bc57a5e40/onboarding-aura/index.html).
+
 <!-- original folds README follows -->
 
 # Folds

package/dist/components/activity-item/ActivityHeader.css.d.ts

@@ -0,0 +1,5 @@
+export declare const ActivityHeader: string;
+export declare const TitleRow: string;
+export declare const Title: string;
+export declare const Controls: string;
+export declare const Spacer: string;

package/dist/components/activity-item/ActivityHeader.d.ts

@@ -0,0 +1,11 @@
+import React, { ReactNode } from "react";
+export declare type ActivityHeaderProps = {
+    title: string;
+    /** After the title: the ••• menu and close. */
+    actions?: ReactNode;
+    /** The filters, left: who (All · You · Agents). */
+    filters?: ReactNode;
+    /** The filters, right: Unread only. */
+    after?: ReactNode;
+};
+export declare const ActivityHeader: <T extends React.ElementType<any> = "div">(props: import("..").AsOutProps<T, ActivityHeaderProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/dist/components/activity-item/ActivityItem.css.d.ts

@@ -0,0 +1,18 @@
+export declare const ActivityItem: string;
+export declare const SelectedBar: string;
+export declare const Main: string;
+export declare const Head: string;
+export declare const Face: string;
+export declare const Name: string;
+export declare const What: string;
+export declare const Time: string;
+export declare const UnreadDot: string;
+export declare const Indented: string;
+export declare const Body: string;
+export declare const Replies: string;
+export declare const RepliesUnread: string;
+export declare const ObjectRow: string;
+export declare const Actions: string;
+export declare const Attention: string;
+export declare const AttentionBreathing: string;
+export declare const Action: string;

package/dist/components/activity-item/ActivityItem.d.ts

@@ -0,0 +1,43 @@
+import React, { ReactNode } from "react";
+import { IconSrc } from "../icon";
+export declare type ActivityItemProps = {
+    /** The person's or agent's face, 20px. */
+    avatar: ReactNode;
+    name: string;
+    /** What happened, after the name: "mentioned you", "updated a Commons doc". */
+    what: string;
+    time: string;
+    /** The message, three lines at most. */
+    body?: ReactNode;
+    unread?: boolean;
+    /** Read items set their text in a quieter ink. */
+    read?: boolean;
+    /** Needs you: a still warm dot in the margin; "breathing" on the first one only. */
+    attention?: "still" | "breathing";
+    /** Its message is the one highlighted in the chat. */
+    selected?: boolean;
+    /** "2 replies · 1 unread": total and the unread part, which reads in the unread ink. */
+    replies?: {
+        total: string;
+        unread?: string;
+        onOpen?: () => void;
+    };
+    /** A page the action happened on (a Commons chip). */
+    object?: ReactNode;
+    /** Reply, Jump, Mark read: shown on hover and focus, or always with `actionsShown`. */
+    actions?: ReactNode;
+    actionsShown?: boolean;
+    /** Clicking the item's text: jump to the message in the chat. */
+    onOpen?: () => void;
+    /** The accessible name of the item's main target; "unread" and "needs you" are appended to it. */
+    label?: string;
+};
+export declare const ActivityItem: <T extends React.ElementType<any> = "div">(props: import("..").AsOutProps<T, ActivityItemProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare type ActivityItemActionProps = {
+    label: string;
+    /** Icon-only actions take a glyph; labelled ones show the label. */
+    icon?: IconSrc;
+    /** The one always-shown action on the item that needs you first. */
+    primary?: boolean;
+};
+export declare const ActivityItemAction: <T extends React.ElementType<any> = "button">(props: import("..").AsOutProps<T, ActivityItemActionProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/dist/components/activity-item/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ActivityItem";
+export * from "./ActivityHeader";

package/dist/components/avatar/Avatar.d.ts

@@ -4,7 +4,7 @@ declare type AvatarContentProps = {
     kind?: AvatarKind;
 };
 export declare const Avatar: <T extends React.ElementType<any> = "span">(props: Omit<React.PropsWithChildren<React.ComponentPropsWithRef<T>>, "as"> & {
-    size?: "large" | "inline" | "compact" | "200" | "300" | "400" | "500" | "stack" | "standard" | "hero" | "profile" | undefined;
+    size?: "large" | "inline" | "compact" | "200" | "300" | "400" | "500" | "standard" | "stack" | "hero" | "profile" | undefined;
     radii?: "0" | "300" | "400" | "500" | "Pill" | "Inherit" | undefined;
 } & import("..").AsProp<T>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
 export declare const AvatarImage: <T extends React.ElementType<any> = "img">(props: import("..").AsOutProps<T, AvatarContentProps>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

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

@@ -8,5 +8,5 @@ export declare const Icon: React.ForwardRefExoticComponent<React.SVGAttributes<S
     filled?: boolean | undefined;
     src: IconSrc;
 } & {
-    size?: "small" | "compact" | "100" | "200" | "300" | "400" | "500" | "600" | "standard" | "Inherit" | "50" | undefined;
+    size?: "small" | "compact" | "100" | "200" | "300" | "400" | "500" | "600" | "Inherit" | "standard" | "50" | undefined;
 } & React.RefAttributes<SVGSVGElement>>;

package/dist/components/index.d.ts

@@ -65,3 +65,5 @@ export * from "./commons-tabs";
 export * from "./surface-toolbar";
 export * from "./dock";
 export * from "./inspector-tabs";
+export * from "./activity-item";
+export * from "./orb-background";

package/dist/components/orb-background/OrbBackground.css.d.ts

@@ -0,0 +1,3 @@
+/** Isolate the decorative layer behind content and clip the blur at the surface edge. */
+export declare const OrbBackgroundHost: string;
+export declare const OrbBackground: string;

package/dist/components/orb-background/OrbBackground.d.ts

@@ -0,0 +1,7 @@
+export declare type OrbBackgroundProps = {
+    className?: string;
+    /** Optional framing-host override; otherwise follows the active surface token. */
+    appearance?: "light" | "dark";
+};
+/** Calm, blurred orbs with absorb collisions. Place inside an OrbBackgroundHost surface. */
+export declare const OrbBackground: ({ className, appearance }: OrbBackgroundProps) => JSX.Element;

package/dist/components/orb-background/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./OrbBackground";
+export { OrbBackgroundHost } from "./OrbBackground.css";

package/dist/components/orb-background/orbAppearance.d.ts

@@ -0,0 +1,2 @@
+/** Infer brightness from the resolved surface token, independent of consumer class names. */
+export declare const orbOpacityForSurface: (surface: string, prefersDark: boolean) => number;

package/dist/components/orb-background/orbField.d.ts

@@ -0,0 +1 @@
+export declare function startOrbField(element: HTMLCanvasElement): () => void;

package/dist/components/panel-switch/PanelSwitch.d.ts

@@ -10,6 +10,8 @@ export declare type PanelSwitchProps = {
     countStyle?: "Plain" | "Pill";
     /** Keep the name visible while closed (Commons). */
     labelled?: boolean;
+    /** Never show the name, even when open: a narrow header. The pressed fill shows it is open. */
+    iconOnly?: boolean;
     /** Something in this panel needs you; shown while closed. */
     attention?: boolean;
 };

package/dist/components/sidebar/SidebarItem.d.ts

@@ -13,7 +13,7 @@ export declare const SidebarAvatar: <T extends React.ElementType<any> = "div">(p
     size?: "200" | "300" | "400" | undefined;
     outlined?: boolean | undefined;
 } & Omit<any, "as"> & {
-    size?: "large" | "inline" | "compact" | "200" | "300" | "400" | "500" | "stack" | "standard" | "hero" | "profile" | undefined;
+    size?: "large" | "inline" | "compact" | "200" | "300" | "400" | "500" | "standard" | "stack" | "hero" | "profile" | undefined;
     radii?: "0" | "300" | "400" | "500" | "Pill" | "Inherit" | undefined;
 } & import("..").AsProp<React.ElementType<any>>>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
 export declare const SidebarFolder: <T extends React.ElementType<any> = "div">(props: Omit<React.PropsWithChildren<React.ComponentPropsWithRef<T>>, "as"> & {