@pragma-sh/scratchpad 0.1.0

package/dist/ui.d.cts

@@ -0,0 +1,90 @@
+export * from "@pragma-sh/sdk";
+/** Context passed when a scratchpad action has no attached agent tab. */
+interface MissingAgentContext {
+	text: string;
+	attach(): Promise<boolean>;
+}
+/** Options for {@link promptAgent}. */
+interface PromptAgentOptions {
+	onMissingAgent?: (context: MissingAgentContext) => void | boolean | Promise<void | boolean>;
+}
+import { ButtonHTMLAttributes, HTMLAttributes, InputHTMLAttributes, ProgressHTMLAttributes, TextareaHTMLAttributes } from "react";
+/** Visual weight of a scratchpad {@link Button}. */
+type ButtonVariant = "primary" | "secondary" | "outline" | "ghost" | "danger";
+/** Semantic color of a {@link Badge} or {@link Progress}. */
+type Tone = "neutral" | "primary" | "success" | "warning" | "danger";
+/** Props for {@link Button}. */
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+	variant?: ButtonVariant;
+	size?: "sm" | "md";
+}
+/** Scratchpad button matching desktop shadcn button proportions and tokens. */
+declare function Button({ className, size, type, variant,...rest }: ButtonProps): React.JSX.Element;
+/** Scratchpad single-line input matching desktop shadcn input tokens. */
+declare function Input({ className,...rest }: InputHTMLAttributes<HTMLInputElement>): React.JSX.Element;
+/** Scratchpad multiline input matching desktop shadcn textarea tokens. */
+declare function Textarea({ className,...rest }: TextareaHTMLAttributes<HTMLTextAreaElement>): React.JSX.Element;
+/** Props for {@link Progress}. */
+interface ProgressProps extends ProgressHTMLAttributes<HTMLProgressElement> {
+	tone?: Tone;
+}
+/** Scratchpad progress bar using desktop semantic colors. */
+declare function Progress({ className, style, tone,...rest }: ProgressProps): React.JSX.Element;
+/** Surface that frames one scratchpad component, matching desktop cards. */
+declare function Card({ className,...rest }: HTMLAttributes<HTMLElement>): React.JSX.Element;
+/** Props for {@link Badge}. */
+interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+	tone?: Tone;
+}
+/** Small state pill; color communicates state, never decoration. */
+declare function Badge({ className, tone,...rest }: BadgeProps): React.JSX.Element;
+/** Props for a live, read-only whiteboard rendering. */
+interface WhiteboardProps {
+	id: string;
+	/** Poll interval for host-side version checks. Set to zero to disable polling. */
+	refreshIntervalMs?: number;
+}
+/** Live read-only PNG rendering of a worktree-scoped Pragma whiteboard. */
+declare function Whiteboard({ id, refreshIntervalMs }: WhiteboardProps): React.JSX.Element;
+/** One labeled answer option for {@link AskQuestion}. */
+interface AskQuestionOption {
+	label: string;
+	value?: string;
+}
+/**
+* Shape of an {@link AskQuestion}: a single choice (`options`, `yes-no`), any
+* number of choices (`multi-select`), or free text only (`text`). Every choice
+* shape renders the same list — radios for a single answer, checkboxes for
+* `multi-select`.
+*/
+type AskQuestionType = "options" | "yes-no" | "multi-select" | "text";
+/** Props for {@link AskQuestion}. */
+interface AskQuestionProps extends PromptAgentOptions {
+	question: string;
+	type?: AskQuestionType;
+	options?: readonly AskQuestionOption[];
+	/** Appends an "Other" choice that reveals a free-text field when selected. */
+	allowOpenResponse?: boolean;
+	submitLabel?: string;
+	onAnswer?: (answer: string) => void | Promise<void>;
+}
+/** Interactive question whose answer is sent to attached agent tab. */
+declare function AskQuestion({ question, type, options, allowOpenResponse, submitLabel, onAnswer, onMissingAgent }: AskQuestionProps): React.JSX.Element;
+/** Props for {@link DiffReview}. */
+interface DiffReviewProps extends PromptAgentOptions {
+	title?: string;
+	before: string;
+	after: string;
+	file?: string;
+	onDecision?: (accepted: boolean) => void | Promise<void>;
+}
+/** Before/after review card that returns accept/reject decision to attached agent. */
+declare function DiffReview({ title, before, after, file, onDecision, onMissingAgent }: DiffReviewProps): React.JSX.Element;
+/** Props for {@link AgentProgress}. */
+interface AgentProgressProps {
+	tabIds: readonly string[];
+	title?: string;
+}
+/** Live progress for any set of same-worktree agent tab IDs. */
+declare function AgentProgress({ tabIds, title }: AgentProgressProps): React.JSX.Element;
+export { WhiteboardProps, Whiteboard, Tone, Textarea, ProgressProps, Progress, Input, DiffReviewProps, DiffReview, Card, ButtonVariant, ButtonProps, Button, BadgeProps, Badge, AskQuestionType, AskQuestionProps, AskQuestionOption, AskQuestion, AgentProgressProps, AgentProgress };

