@chipi-stack/chipi-react 14.8.0 → 14.10.0

package/dist/multisig.d.mts

@@ -1,4 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
 
 /**
  * Framework-agnostic action-template engine for SHHH multisig governance.
@@ -71,6 +73,12 @@ interface ActionTemplate<V = Record<string, unknown>> {
     /** Optional metadata persisted with the proposal so the approver's app
      *  can render business context (e.g. `{ poolId }`). */
     meta?: (v: V) => Record<string, string | number>;
+    /** App-level risk tier (decision §11.4). When the treasury configured the
+     *  matching quorum, the backend OVERRIDES requiredApprovals at propose
+     *  (ROUTINE → routineQuorum, SENSITIVE → sensitiveQuorum). App-enforced
+     *  for human treasuries — the on-chain wallet threshold stays the hard
+     *  floor at execute. Omit = no tier (the client's value is used). */
+    risk?: "ROUTINE" | "SENSITIVE";
 }
 /** Starknet felt252 field prime — args must be a non-negative felt below it. */
 declare const FELT_PRIME: bigint;
@@ -206,6 +214,8 @@ interface TreasuryProposal {
     title?: string | null;
     /** Arbitrary integrator context (e.g. `{ poolId }`). */
     meta?: Record<string, string | number> | null;
+    /** App-level risk tier the proposal was filed under (null = none). */
+    risk?: "ROUTINE" | "SENSITIVE" | null;
     oeMessageHash: string;
     oeNonce: string | null;
     oeExecuteBefore: string | null;
@@ -227,6 +237,8 @@ interface ProposeBody {
         calldata: string[];
     }[];
     meta?: Record<string, string | number>;
+    /** Template risk tier — lets the backend apply the treasury's quorum policy. */
+    risk?: "ROUTINE" | "SENSITIVE";
     oeMessageHash: string;
     oeNonce: string;
     oeExecuteBefore: string;
@@ -347,4 +359,124 @@ declare function useTreasuryProposals(config: {
     }, Error, TreasuryProposal, unknown>;
 };
 
-export { type ActionProposal, type ActionTemplate, type CallSpec, FELT_PRIME, type FeltLike, type FieldSpec, type MultisigSigner, type MultisigTransport, OE_WINDOW_SECONDS, type OeSigner, type ProposalSignature, type ProposeBody, type ProposeInput, SN_MAIN_CHAIN_ID, type TreasuryProposal, type VoteValues, amountToBase, assembleActionExecuteCalldata, buildActionProposal, buildApproval, buildExecuteCalldata, createProposal, defineActions, deriveExecuteAfter, deserializeEnvelope, newOeNonce, serializeEnvelope, signActionApproval, toFelt, u256, useProposeAction, useTreasuryProposals, voteTemplate };
+/**
+ * Theming for the embeddable governance components (design brief §8).
+ *
+ * One mechanism: every component root carries inline CSS variables derived
+ * from a `theme` prop merged over the defaults, and a single namespaced
+ * stylesheet (injected once at runtime) styles everything off those vars.
+ * Integrators theme by passing tokens — `<Approvals theme={{ accent:
+ * "#0f766e", radius: "0.375rem" }} />` — and the components render native
+ * to the host app. No Tailwind/CSS-import requirement; SSR-safe (the
+ * stylesheet injects in an effect, and first paint is already var-driven).
+ *
+ * Default skin = the Chipi neobrutalism system: bold borders, hard offset
+ * shadow, high-contrast text.
+ */
+interface ChipiGovTheme {
+    /** Primary action color (buttons, focus, progress). */
+    accent?: string;
+    /** Text color on the accent. */
+    accentText?: string;
+    /** Card/dialog background. */
+    surface?: string;
+    /** Page-muted background (rows, inputs). */
+    surfaceMuted?: string;
+    /** Primary text. */
+    text?: string;
+    /** Secondary text. */
+    textMuted?: string;
+    /** Error/destructive color. */
+    danger?: string;
+    /** Success color (executed, looks-good). */
+    success?: string;
+    /** Border color. */
+    border?: string;
+    /** Corner radius (any CSS length). */
+    radius?: string;
+    /** Hard offset shadow (set to "none" for flat hosts). */
+    shadow?: string;
+    /** Font stack. */
+    font?: string;
+}
+declare const DEFAULT_THEME: Required<ChipiGovTheme>;
+/** Inline CSS-var style object for a component root. */
+declare function themeVars(theme?: ChipiGovTheme): Record<string, string>;
+/** Idempotently inject the component stylesheet into the document head. */
+declare function injectGovStyles(): void;
+
+/** Light per-type syntax check; returns a human error or null. */
+declare function fieldSyntaxError(field: FieldSpec, raw: string): string | null;
+declare function FieldInput(props: {
+    field: FieldSpec;
+    value: string;
+    onChange: (raw: string) => void;
+    /** Shown once the user has touched the field. */
+    error?: string | null;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+interface ProposeActionProps {
+    /** The treasury's SHHH wallet address. */
+    walletAddress: string;
+    /** Action templates the proposer can pick from (`defineActions(...)`). */
+    actions: ActionTemplate<any>[];
+    transport: MultisigTransport;
+    signer: MultisigSigner;
+    /** Read the wallet's current threshold (host-supplied; chain read). */
+    getRequiredApprovals: () => Promise<number>;
+    /** Preselect a template by key (also hides the tabs when it's the only one). */
+    preselect?: string;
+    /** Custom trigger; receives the open callback. Defaults to a button. */
+    trigger?: (open: () => void) => React.ReactNode;
+    theme?: ChipiGovTheme;
+    onProposed?: (proposal: TreasuryProposal) => void;
+    chainId?: string;
+}
+declare function ProposeAction(props: ProposeActionProps): react_jsx_runtime.JSX.Element;
+
+type ApprovalsFilter = "actionable" | "pending" | "all";
+interface ApprovalsProps {
+    /** The treasury's SHHH wallet address. */
+    walletAddress: string;
+    transport: MultisigTransport;
+    signer: MultisigSigner;
+    /** Inject business context per row (reads `proposal.meta`). */
+    renderContext?: (proposal: TreasuryProposal) => React.ReactNode;
+    /** actionable = needs me or ready; pending = not terminal; all. Default actionable. */
+    filter?: ApprovalsFilter;
+    theme?: ChipiGovTheme;
+    onExecuted?: (proposal: TreasuryProposal, txHash?: string) => void;
+    /** Custom empty state. */
+    empty?: React.ReactNode;
+    /** Build an explorer URL for an executed tx hash (row link). */
+    explorerTxUrl?: (txHash: string) => string;
+    /**
+     * Mark a proposal as filed by an AI agent (governance §9). When this
+     * returns true, the row reads "{agentLabel} wants: {title}" with an
+     * Agent chip — the founder-facing "your agent wants…" copy. The host
+     * decides agent-ness (it knows which owner index is its agent); the
+     * package stays chain-read-free.
+     */
+    isAgentProposal?: (proposal: TreasuryProposal) => boolean;
+    /** Label for agent rows (default "Agent"). */
+    agentLabel?: string;
+}
+/** Human fallback title for legacy payment proposals without `title`. */
+declare function proposalTitle(p: TreasuryProposal): string;
+declare function Approvals(props: ApprovalsProps): react_jsx_runtime.JSX.Element;
+
+interface InboxTreasury extends Pick<ApprovalsProps, "walletAddress" | "transport" | "signer" | "renderContext" | "explorerTxUrl" | "isAgentProposal" | "agentLabel"> {
+    /** Group heading ("Ops treasury", "Acme · Pool fund"). */
+    label: string;
+}
+interface ApprovalInboxProps {
+    treasuries: InboxTreasury[];
+    theme?: ChipiGovTheme;
+    /** Shown when every treasury is caught up. */
+    onEmpty?: React.ReactNode;
+    onExecuted?: (treasury: InboxTreasury, proposal: TreasuryProposal, txHash?: string) => void;
+}
+declare function ApprovalInbox(props: ApprovalInboxProps): react_jsx_runtime.JSX.Element;
+
+export { type ActionProposal, type ActionTemplate, ApprovalInbox, type ApprovalInboxProps, Approvals, type ApprovalsFilter, type ApprovalsProps, type CallSpec, type ChipiGovTheme, DEFAULT_THEME, FELT_PRIME, type FeltLike, FieldInput, type FieldSpec, type InboxTreasury, type MultisigSigner, type MultisigTransport, OE_WINDOW_SECONDS, type OeSigner, type ProposalSignature, ProposeAction, type ProposeActionProps, type ProposeBody, type ProposeInput, SN_MAIN_CHAIN_ID, type TreasuryProposal, type VoteValues, amountToBase, assembleActionExecuteCalldata, buildActionProposal, buildApproval, buildExecuteCalldata, createProposal, defineActions, deriveExecuteAfter, deserializeEnvelope, fieldSyntaxError, injectGovStyles, newOeNonce, proposalTitle, serializeEnvelope, signActionApproval, themeVars, toFelt, u256, useProposeAction, useTreasuryProposals, voteTemplate };

package/dist/multisig.d.ts

@@ -1,4 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
 
 /**
  * Framework-agnostic action-template engine for SHHH multisig governance.
@@ -71,6 +73,12 @@ interface ActionTemplate<V = Record<string, unknown>> {
     /** Optional metadata persisted with the proposal so the approver's app
      *  can render business context (e.g. `{ poolId }`). */
     meta?: (v: V) => Record<string, string | number>;
+    /** App-level risk tier (decision §11.4). When the treasury configured the
+     *  matching quorum, the backend OVERRIDES requiredApprovals at propose
+     *  (ROUTINE → routineQuorum, SENSITIVE → sensitiveQuorum). App-enforced
+     *  for human treasuries — the on-chain wallet threshold stays the hard
+     *  floor at execute. Omit = no tier (the client's value is used). */
+    risk?: "ROUTINE" | "SENSITIVE";
 }
 /** Starknet felt252 field prime — args must be a non-negative felt below it. */
 declare const FELT_PRIME: bigint;
@@ -206,6 +214,8 @@ interface TreasuryProposal {
     title?: string | null;
     /** Arbitrary integrator context (e.g. `{ poolId }`). */
     meta?: Record<string, string | number> | null;
+    /** App-level risk tier the proposal was filed under (null = none). */
+    risk?: "ROUTINE" | "SENSITIVE" | null;
     oeMessageHash: string;
     oeNonce: string | null;
     oeExecuteBefore: string | null;
@@ -227,6 +237,8 @@ interface ProposeBody {
         calldata: string[];
     }[];
     meta?: Record<string, string | number>;
+    /** Template risk tier — lets the backend apply the treasury's quorum policy. */
+    risk?: "ROUTINE" | "SENSITIVE";
     oeMessageHash: string;
     oeNonce: string;
     oeExecuteBefore: string;
@@ -347,4 +359,124 @@ declare function useTreasuryProposals(config: {
     }, Error, TreasuryProposal, unknown>;
 };
 
-export { type ActionProposal, type ActionTemplate, type CallSpec, FELT_PRIME, type FeltLike, type FieldSpec, type MultisigSigner, type MultisigTransport, OE_WINDOW_SECONDS, type OeSigner, type ProposalSignature, type ProposeBody, type ProposeInput, SN_MAIN_CHAIN_ID, type TreasuryProposal, type VoteValues, amountToBase, assembleActionExecuteCalldata, buildActionProposal, buildApproval, buildExecuteCalldata, createProposal, defineActions, deriveExecuteAfter, deserializeEnvelope, newOeNonce, serializeEnvelope, signActionApproval, toFelt, u256, useProposeAction, useTreasuryProposals, voteTemplate };
+/**
+ * Theming for the embeddable governance components (design brief §8).
+ *
+ * One mechanism: every component root carries inline CSS variables derived
+ * from a `theme` prop merged over the defaults, and a single namespaced
+ * stylesheet (injected once at runtime) styles everything off those vars.
+ * Integrators theme by passing tokens — `<Approvals theme={{ accent:
+ * "#0f766e", radius: "0.375rem" }} />` — and the components render native
+ * to the host app. No Tailwind/CSS-import requirement; SSR-safe (the
+ * stylesheet injects in an effect, and first paint is already var-driven).
+ *
+ * Default skin = the Chipi neobrutalism system: bold borders, hard offset
+ * shadow, high-contrast text.
+ */
+interface ChipiGovTheme {
+    /** Primary action color (buttons, focus, progress). */
+    accent?: string;
+    /** Text color on the accent. */
+    accentText?: string;
+    /** Card/dialog background. */
+    surface?: string;
+    /** Page-muted background (rows, inputs). */
+    surfaceMuted?: string;
+    /** Primary text. */
+    text?: string;
+    /** Secondary text. */
+    textMuted?: string;
+    /** Error/destructive color. */
+    danger?: string;
+    /** Success color (executed, looks-good). */
+    success?: string;
+    /** Border color. */
+    border?: string;
+    /** Corner radius (any CSS length). */
+    radius?: string;
+    /** Hard offset shadow (set to "none" for flat hosts). */
+    shadow?: string;
+    /** Font stack. */
+    font?: string;
+}
+declare const DEFAULT_THEME: Required<ChipiGovTheme>;
+/** Inline CSS-var style object for a component root. */
+declare function themeVars(theme?: ChipiGovTheme): Record<string, string>;
+/** Idempotently inject the component stylesheet into the document head. */
+declare function injectGovStyles(): void;
+
+/** Light per-type syntax check; returns a human error or null. */
+declare function fieldSyntaxError(field: FieldSpec, raw: string): string | null;
+declare function FieldInput(props: {
+    field: FieldSpec;
+    value: string;
+    onChange: (raw: string) => void;
+    /** Shown once the user has touched the field. */
+    error?: string | null;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+interface ProposeActionProps {
+    /** The treasury's SHHH wallet address. */
+    walletAddress: string;
+    /** Action templates the proposer can pick from (`defineActions(...)`). */
+    actions: ActionTemplate<any>[];
+    transport: MultisigTransport;
+    signer: MultisigSigner;
+    /** Read the wallet's current threshold (host-supplied; chain read). */
+    getRequiredApprovals: () => Promise<number>;
+    /** Preselect a template by key (also hides the tabs when it's the only one). */
+    preselect?: string;
+    /** Custom trigger; receives the open callback. Defaults to a button. */
+    trigger?: (open: () => void) => React.ReactNode;
+    theme?: ChipiGovTheme;
+    onProposed?: (proposal: TreasuryProposal) => void;
+    chainId?: string;
+}
+declare function ProposeAction(props: ProposeActionProps): react_jsx_runtime.JSX.Element;
+
+type ApprovalsFilter = "actionable" | "pending" | "all";
+interface ApprovalsProps {
+    /** The treasury's SHHH wallet address. */
+    walletAddress: string;
+    transport: MultisigTransport;
+    signer: MultisigSigner;
+    /** Inject business context per row (reads `proposal.meta`). */
+    renderContext?: (proposal: TreasuryProposal) => React.ReactNode;
+    /** actionable = needs me or ready; pending = not terminal; all. Default actionable. */
+    filter?: ApprovalsFilter;
+    theme?: ChipiGovTheme;
+    onExecuted?: (proposal: TreasuryProposal, txHash?: string) => void;
+    /** Custom empty state. */
+    empty?: React.ReactNode;
+    /** Build an explorer URL for an executed tx hash (row link). */
+    explorerTxUrl?: (txHash: string) => string;
+    /**
+     * Mark a proposal as filed by an AI agent (governance §9). When this
+     * returns true, the row reads "{agentLabel} wants: {title}" with an
+     * Agent chip — the founder-facing "your agent wants…" copy. The host
+     * decides agent-ness (it knows which owner index is its agent); the
+     * package stays chain-read-free.
+     */
+    isAgentProposal?: (proposal: TreasuryProposal) => boolean;
+    /** Label for agent rows (default "Agent"). */
+    agentLabel?: string;
+}
+/** Human fallback title for legacy payment proposals without `title`. */
+declare function proposalTitle(p: TreasuryProposal): string;
+declare function Approvals(props: ApprovalsProps): react_jsx_runtime.JSX.Element;
+
+interface InboxTreasury extends Pick<ApprovalsProps, "walletAddress" | "transport" | "signer" | "renderContext" | "explorerTxUrl" | "isAgentProposal" | "agentLabel"> {
+    /** Group heading ("Ops treasury", "Acme · Pool fund"). */
+    label: string;
+}
+interface ApprovalInboxProps {
+    treasuries: InboxTreasury[];
+    theme?: ChipiGovTheme;
+    /** Shown when every treasury is caught up. */
+    onEmpty?: React.ReactNode;
+    onExecuted?: (treasury: InboxTreasury, proposal: TreasuryProposal, txHash?: string) => void;
+}
+declare function ApprovalInbox(props: ApprovalInboxProps): react_jsx_runtime.JSX.Element;
+
+export { type ActionProposal, type ActionTemplate, ApprovalInbox, type ApprovalInboxProps, Approvals, type ApprovalsFilter, type ApprovalsProps, type CallSpec, type ChipiGovTheme, DEFAULT_THEME, FELT_PRIME, type FeltLike, FieldInput, type FieldSpec, type InboxTreasury, type MultisigSigner, type MultisigTransport, OE_WINDOW_SECONDS, type OeSigner, type ProposalSignature, ProposeAction, type ProposeActionProps, type ProposeBody, type ProposeInput, SN_MAIN_CHAIN_ID, type TreasuryProposal, type VoteValues, amountToBase, assembleActionExecuteCalldata, buildActionProposal, buildApproval, buildExecuteCalldata, createProposal, defineActions, deriveExecuteAfter, deserializeEnvelope, fieldSyntaxError, injectGovStyles, newOeNonce, proposalTitle, serializeEnvelope, signActionApproval, themeVars, toFelt, u256, useProposeAction, useTreasuryProposals, voteTemplate };