api_binding_ui 0.0.0-stage → 1.0.0

package/dist/api-binding-ui.css

@@ -0,0 +1,244 @@
+/* src/styles/highradius-bridge.css */
+
+
+/* src/styles/index.css */
+
+
+/* src/styles/workspace.css */
+.binding-workspace, .api-binding, .binding-v2 {
+  display: flex;
+  background: var(--ds-color-background, #fff);
+  color: var(--ds-color-foreground, #0f172a);
+  font-family: var(--ds-font-family-sans, sans-serif);
+  flex-direction: column;
+  height: 100vh;
+}
+
+.binding-workspace h1, .api-binding h1, .binding-v2 h1 {
+  font-size: var(--ds-font-size-2xl, 1.5rem);
+  font-weight: var(--ds-font-weight-bold, 700);
+  margin: 0;
+}
+
+.binding-workspace h2, .api-binding h2, .binding-v2 h2 {
+  font-size: var(--ds-font-size-lg, 1.125rem);
+  font-weight: var(--ds-font-weight-semibold, 600);
+  margin: 0;
+}
+
+.binding-workspace h3, .api-binding h3, .binding-v2 h3 {
+  font-size: var(--ds-font-size-base, .875rem);
+  font-weight: var(--ds-font-weight-semibold, 600);
+  margin: 0;
+}
+
+.binding-workspace p, .api-binding p, .binding-v2 p {
+  line-height: var(--ds-line-height-normal, 1.5);
+  margin: 0;
+}
+
+.binding-header, .binding-footer, .binding-v2-header, .binding-v2-footer {
+  padding: var(--ds-page-padding, 1rem 1.5rem);
+  display: flex;
+  gap: var(--ds-space-4, 1rem);
+  flex-wrap: wrap;
+  justify-content: space-between;
+  align-items:  center;
+}
+
+.binding-header, .binding-v2-header {
+  border-bottom-width: var(--ds-screen-surface-border-width, 1px);
+  border-bottom-style: solid;
+  border-bottom-color: var(--ds-color-border, #e2e8f0);
+}
+
+.binding-body, .binding-v2-body {
+  overflow: auto;
+  position: relative;
+  padding: var(--ds-page-padding, 1rem 1.5rem);
+  flex: 1;
+  min-height: 0;
+}
+
+.binding-columns, .binding-v2-columns {
+  isolation: isolate;
+  display: flex;
+  gap: var(--ds-space-8, 2rem);
+  flex-wrap: wrap;
+  align-items:  start;
+}
+
+.binding-main, .binding-v2-main {
+  flex-grow: 1;
+  flex-basis: var(--ds-dialog-form-min-width, 32rem);
+  padding-bottom: var(--ds-space-12, 3rem);
+}
+
+.binding-main, .binding-stack, .binding-v2-main, .binding-v2-stack {
+  display: flex;
+  gap: var(--ds-space-4, 1rem);
+  flex-direction: column;
+  min-width: 0;
+}
+
+.binding-section, .binding-v2-section {
+  padding-bottom: var(--ds-space-6, 1.5rem);
+  display: flex;
+  gap: var(--ds-space-4, 1rem);
+  border-bottom-width: var(--ds-screen-surface-border-width, 1px);
+  border-bottom-style: solid;
+  border-bottom-color: var(--ds-color-border, #e2e8f0);
+  flex-direction: column;
+}
+
+.binding-section-title, .binding-v2-section-title {
+  display: flex;
+  justify-content: space-between;
+  align-items:  center;
+  gap: var(--ds-space-4, 1rem);
+}
+
+.binding-muted, .binding-v2-muted {
+  color: var(--ds-color-muted-foreground, #64748b);
+  font-size: var(--ds-font-size-sm, .8125rem);
+}
+
+.binding-preview, .binding-v2-preview {
+  flex-basis: var(--ds-dialog-min-width, 24rem);
+  position: sticky;
+  background: var(--ds-color-surface, #fff);
+  border-width: var(--ds-screen-surface-border-width, 1px);
+  border-style: solid;
+  border-color: var(--ds-color-border, #e2e8f0);
+  border-radius: var(--ds-radius-md, 6px);
+  padding: var(--ds-space-6, 1.5rem);
+  display: flex;
+  gap: var(--ds-space-4, 1rem);
+  flex-direction: column;
+  flex-grow: 0;
+  max-width: 100%;
+  top: 0;
+}
+
+.binding-panel, .binding-v2-panel {
+  position: absolute;
+  width: var(--ds-dialog-form-min-width, 32rem);
+  background: var(--ds-color-background, #fff);
+  border-left-width: var(--ds-screen-surface-border-width, 1px);
+  border-left-style: solid;
+  border-left-color: var(--ds-color-border, #e2e8f0);
+  box-shadow: var(--ds-shadow-md, 0 4px 6px -1px #0000001a);
+  padding: var(--ds-space-6, 1.5rem);
+  display: flex;
+  gap: var(--ds-space-6, 1.5rem);
+  z-index: var(--ds-focus-z-index, 50);
+  flex-direction: column;
+  max-width: 100%;
+  min-height: 100%;
+  top: 0;
+  right: 0;
+}
+
+.binding-details, .binding-v2-details {
+  display: flex;
+  gap: var(--ds-space-2, .5rem);
+  font-size: var(--ds-font-size-sm, .8125rem);
+  overflow-wrap: anywhere;
+  flex-direction: column;
+}
+
+.binding-details summary, .binding-v2-details summary {
+  cursor: pointer;
+  color: var(--ds-color-muted-foreground, #64748b);
+}
+
+.binding-footer, .binding-v2-footer {
+  border-top-width: var(--ds-screen-surface-border-width, 1px);
+  border-top-style: solid;
+  border-top-color: var(--ds-color-border, #e2e8f0);
+  background: var(--ds-color-background, #fff);
+}
+
+.binding-simulation, .binding-v2-simulation {
+  display: flex;
+  gap: var(--ds-space-4, 1rem);
+  flex-direction: column;
+}
+
+.binding-empty, .binding-v2-empty {
+  padding: var(--ds-space-12, 3rem);
+  margin: auto;
+}
+
+.binding-error, .binding-v2-error {
+  color: var(--ds-color-destructive, #ef4444);
+}
+
+.binding-stack-tight, .binding-v2-stack-tight {
+  display: flex;
+  align-items:  flex-start;
+  gap: var(--ds-space-1, .25rem);
+  flex-direction: column;
+}
+
+.binding-list, .binding-v2-list {
+  padding-left: var(--ds-space-4, 1rem);
+  margin: 0;
+}
+
+.binding-panel-wide, .binding-v2-panel-wide {
+  width: var(--ds-dialog-width-large, 48rem);
+  overflow: auto;
+}
+
+.binding-call, .binding-v2-call {
+  display: flex;
+  gap: var(--ds-space-3, .75rem);
+  padding: var(--ds-space-4, 1rem);
+  border-width: var(--ds-screen-surface-border-width, 1px);
+  border-style: solid;
+  border-color: var(--ds-color-border, #e2e8f0);
+  border-radius: var(--ds-radius-md, 6px);
+  flex-direction: column;
+  min-width: 0;
+}
+
+.binding-call-grid, .binding-v2-call-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(var(--ds-menu-min-width, 12rem), 1fr));
+  gap: var(--ds-space-3, .75rem);
+}
+
+.binding-params, .binding-v2-params {
+  display: flex;
+  gap: var(--ds-space-2, .5rem);
+  flex-direction: column;
+}
+
+.binding-param, .binding-v2-param {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: var(--ds-space-3, .75rem);
+  overflow-wrap: anywhere;
+  align-items:  start;
+}
+
+.binding-endpoint, .binding-v2-endpoint {
+  font-family: var(--ds-font-family-mono, monospace);
+  font-size: var(--ds-font-size-sm, .8125rem);
+  overflow-wrap: anywhere;
+}
+
+.binding-preview-parts, .binding-v2-preview-parts {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(var(--ds-menu-min-width, 12rem), 1fr));
+  gap: var(--ds-space-3, .75rem);
+}
+
+.binding-pre, .binding-v2-pre {
+  font-family: var(--ds-font-family-mono, monospace);
+  font-size: var(--ds-font-size-sm, .8125rem);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  margin: 0;
+}

package/dist/components/ApiBindingWorkspace.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import type { ApiBindingContext, WorkspaceComponents } from "../types";
+import "../styles/workspace.css";
+export interface ApiBindingWorkspaceProps {
+    pageKey: string;
+    initialContext?: ApiBindingContext;
+    components?: Partial<WorkspaceComponents>;
+}
+export declare function ApiBindingWorkspace({ pageKey, initialContext, components, }: ApiBindingWorkspaceProps): React.JSX.Element;
+export declare const ApiBindingStudio: typeof ApiBindingWorkspace;

package/dist/components/ApiMappings.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+import type { ApiBindingConfig, ApiBindingContext } from "../types";
+export declare const TIMING_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+export declare const FRESHNESS_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+/**
+ * The single canonical API-mapping editor. The global entry shows every call;
+ * a field or action entry passes `focus` and sees only calls targeting it or sending its value.
+ */
+export declare function ApiMappings({ config, context, focus, defaultTarget, onChange, }: {
+    config: ApiBindingConfig;
+    context: ApiBindingContext;
+    focus?: string;
+    defaultTarget?: string;
+    onChange: (updater: (old: ApiBindingConfig) => ApiBindingConfig) => void;
+}): React.JSX.Element;

package/dist/components/BindApiButton.d.ts

@@ -0,0 +1,41 @@
+import * as React from "react";
+import type { ApiDefinition, BindingGrid, BindingOption, MappingFile, SnapshotComponent, SnapshotContext, WindowKind, WindowTrigger } from "../types";
+export interface BindApiButtonProps {
+    appId?: string;
+    windowId: string;
+    /** Source window, screen, or action name, e.g. "Add Notes", "Create P2P", "Invoice Details" */
+    source: string;
+    /** Parent grid, panel, or screen name, e.g. "Worklist Grid", "Dashboard", "Main Screen" */
+    parent: string;
+    /** Optional Grid context (selected rows and columns) if triggered from or acting upon a grid */
+    grid?: BindingGrid;
+    /** Parent windows / screens context hierarchy */
+    parents?: SnapshotContext[];
+    /** UI presentation kind (modal, drawer, screen, form, etc.) */
+    kind?: WindowKind;
+    /** Action trigger info */
+    trigger?: WindowTrigger;
+    /** Captured dropdown/combobox options from the host form */
+    options?: Record<string, BindingOption[]>;
+    /** Registered API definitions catalog */
+    definitions?: ApiDefinition[];
+    /** Existing saved mapping file */
+    mappingFile?: MappingFile | null;
+    /** Base route for the Studio in the router (defaults to `/api-binding`) */
+    routeBase?: string;
+    /** Optional container ref to override automatic DOM discovery */
+    containerRef?: React.RefObject<HTMLElement | null>;
+    /** Optional container CSS selector to locate screen root */
+    containerSelector?: string;
+    /** Explicit root DOM element */
+    rootElement?: HTMLElement | null;
+    /** Optional HTML form id */
+    formId?: string;
+    /** Explicit components / fields override if not discovered via DOM */
+    components?: SnapshotComponent[];
+    /** Explicit action buttons override */
+    buttons?: string[];
+    className?: string;
+    children?: React.ReactNode;
+}
+export declare function BindApiButton({ appId, windowId, source, parent, grid, parents, kind, trigger, options, definitions, mappingFile, routeBase, containerRef, containerSelector, rootElement, formId, components: explicitComponents, buttons: explicitButtons, className, children, }: BindApiButtonProps): React.JSX.Element;

package/dist/components/RequestPreview.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import type { RequestPreviewItem } from "../types";
+/** Simulated requests in call order. Nothing here is sent over network. */
+export declare function RequestPreview({ title, requests }: {
+    title: string;
+    requests: RequestPreviewItem[];
+}): React.JSX.Element;

package/dist/components/SimulationDialog.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+import type { ApiBindingConfig, ApiBindingContext } from "../types";
+export declare function SimulationDialog({ config, context, onClose, onVerified, }: {
+    config: ApiBindingConfig;
+    context: ApiBindingContext;
+    onClose: () => void;
+    onVerified: (signature: string) => void;
+}): React.JSX.Element;

package/dist/components/WorkspaceContext.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import type { WorkspaceComponents } from "../types";
+export declare function WorkspaceComponentsProvider({ components, children, }: {
+    components?: Partial<WorkspaceComponents>;
+    children: React.ReactNode;
+}): React.JSX.Element;
+export declare function useWorkspaceComponents(): Required<WorkspaceComponents>;

package/dist/components/ui/AppGrid.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+export interface AppGridColDef<T = unknown> {
+    field?: keyof T | string;
+    headerName: string;
+    fill?: boolean;
+    type?: "number" | "badge" | "action";
+    badgeVariants?: Record<string, "success" | "warning" | "danger" | "neutral">;
+    labelField?: keyof T | string;
+    icon?: string;
+    onClick?: (row: T) => void;
+    render?: (row: T) => React.ReactNode;
+}
+export declare function createActionColumn<T>(spec: {
+    headerName: string;
+    labelField: keyof T | string;
+    icon?: string;
+    onClick: (row: T) => void;
+}): AppGridColDef<T>;
+export interface AppGridProps<T> {
+    rows: T[];
+    columns: AppGridColDef<T>[];
+    getRowKey?: (row: T, index: number) => string | number;
+    className?: string;
+    filtering?: boolean;
+    height?: string;
+}
+export declare function AppGrid<T extends Record<string, any>>({ rows, columns, getRowKey, className, }: AppGridProps<T>): React.JSX.Element;

package/dist/components/ui/Badge.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+export type BadgeVariant = "neutral" | "info" | "success" | "warning" | "danger" | "brand";
+export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    variant?: BadgeVariant;
+    children: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function Badge({ variant, children, className, style, ...rest }: BadgeProps): React.JSX.Element;

package/dist/components/ui/Banner.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+export type BannerTone = "caution" | "resolved" | "danger";
+export interface BannerProps {
+    tone?: BannerTone;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function Banner({ tone, children, className }: BannerProps): React.JSX.Element;

package/dist/components/ui/Button.d.ts

@@ -0,0 +1,31 @@
+import * as React from "react";
+import { type ActionIcon } from "./Icons";
+export type ButtonVariant = "primary" | "secondary" | "ghost" | "destructive" | "outline";
+export type ButtonSize = "sm" | "md";
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    icon?: ActionIcon;
+    tooltip?: string | false;
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function Button({ variant, size, icon, tooltip, children, className, type, ...rest }: ButtonProps): React.JSX.Element;
+export interface ButtonBarProps {
+    justify?: "between" | "start" | "end";
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function ButtonBar({ justify, children, className }: ButtonBarProps): React.JSX.Element;
+export interface ButtonGroupOption<T extends string> {
+    value: T;
+    label: string;
+}
+export interface ButtonGroupProps<T extends string> {
+    value: T;
+    onChange: (value: T) => void;
+    options: ButtonGroupOption<T>[];
+    "aria-label"?: string;
+    className?: string;
+}
+export declare function ButtonGroup<T extends string>({ value, onChange, options, "aria-label": ariaLabel, className, }: ButtonGroupProps<T>): React.JSX.Element;

package/dist/components/ui/Card.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+export interface DetailCardField {
+    label: string;
+    value?: React.ReactNode;
+}
+export interface DetailCardProps {
+    title?: string;
+    subtitle?: string;
+    actions?: React.ReactNode;
+    fields?: DetailCardField[];
+    dense?: boolean;
+    className?: string;
+}
+export declare function DetailCard({ title, subtitle, actions, fields, dense, className, }: DetailCardProps): React.JSX.Element;

package/dist/components/ui/Dialog.d.ts

@@ -0,0 +1,61 @@
+import * as React from "react";
+export interface DialogProps {
+    open?: boolean;
+    title: string;
+    description?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    onCancel?: () => void;
+    onSubmit?: () => void;
+    children: React.ReactNode;
+    size?: "large" | "medium";
+    formId?: string;
+    className?: string;
+}
+export declare function Dialog({ open, title, description, submitLabel, cancelLabel, onCancel, onSubmit, children, size, formId, className, }: DialogProps): React.JSX.Element | null;
+export declare function actionFormDialogTemplateV1(spec: {
+    open: boolean;
+    title: string;
+    description: string;
+    size?: "large" | "medium";
+    formId: string;
+    submitLabel: string;
+    cancelLabel: string;
+    onCancel: () => void;
+    onSubmit: () => void;
+    children: React.ReactNode;
+}): {
+    open: boolean;
+    title: string;
+    description: string;
+    size?: "large" | "medium";
+    formId: string;
+    submitLabel: string;
+    cancelLabel: string;
+    onCancel: () => void;
+    onSubmit: () => void;
+    children: React.ReactNode;
+};
+export declare function alertDialogTemplateV1(spec: {
+    open: boolean;
+    kind?: "destructive" | "neutral" | string;
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    primaryAction?: {
+        label: string;
+        onClick: () => void;
+    };
+    onConfirm?: () => void;
+    onCancel: () => void;
+}): {
+    open: boolean;
+    title: string;
+    description: string;
+    submitLabel: string;
+    cancelLabel: string;
+    onSubmit: (() => void) | undefined;
+    onCancel: () => void;
+    children: null;
+};

package/dist/components/ui/Icons.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+export interface IconProps extends React.SVGProps<SVGSVGElement> {
+    size?: number | string;
+    className?: string;
+}
+export declare const LinkIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const PencilIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const SettingsIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const PlusIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const Trash2Icon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ArrowUpIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ArrowDownIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const PlayIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CheckIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const XIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const SearchIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const AlertTriangleIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const AlertCircleIcon: React.ForwardRefExoticComponent<Omit<IconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const iconMap: Record<string, React.ComponentType<IconProps>>;
+export type ActionIcon = string | React.ReactNode;
+export declare function renderIcon(icon?: ActionIcon, props?: IconProps): React.ReactNode;

package/dist/components/ui/Input.d.ts

@@ -0,0 +1,31 @@
+import * as React from "react";
+export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    label?: string;
+    required?: boolean;
+}
+export declare function Input({ label, required, className, id, ...rest }: InputProps): React.JSX.Element;
+export interface TextAreaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    label?: string;
+    required?: boolean;
+}
+export declare function TextArea({ label, required, className, id, ...rest }: TextAreaProps): React.JSX.Element;
+export interface SelectOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface SelectProps extends Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "onChange" | "value"> {
+    label?: string;
+    required?: boolean;
+    value?: string | null;
+    options?: SelectOption[];
+    onChange?: (value: string | null) => void;
+    placeholder?: string;
+}
+export declare function Select({ label, required, value, options, onChange, placeholder, disabled, className, id, ...rest }: SelectProps): React.JSX.Element;
+export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "onChange"> {
+    label: string;
+    checked?: boolean;
+    onChange?: (checked: boolean) => void;
+}
+export declare function Checkbox({ label, checked, onChange, disabled, className, id, ...rest }: CheckboxProps): React.JSX.Element;

package/dist/core/bindingContext.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Snapshot extraction, DOM inspection, and context building utilities.
+ * Completely generic: works on modals, drawers, panels, cards, and full screens.
+ */
+import type { BindingGrid, BindingSnapshot, SnapshotComponent, SnapshotContext, WindowKind, WindowTrigger } from "../types";
+export declare const FREE_TEXT_SOURCE = "freeText";
+export declare const FREE_TEXT_OPTION: {
+    value: string;
+    label: string;
+};
+export declare function storageKey(key: string): string;
+export declare function storeSnapshot(snapshot: BindingSnapshot): void;
+export declare function readSnapshot(key: string): BindingSnapshot | null;
+export declare function windowIds({ appId, windowId, gridId, parentWindowIds, }: {
+    appId: string;
+    windowId: string;
+    gridId?: string;
+    parentWindowIds?: string[];
+}): {
+    appId: string;
+    windowId: string;
+    gridId: string | undefined;
+    parentWindowIds: string[] | undefined;
+    key: string;
+};
+export declare function gridPropertyPaths({ gridId, rows }: {
+    gridId: string;
+    rows: Record<string, unknown>[];
+}): string[];
+export declare function contextComponents(snapshot: BindingSnapshot): Array<{
+    value: string;
+    label: string;
+}>;
+export declare function sourceComponents(snapshot: BindingSnapshot): Array<{
+    value: string;
+    label: string;
+}>;
+/**
+ * Intelligently locates the nearest enclosing screen, modal, drawer, form, or panel container
+ * where the trigger button resides.
+ */
+export declare function findEnclosingContextElement(triggerElement: HTMLElement | null, options?: {
+    containerRef?: React.RefObject<HTMLElement | null>;
+    containerSelector?: string;
+    rootElement?: HTMLElement | null;
+    formId?: string;
+}): HTMLElement | null;
+export declare function discoverFormComponents(root: HTMLElement | null): SnapshotComponent[];
+export declare function discoverButtons(root: HTMLElement | null): string[];
+export declare function buildSnapshot({ ids, source, parent, root, grid, kind, trigger, contexts, components: explicitComponents, buttons: explicitButtons, }: {
+    ids: {
+        appId: string;
+        windowId: string;
+        gridId?: string;
+        parentWindowIds?: string[];
+        key: string;
+    };
+    source: string;
+    parent: string;
+    root: HTMLElement | null;
+    grid?: BindingGrid;
+    kind?: WindowKind;
+    trigger?: WindowTrigger;
+    contexts?: SnapshotContext[];
+    components?: SnapshotComponent[];
+    buttons?: string[];
+}): BindingSnapshot;

package/dist/core/catalog.d.ts

@@ -0,0 +1,18 @@
+/**
+ * API Catalog builder and validator for API Binding Studio.
+ */
+import type { ApiDefinition, ApiParameter } from "../types";
+export declare function friendlyLabel(operationId?: string): string | undefined;
+export type RawBindings = Record<string, Record<string, {
+    operationId?: string;
+    [key: string]: unknown;
+}>>;
+export declare function buildCatalogFromRegistry({ bindings, hookResolver, paramsResolver, availabilityChecker, }: {
+    bindings: RawBindings;
+    hookResolver?: (api: string, method: string) => string | undefined;
+    paramsResolver?: (api: string, method: string) => ApiParameter[];
+    availabilityChecker?: (api: string, method: string) => {
+        available: boolean;
+        problem?: string;
+    };
+}): ApiDefinition[];

package/dist/core/componentId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Component ID utilities for normalized component identification.
+ */
+export interface ComponentDescriptor {
+    kind: "field" | "button" | string;
+    name: string;
+    parentId?: string;
+}
+export declare function componentId(c: ComponentDescriptor): string;
+export declare function isButtonId(id: string): boolean;
+export declare function parseComponentId(id: string): ComponentDescriptor;
+export declare function normalizeComponent(id: string): string;