@agent-native/core-corpus 0.216.0 → 0.218.0

package/corpus/templates/clips/app/components/sharing/share-ui.tsx

@@ -1,91 +1,14 @@
 import { trackEvent } from "@agent-native/core/client/analytics";
-import {
-  useActionMutation,
-  useActionQuery,
-} from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
-import { useOrg } from "@agent-native/core/client/org";
+import type { ShareButtonVisibility } from "@agent-native/core/client/sharing/useShareButtonController";
 import { writeClipboardText } from "@agent-native/toolkit/clipboard";
-import {
-  IconCheck,
-  IconChevronDown,
-  IconLink,
-  IconLock,
-  IconSend2,
-  IconTrash,
-  IconUsersGroup,
-  IconWorld,
-} from "@tabler/icons-react";
-import { useQueryClient } from "@tanstack/react-query";
-import { useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { IconCheck, IconLink } from "@tabler/icons-react";
+import { useEffect, useRef, useState, type ReactNode } from "react";
 
-import {
-  Avatar as UserAvatar,
-  AvatarFallback as UserAvatarFallback,
-  AvatarImage as UserAvatarImage,
-} from "@/components/ui/avatar";
 import { Button } from "@/components/ui/button";
-import { Checkbox } from "@/components/ui/checkbox";
-import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from "@/components/ui/collapsible";
-import { Input } from "@/components/ui/input";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@/components/ui/select";
-import { useVisibleAvatarUrl } from "@/lib/use-visible-avatar-url";
 import { cn } from "@/lib/utils";
 
-export type Visibility = "private" | "org" | "public";
-export type Role = "viewer" | "commenter" | "editor" | "admin";
-export type ShareSettingsView = "people" | null;
-
-export interface RoleCopy {
-  label: string;
-  description: string;
-}
-
-export interface Share {
-  id: string;
-  principalType: "user" | "org";
-  principalId: string;
-  role: Role;
-}
-
-export interface SharesResponse {
-  ownerEmail: string | null;
-  orgId: string | null;
-  visibility: Visibility | null;
-  role?: "owner" | Role;
-  shares: Share[];
-}
-
-export type SharesQuery = ReturnType<typeof useActionQuery<SharesResponse>>;
-
-export const VIS_META: Record<Visibility, { Icon: typeof IconLock }> = {
-  private: {
-    Icon: IconLock,
-  },
-  org: {
-    Icon: IconUsersGroup,
-  },
-  public: {
-    Icon: IconWorld,
-  },
-};
-
-export const ROLE_OPTIONS: Array<{ value: Role; label: string }> = [
-  { value: "viewer", label: "Viewer" },
-  { value: "commenter", label: "Commenter" },
-  { value: "editor", label: "Editor" },
-  { value: "admin", label: "Admin" },
-];
+export type Visibility = ShareButtonVisibility;
 
 export function copyToClipboard(value: string): Promise<boolean> {
   return writeClipboardText(value);
@@ -98,6 +21,7 @@ const NESTED_LAYER_SELECTOR = [
   "[role='menu']",
   "[role='listbox']",
   "[data-sonner-toaster]",
+  "[data-agent-native-share-overlay]",
 ].join(",");
 
 const OPEN_NESTED_LAYER_SELECTOR = [
@@ -135,51 +59,6 @@ export function nestedLayerDismissGuards(): {
   };
 }
 
-export function useResourceVisibilityMutation(
-  resourceType: string,
-  resourceId: string,
-  sharesQuery: SharesQuery,
-) {
-  const queryClient = useQueryClient();
-  const setVisibility = useActionMutation("set-resource-visibility");
-  const shareQueryKey = useMemo(
-    () =>
-      ["action", "list-resource-shares", { resourceType, resourceId }] as const,
-    [resourceType, resourceId],
-  );
-
-  const setResourceVisibility = (
-    next: Visibility,
-    options?: { onSuccess?: () => void },
-  ) => {
-    const previous = queryClient.getQueryData<SharesResponse>(shareQueryKey);
-    queryClient.setQueryData<SharesResponse>(shareQueryKey, (current) =>
-      current ? { ...current, visibility: next } : current,
-    );
-    setVisibility.mutate(
-      {
-        resourceType,
-        resourceId,
-        visibility: next,
-      } as any,
-      {
-        onSuccess: () => {
-          void sharesQuery.refetch().finally(() => options?.onSuccess?.());
-        },
-        onError: () => {
-          if (previous) {
-            queryClient.setQueryData(shareQueryKey, previous);
-          } else {
-            void queryClient.invalidateQueries({ queryKey: shareQueryKey });
-          }
-        },
-      },
-    );
-  };
-
-  return { setResourceVisibility, isPending: setVisibility.isPending };
-}
-
 export function ShareSectionLabel({
   children,
   className,
@@ -268,461 +147,3 @@ export function CopyButton({
     </Button>
   );
 }
-
-export function Avatar({ label, org }: { label: string; org?: boolean }) {
-  const { avatarRef, avatarUrl } = useVisibleAvatarUrl(org ? null : label);
-
-  if (org) {
-    return (
-      <span
-        aria-hidden
-        className="inline-flex size-6 shrink-0 items-center justify-center rounded-full bg-muted text-[10px] font-semibold text-muted-foreground dark:bg-background"
-      >
-        <IconUsersGroup size={12} strokeWidth={1.75} />
-      </span>
-    );
-  }
-
-  return (
-    <UserAvatar ref={avatarRef} className="size-6 shrink-0">
-      {avatarUrl ? <UserAvatarImage src={avatarUrl} alt={label} /> : null}
-      <UserAvatarFallback className="bg-muted text-[10px] font-semibold text-muted-foreground dark:bg-background">
-        {(label.split("@")[0]?.[0] ?? label[0] ?? "?").toUpperCase()}
-      </UserAvatarFallback>
-    </UserAvatar>
-  );
-}
-
-export function AccessAccordionRow({
-  icon,
-  label,
-  meta,
-  disabled,
-  open,
-  onOpenChange,
-  children,
-}: {
-  icon: ReactNode;
-  label: ReactNode;
-  meta?: ReactNode;
-  disabled?: boolean;
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  children?: ReactNode;
-}) {
-  const summary = (
-    <>
-      {icon}
-      <span className="min-w-0 flex-1 truncate text-sm">{label}</span>
-      {meta ? (
-        <span className="shrink-0 truncate text-xs text-muted-foreground">
-          {meta}
-        </span>
-      ) : null}
-    </>
-  );
-
-  if (!children) {
-    return (
-      <div className="flex min-h-8 w-full items-center gap-2 px-1.5 py-1">
-        {summary}
-      </div>
-    );
-  }
-
-  return (
-    <Collapsible open={open} onOpenChange={onOpenChange}>
-      <CollapsibleTrigger
-        disabled={disabled}
-        className="flex min-h-8 w-full cursor-pointer items-center gap-2 rounded-md px-1.5 py-1 text-start transition-colors hover:bg-muted/50 disabled:pointer-events-none disabled:opacity-50"
-      >
-        {summary}
-        {/* Sized like the row-level remove button so both trailing icons
-            share the same optical center. */}
-        <span className="flex size-6 shrink-0 items-center justify-center">
-          <IconChevronDown
-            aria-hidden
-            className={cn(
-              "size-3.5 opacity-50 transition-transform",
-              open && "rotate-180",
-            )}
-          />
-        </span>
-      </CollapsibleTrigger>
-      <CollapsibleContent className="clips-collapsible-content">
-        <div className="pt-1">{children}</div>
-      </CollapsibleContent>
-    </Collapsible>
-  );
-}
-
-const ACCESS_ORDER: Visibility[] = ["public", "org", "private"];
-
-export function GeneralAccessSelect({
-  visibility,
-  canManage,
-  isPending,
-  onChange,
-}: {
-  visibility: Visibility;
-  canManage: boolean;
-  isPending: boolean;
-  onChange: (next: Visibility) => void;
-}) {
-  const t = useT();
-  const { data: org } = useOrg();
-  const orgName = org?.orgName;
-  const meta = VIS_META[visibility];
-
-  const optionLabel = (value: Visibility) => {
-    if (value !== "org") return t(`shareUi.accessOptions.${value}`);
-    return orgName
-      ? t("shareUi.accessOptions.org", { orgName })
-      : t("shareUi.accessOptions.orgFallback");
-  };
-
-  return (
-    <Select
-      value={visibility}
-      onValueChange={(v) => onChange(v as Visibility)}
-      disabled={!canManage || isPending}
-    >
-      {/* The trigger spans the whole row so the hover affordance matches the
-          hit area. The icon is a bare svg, not a wrapped span, because the
-          shared trigger applies line-clamp to every direct span child. */}
-      <SelectTrigger
-        size="sm"
-        aria-label={t("shareUi.selectAccess")}
-        className="w-full cursor-pointer justify-start gap-2 rounded-md border-0 bg-transparent px-1.5 py-1 text-sm shadow-none transition-colors hover:bg-muted/50 focus:ring-0 focus:ring-offset-0 [&>span]:flex-1 [&>span]:text-start [&>svg:last-child]:me-1"
-      >
-        <meta.Icon
-          aria-hidden
-          strokeWidth={1.75}
-          className="size-6 shrink-0 rounded-full bg-muted p-1.5 text-muted-foreground"
-        />
-        <SelectValue>{optionLabel(visibility)}</SelectValue>
-      </SelectTrigger>
-      <SelectContent align="start">
-        {ACCESS_ORDER.map((value) => {
-          const OptionIcon = VIS_META[value].Icon;
-          return (
-            <SelectItem
-              key={value}
-              value={value}
-              className="ps-2 pe-8 [&>span:first-child]:start-auto [&>span:first-child]:end-2"
-            >
-              <span className="flex items-center gap-2">
-                <OptionIcon
-                  aria-hidden
-                  size={16}
-                  strokeWidth={1.75}
-                  className="shrink-0 text-muted-foreground"
-                />
-                {optionLabel(value)}
-              </span>
-            </SelectItem>
-          );
-        })}
-      </SelectContent>
-    </Select>
-  );
-}
-
-export function InvitePeopleField({
-  resourceType,
-  resourceId,
-  resourceUrl,
-  sharesQuery,
-  onError,
-}: {
-  resourceType: string;
-  resourceId: string;
-  resourceUrl?: string;
-  sharesQuery: SharesQuery;
-  onError?: (err: unknown) => void;
-}) {
-  const t = useT();
-  const share = useActionMutation("share-resource");
-  const [email, setEmail] = useState("");
-  const [role, setRole] = useState<Role>("viewer");
-  const [notifyPeople, setNotifyPeople] = useState(true);
-  const hasInviteEmail = email.trim().length > 0;
-
-  const handleAdd = () => {
-    const trimmed = email.trim().toLowerCase();
-    if (!trimmed) return;
-    share.mutate(
-      {
-        resourceType,
-        resourceId,
-        principalType: "user",
-        principalId: trimmed,
-        role,
-        notify: notifyPeople,
-        ...(resourceUrl ? { resourceUrl } : {}),
-      } as any,
-      {
-        onSuccess: () => {
-          setEmail("");
-          void sharesQuery.refetch();
-        },
-        onError: (err: unknown) => onError?.(err),
-      },
-    );
-  };
-
-  return (
-    <div className="space-y-2">
-      <div className="flex items-stretch gap-1.5">
-        <div className="flex h-8 min-w-0 flex-1 items-center overflow-hidden rounded-md border border-input bg-background focus-within:ring-1 focus-within:ring-ring">
-          <Input
-            type="email"
-            placeholder={t("shareUi.addPeopleByEmail")}
-            value={email}
-            onChange={(e) => setEmail(e.target.value)}
-            onKeyDown={(e) => {
-              if (e.key === "Enter") handleAdd();
-            }}
-            autoComplete="off"
-            className="h-full min-w-0 flex-1 rounded-none border-0 bg-transparent text-sm shadow-none focus-visible:ring-0 focus-visible:ring-offset-0"
-          />
-          <Select value={role} onValueChange={(v) => setRole(v as Role)}>
-            <SelectTrigger className="h-full w-auto shrink-0 gap-1 rounded-none border-0 bg-transparent px-2 text-xs text-muted-foreground shadow-none focus:ring-0 focus:ring-offset-0">
-              <SelectValue>{t(`shareUi.roles.${role}`)}</SelectValue>
-            </SelectTrigger>
-            <SelectContent align="end">
-              {ROLE_OPTIONS.map((opt) => (
-                <SelectItem key={opt.value} value={opt.value}>
-                  {t(`shareUi.roles.${opt.value}`)}
-                </SelectItem>
-              ))}
-            </SelectContent>
-          </Select>
-        </div>
-        <Button
-          type="button"
-          size="icon-sm"
-          onClick={handleAdd}
-          disabled={!hasInviteEmail || share.isPending}
-          aria-label={t("shareUi.invite")}
-          title={t("shareUi.invite")}
-          className="shrink-0"
-        >
-          <IconSend2 size={16} />
-        </Button>
-      </div>
-      {hasInviteEmail ? (
-        <label className="flex items-center gap-2 text-xs text-muted-foreground">
-          <Checkbox
-            checked={notifyPeople}
-            onCheckedChange={(checked) => setNotifyPeople(checked === true)}
-          />
-          {t("shareUi.notifyPeople")}
-        </label>
-      ) : null}
-    </div>
-  );
-}
-
-export function PeopleAccessSection({
-  resourceType,
-  resourceId,
-  sharesQuery,
-  canManage,
-  roleCopy,
-  onError,
-}: {
-  resourceType: string;
-  resourceId: string;
-  sharesQuery: SharesQuery;
-  canManage: boolean;
-  roleCopy?: Partial<Record<Role, RoleCopy>>;
-  onError?: (err: unknown, action: "permission" | "remove") => void;
-}) {
-  const t = useT();
-  const data = sharesQuery.data;
-  const people = useMemo(
-    () => [
-      ...(data?.ownerEmail ? [data.ownerEmail] : []),
-      ...(data?.shares.map((s) => s.principalId) ?? []),
-    ],
-    [data],
-  );
-  const [first, ...rest] = people;
-  const [open, setOpen] = useState(false);
-
-  const firstShare = data?.shares.find((s) => s.principalId === first);
-  const firstRole = firstShare
-    ? (roleCopy?.[firstShare.role]?.label ??
-      t(`shareUi.roles.${firstShare.role}`))
-    : t("shareUi.ownerRole");
-
-  return (
-    <AccessAccordionRow
-      icon={
-        first ? (
-          <Avatar label={first} />
-        ) : (
-          <span className="inline-block size-6 shrink-0 rounded-full bg-muted" />
-        )
-      }
-      label={
-        !first
-          ? t("shareUi.onlyYou")
-          : open || rest.length === 0
-            ? first
-            : t("shareUi.othersCount", { count: rest.length, email: first })
-      }
-      meta={
-        first && (open || rest.length === 0)
-          ? firstRole
-          : t("shareUi.canAccess")
-      }
-      disabled={sharesQuery.isLoading}
-      open={open}
-      onOpenChange={setOpen}
-    >
-      {rest.length > 0 ? (
-        <PeopleAccessSettingsBody
-          resourceType={resourceType}
-          resourceId={resourceId}
-          sharesQuery={sharesQuery}
-          canManage={canManage}
-          roleCopy={roleCopy}
-          onError={onError}
-          excludePrincipalId={first}
-        />
-      ) : null}
-    </AccessAccordionRow>
-  );
-}
-
-export function PeopleAccessSettingsBody({
-  resourceType,
-  resourceId,
-  sharesQuery,
-  canManage,
-  roleCopy,
-  onError,
-  excludePrincipalId,
-}: {
-  resourceType: string;
-  resourceId: string;
-  sharesQuery: SharesQuery;
-  canManage: boolean;
-  roleCopy?: Partial<Record<Role, RoleCopy>>;
-  onError?: (err: unknown, action: "permission" | "remove") => void;
-  excludePrincipalId?: string;
-}) {
-  const t = useT();
-  const share = useActionMutation("share-resource");
-  const unshare = useActionMutation("unshare-resource");
-  const data = sharesQuery.data;
-  const ownerEmail = data?.ownerEmail ?? null;
-  const showOwner = ownerEmail !== null && ownerEmail !== excludePrincipalId;
-  const shares = (data?.shares ?? []).filter(
-    (s) => s.principalId !== excludePrincipalId,
-  );
-  const getRoleLabel = (value: Role) =>
-    roleCopy?.[value]?.label ?? t(`shareUi.roles.${value}`);
-
-  const handleChangeRole = (s: Share, nextRole: Role) => {
-    if (nextRole === s.role) return;
-    share.mutate(
-      {
-        resourceType,
-        resourceId,
-        principalType: s.principalType,
-        principalId: s.principalId,
-        role: nextRole,
-        notify: false,
-      } as any,
-      {
-        onSuccess: () => sharesQuery.refetch(),
-        onError: (err: unknown) => onError?.(err, "permission"),
-      },
-    );
-  };
-
-  const handleRemove = (s: Share) => {
-    unshare.mutate(
-      {
-        resourceType,
-        resourceId,
-        principalType: s.principalType,
-        principalId: s.principalId,
-      } as any,
-      {
-        onSuccess: () => sharesQuery.refetch(),
-        onError: (err: unknown) => onError?.(err, "remove"),
-      },
-    );
-  };
-
-  return (
-    <ul className="flex max-h-72 flex-col gap-1 overflow-y-auto p-0 m-0">
-      {showOwner ? (
-        <li className="flex min-h-8 items-center gap-2 px-1.5 py-1 text-sm">
-          <Avatar label={ownerEmail} />
-          <span className="min-w-0 flex-1 truncate">{ownerEmail}</span>
-          <span className="text-xs text-muted-foreground">
-            {t("shareUi.ownerRole")}
-          </span>
-        </li>
-      ) : null}
-
-      {shares.map((s) => (
-        <li
-          key={`${s.principalType}:${s.principalId}`}
-          className="flex min-h-8 items-center gap-2 px-1.5 py-1 text-sm"
-        >
-          <Avatar label={s.principalId} org={s.principalType === "org"} />
-          <span className="min-w-0 flex-1 truncate">{s.principalId}</span>
-          {canManage ? (
-            <Select
-              value={s.role}
-              onValueChange={(value) => handleChangeRole(s, value as Role)}
-              disabled={share.isPending}
-            >
-              <SelectTrigger
-                size="sm"
-                className="w-auto shrink-0 gap-1 border-0 bg-transparent px-2 text-xs text-muted-foreground shadow-none focus:ring-0"
-              >
-                <SelectValue>{getRoleLabel(s.role)}</SelectValue>
-              </SelectTrigger>
-              <SelectContent align="end">
-                {ROLE_OPTIONS.map((opt) => (
-                  <SelectItem key={opt.value} value={opt.value}>
-                    {getRoleLabel(opt.value)}
-                  </SelectItem>
-                ))}
-              </SelectContent>
-            </Select>
-          ) : (
-            <span className="shrink-0 text-xs text-muted-foreground">
-              {getRoleLabel(s.role)}
-            </span>
-          )}
-          {canManage ? (
-            <Button
-              type="button"
-              variant="ghost"
-              size="icon"
-              aria-label={t("shareUi.remove")}
-              onClick={() => handleRemove(s)}
-              className="h-7 w-7 shrink-0 text-muted-foreground"
-            >
-              <IconTrash size={14} />
-            </Button>
-          ) : null}
-        </li>
-      ))}
-
-      {!shares.length && !showOwner ? (
-        <li className="px-1 py-1.5 text-sm text-muted-foreground">
-          {t("shareUi.noAccessYet")}
-        </li>
-      ) : null}
-    </ul>
-  );
-}

package/corpus/templates/clips/changelog/2026-10-16-share-dialogs-make-it-easier-to-see-who-has-access-and-manag.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-10-16
+---
+
+Share dialogs make it easier to see who has access and manage common sharing changes.

package/corpus/templates/clips/changelog/2026-10-21-share-panels-describe-general-access-in-a-sentence.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-10-21
+---
+
+Share panels describe general access in a sentence and no longer open an empty people list when you click into them.

package/corpus/templates/community/qr/package.json

@@ -11,7 +11,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@agent-native/core": "^0.216.0",
+    "@agent-native/core": "^0.218.0",
     "postgres": "^3.4.9",
     "qrcode": "^1.5.4",
     "zod": "^4.6.7"

package/corpus/templates/content/.agents/skills/document-editing/references/databases.md

@@ -244,9 +244,12 @@ supports searching property types by label or machine name.
 List views can save an item layout (`itemLayout`) that decides what each row
 shows: a start slot (page icon, a checkbox property, a status property, or
 nothing), the title weight, line 2 (a text, URL, or non-body Blocks property,
-clamped to 1-3 lines), and ordered property IDs for line 3 and the end of the
-row; end values move under the title on narrow screens and empty values take
-no space. Ticking a row's checkbox writes the property through
+or with `source: "page"` the first lines of each row's page, clamped to 1-3
+lines), and ordered property IDs for line 3 and the end of the row; end values
+move under the title on narrow screens and empty values take no space. While
+any list view shows page text, collection reads give each item an `excerpt`
+with the start of its page as plain text; other collections leave page bodies
+out of row reads. Ticking a row's checkbox writes the property through
 `set-document-property` and strikes the title through without moving the row.
 A view without `itemLayout` keeps the default rows. Agents update it with an
 `update-content-database-view` `update` patch on the list view: pass