package/dist/ui.d.ts

@@ -0,0 +1,90 @@
+export * from "@pragma-sh/sdk";
+/** Context passed when a scratchpad action has no attached agent tab. */
+interface MissingAgentContext {
+	text: string;
+	attach(): Promise<boolean>;
+}
+/** Options for {@link promptAgent}. */
+interface PromptAgentOptions {
+	onMissingAgent?: (context: MissingAgentContext) => void | boolean | Promise<void | boolean>;
+}
+import { ButtonHTMLAttributes, HTMLAttributes, InputHTMLAttributes, ProgressHTMLAttributes, TextareaHTMLAttributes } from "react";
+/** Visual weight of a scratchpad {@link Button}. */
+type ButtonVariant = "primary" | "secondary" | "outline" | "ghost" | "danger";
+/** Semantic color of a {@link Badge} or {@link Progress}. */
+type Tone = "neutral" | "primary" | "success" | "warning" | "danger";
+/** Props for {@link Button}. */
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+	variant?: ButtonVariant;
+	size?: "sm" | "md";
+}
+/** Scratchpad button matching desktop shadcn button proportions and tokens. */
+declare function Button({ className, size, type, variant,...rest }: ButtonProps): React.JSX.Element;
+/** Scratchpad single-line input matching desktop shadcn input tokens. */
+declare function Input({ className,...rest }: InputHTMLAttributes<HTMLInputElement>): React.JSX.Element;
+/** Scratchpad multiline input matching desktop shadcn textarea tokens. */
+declare function Textarea({ className,...rest }: TextareaHTMLAttributes<HTMLTextAreaElement>): React.JSX.Element;
+/** Props for {@link Progress}. */
+interface ProgressProps extends ProgressHTMLAttributes<HTMLProgressElement> {
+	tone?: Tone;
+}
+/** Scratchpad progress bar using desktop semantic colors. */
+declare function Progress({ className, style, tone,...rest }: ProgressProps): React.JSX.Element;
+/** Surface that frames one scratchpad component, matching desktop cards. */
+declare function Card({ className,...rest }: HTMLAttributes<HTMLElement>): React.JSX.Element;
+/** Props for {@link Badge}. */
+interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+	tone?: Tone;
+}
+/** Small state pill; color communicates state, never decoration. */
+declare function Badge({ className, tone,...rest }: BadgeProps): React.JSX.Element;
+/** Props for a live, read-only whiteboard rendering. */
+interface WhiteboardProps {
+	id: string;
+	/** Poll interval for host-side version checks. Set to zero to disable polling. */
+	refreshIntervalMs?: number;
+}
+/** Live read-only PNG rendering of a worktree-scoped Pragma whiteboard. */
+declare function Whiteboard({ id, refreshIntervalMs }: WhiteboardProps): React.JSX.Element;
+/** One labeled answer option for {@link AskQuestion}. */
+interface AskQuestionOption {
+	label: string;
+	value?: string;
+}
+/**
+* Shape of an {@link AskQuestion}: a single choice (`options`, `yes-no`), any
+* number of choices (`multi-select`), or free text only (`text`). Every choice
+* shape renders the same list — radios for a single answer, checkboxes for
+* `multi-select`.
+*/
+type AskQuestionType = "options" | "yes-no" | "multi-select" | "text";
+/** Props for {@link AskQuestion}. */
+interface AskQuestionProps extends PromptAgentOptions {
+	question: string;
+	type?: AskQuestionType;
+	options?: readonly AskQuestionOption[];
+	/** Appends an "Other" choice that reveals a free-text field when selected. */
+	allowOpenResponse?: boolean;
+	submitLabel?: string;
+	onAnswer?: (answer: string) => void | Promise<void>;
+}
+/** Interactive question whose answer is sent to attached agent tab. */
+declare function AskQuestion({ question, type, options, allowOpenResponse, submitLabel, onAnswer, onMissingAgent }: AskQuestionProps): React.JSX.Element;
+/** Props for {@link DiffReview}. */
+interface DiffReviewProps extends PromptAgentOptions {
+	title?: string;
+	before: string;
+	after: string;
+	file?: string;
+	onDecision?: (accepted: boolean) => void | Promise<void>;
+}
+/** Before/after review card that returns accept/reject decision to attached agent. */
+declare function DiffReview({ title, before, after, file, onDecision, onMissingAgent }: DiffReviewProps): React.JSX.Element;
+/** Props for {@link AgentProgress}. */
+interface AgentProgressProps {
+	tabIds: readonly string[];
+	title?: string;
+}
+/** Live progress for any set of same-worktree agent tab IDs. */
+declare function AgentProgress({ tabIds, title }: AgentProgressProps): React.JSX.Element;
+export { WhiteboardProps, Whiteboard, Tone, Textarea, ProgressProps, Progress, Input, DiffReviewProps, DiffReview, Card, ButtonVariant, ButtonProps, Button, BadgeProps, Badge, AskQuestionType, AskQuestionProps, AskQuestionOption, AskQuestion, AgentProgressProps, AgentProgress };