@nivaro/react 0.1.300 → 0.1.301

package/dist/index.d.ts

@@ -413,6 +413,8 @@ export declare function BroadcastView({ className }: {
     className?: string;
 }): JSX.Element;
 
+export declare function buildCopyAs(input: CopyAsInput): CopyAsSnippets;
+
 export declare function buildGroups<T extends QueueGroupingRow>(rows: T[], attribute: string): QueueGroup<T>[];
 
 export declare function BulkActionButtons({ targets, enabledKeys, tone, disabled, onDone }: {
@@ -1010,10 +1012,44 @@ export declare type ComponentOverrides = {
     fallback?: default_2.ComponentType<FieldComponentProps>;
 };
 
+/** The browser's conditions as the filter object the SDK and GraphQL take:
+ *  a dotted path folds into nested objects, an `or` group into `_or`, and
+ *  several conditions AND together. */
+export declare function conditionsToFilter(conditions: string | undefined): Record<string, unknown> | null;
+
 export declare function ConformanceView({ className }: {
     className?: string;
 }): JSX.Element;
 
+/**
+ * "Copy as …" (#654): the request behind a list or a record, as a curl
+ * command, an SDK call and a GraphQL document, each ready to paste. The
+ * token is always the `NIVARO_TOKEN` placeholder, never the viewer's own.
+ */
+export declare function CopyAsButton({ collection, itemId, list, fields, compact, className }: Omit<CopyAsInput, 'origin'> & {
+    /** Icon-only, borderless — for the record header's tool group. */
+    compact?: boolean;
+    className?: string;
+}): JSX.Element;
+
+declare interface CopyAsInput {
+    /** The host the API is served from, no trailing slash. */
+    origin: string;
+    collection: string;
+    /** A record id renders the single-record forms. */
+    itemId?: string | null;
+    list?: ListRequest;
+    /** Plain or dotted field keys the GraphQL selection lists (`id` is always
+     *  first; a key that starts with `__` is a synthetic column and skipped). */
+    fields?: string[];
+}
+
+declare interface CopyAsSnippets {
+    curl: string;
+    sdk: string;
+    graphql: string;
+}
+
 /**
  * `opts.open` is the gate's state AT CONSTRUCTION. A host that starts a
  * hidden tab must pass `false` here rather than calling `setOpen(false)`
@@ -3259,6 +3295,24 @@ export declare interface LeaderSocketHandle {
 
 export declare function listFieldInterfaces(): string[];
 
+/**
+ * "Copy as …" (#654): the request a list or record view is making, rendered
+ * as a curl command, an SDK call and a GraphQL document. Pure — no client,
+ * no DOM — so the three renderings can be judged against each other.
+ *
+ * The token is never the real one: every rendering names `NIVARO_TOKEN`.
+ */
+declare interface ListRequest {
+    /** The browser's `conditions` JSON (an array of {path, op, value} and
+     *  `{or: [...]}` groups), already serialised. */
+    conditions?: string;
+    search?: string;
+    /** Comma-joined sort, `-` prefix = descending. */
+    sort?: string;
+    limit?: number;
+    page?: number;
+}
+
 declare interface LockHolder {
     locked_by: string;
     locked_by_name: string | null;