@tightknitai/block-kitchen 0.9.8 → 0.9.10

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { B as BlockKitchenProps, $ as Template, K as PreviewSurface, N as PreviewTheme } from './palette-CKP8CK5Z.cjs';
-export { A as AlertBlock, a as AlertLevel, b as BrandPreset, c as BrandTheme, d as BrandTokens, e as BuilderBlock, C as CardBlock, f as CarouselBlock, g as CartesianChart, h as ChannelOption, i as Chart, j as ChartAxisConfig, k as ChartDataPoint, l as ChartSeries, m as ChartType, n as ContainerBlock, o as ContainerChildBlock, p as ContextActionsBlock, q as ContextActionsElement, r as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, s as EditingConfig, F as FeedbackButtonSubobject, t as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, u as IconButtonIcon, v as InputBlock, L as LoadMessageInput, w as LoadResult, M as MarkdownBlock, P as PaletteSection, x as PaletteVariant, y as PieChart, z as PieChartSegment, G as PlanBlock, J as PreviewHooks, R as RecentMessage, S as SendAsUserStatus, O as SendPayload, Q as SendResult, T as SupportedBlock, U as SupportedBlockType, V as SupportedHeaderBlock, W as TableBlock, X as TableCell, Y as TableColumnSetting, Z as TaskCardBlock, _ as TaskCardStatus, a0 as UpdatePayload, a1 as UpdateResult, a2 as UrlSourceElement, a3 as VideoBlock, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.cjs';
+import { ReactNode } from 'react';
+import { c as BlockKitchenProps, Z as SupportedBlock, k as ChannelOption, V as SendAsUserStatus, X as SendPayload, W as SendExtrasContext, a5 as Template, Q as PreviewSurface, R as PreviewTheme } from './palette-Duj901T6.cjs';
+export { A as AlertBlock, a as AlertLevel, B as BlockKitchenBaseProps, b as BlockKitchenComposeOnlyProps, d as BlockKitchenSendProps, e as BrandPreset, f as BrandTheme, g as BrandTokens, h as BuilderBlock, C as CardBlock, i as CarouselBlock, j as CartesianChart, l as Chart, m as ChartAxisConfig, n as ChartDataPoint, o as ChartSeries, p as ChartType, q as ContainerBlock, r as ContainerChildBlock, s as ContextActionsBlock, t as ContextActionsElement, u as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, v as EditingConfig, F as FeedbackButtonSubobject, w as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, x as IconButtonIcon, y as InputBlock, L as LoadMessageInput, z as LoadResult, M as MarkdownBlock, P as PaletteSection, G as PaletteVariant, J as PieChart, K as PieChartSegment, N as PlanBlock, O as PreviewHooks, S as PrimaryActionConfig, T as PrimaryActionContext, U as RecentMessage, Y as SendResult, _ as SupportedBlockType, $ as SupportedHeaderBlock, a0 as TableBlock, a1 as TableCell, a2 as TableColumnSetting, a3 as TaskCardBlock, a4 as TaskCardStatus, a6 as UpdatePayload, a7 as UpdateResult, a8 as UrlSourceElement, a9 as ValidationSummary, aa as VideoBlock, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.cjs';
 export { decodeBlocksFromString, encodeBlocksToString, toSlackBlocks } from './helpers.cjs';
 import 'slack-web-api-client';
 
@@ -14,6 +15,85 @@ import 'slack-web-api-client';
  */
 declare function BlockKitchen(props: BlockKitchenProps): react.JSX.Element;
 
+/**
+ * Props for {@link SendDialog}. Exported so hosts building a bespoke send
+ * flow (compose-only mode) can reuse the built-in dialog standalone instead
+ * of rebuilding channel loading, identity, and sending states from scratch.
+ */
+interface SendDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Notified when the user closes the dialog. */
+    onOpenChange: (open: boolean) => void;
+    /** The draft blocks to send (builder-native format). */
+    blocks: SupportedBlock[];
+    /** Returns channels available to send to. Called when the dialog opens. */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /** Returns user-token status + OAuth URL. */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /** Terminal action; should return `{ ok }` or `{ ok: false, error }`. */
+    onSend: (payload: SendPayload) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Renders host-defined fields below the built-in pickers; collected
+     * values are delivered on {@link SendPayload.extras}.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /** Label for the final confirm button. Defaults to `'Send'`. */
+    confirmSendLabel?: string;
+    /** Total validation errors against the current draft. */
+    errorCount: number;
+    /** Asks the parent to open the global issues panel. */
+    onShowIssues?: () => void;
+}
+/**
+ * Modal dialog that collects the destination channel + send-as identity
+ * (plus any host-defined extras), then calls the consumer's `onSend`.
+ *
+ * Channels and user-token status are loaded async via callback props on open.
+ * The consumer brokers all I/O; the dialog never makes a network call.
+ * @param props - {@link SendDialogProps}
+ * @returns the rendered send dialog
+ */
+declare function SendDialog({ open, onOpenChange, blocks, loadChannels, loadSendAsUserStatus, onSend, renderSendExtras, confirmSendLabel, errorCount, onShowIssues }: SendDialogProps): react.JSX.Element;
+
+/**
+ * Tracks the "act as the user" Slack token status for a dialog and drives the
+ * OAuth sign-in flow. Shared by {@link SendDialog} and {@link UpdateDialog}.
+ *
+ * While `open && enabled` it fetches status on open and refreshes on window
+ * focus. Once `startSignIn` opens the OAuth tab it also background-polls until
+ * the token appears or the retry cap is hit, so the dialog unlocks itself
+ * without a manual reload. All work stops when the dialog closes, the token
+ * path doesn't apply, or the component unmounts.
+ *
+ * @param loadStatus - consumer callback returning user-token status + OAuth URL
+ * @param options.open - whether the host dialog is open
+ * @param options.enabled - whether the user-token path applies (idle when false)
+ * @returns `{ userStatus, polling, startSignIn }`
+ */
+declare function useSlackSignIn(loadStatus: () => Promise<SendAsUserStatus>, { open, enabled }: {
+    open: boolean;
+    enabled: boolean;
+}): {
+    userStatus: SendAsUserStatus | null;
+    polling: boolean;
+    startSignIn: () => void;
+};
+/**
+ * The "Sign in with Slack" button used by both dialogs. Opens OAuth and shows a
+ * spinner while {@link useSlackSignIn} polls for the completed round-trip. The
+ * surrounding explanatory copy stays with each caller since it differs.
+ * @param props.onClick - starts the sign-in flow (typically `startSignIn`)
+ * @param props.polling - whether a background poll is in flight
+ */
+declare function SlackSignInButton({ onClick, polling }: {
+    onClick: () => void;
+    polling: boolean;
+}): react.JSX.Element;
+
 /**
  * Standalone, page-sized picker that displays {@link Template}s as a
  * grid of cards with live block previews, organized into category
@@ -51,4 +131,4 @@ declare function TemplatePicker({ templates, onSelect, surface, theme, heading,
     className?: string;
 }): react.JSX.Element;
 
-export { BlockKitchen, BlockKitchenProps, PreviewSurface, PreviewTheme, Template, TemplatePicker };
+export { BlockKitchen, BlockKitchenProps, ChannelOption, PreviewSurface, PreviewTheme, SendAsUserStatus, SendDialog, type SendDialogProps, SendExtrasContext, SendPayload, SlackSignInButton, SupportedBlock, Template, TemplatePicker, useSlackSignIn };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { B as BlockKitchenProps, $ as Template, K as PreviewSurface, N as PreviewTheme } from './palette-CKP8CK5Z.js';
-export { A as AlertBlock, a as AlertLevel, b as BrandPreset, c as BrandTheme, d as BrandTokens, e as BuilderBlock, C as CardBlock, f as CarouselBlock, g as CartesianChart, h as ChannelOption, i as Chart, j as ChartAxisConfig, k as ChartDataPoint, l as ChartSeries, m as ChartType, n as ContainerBlock, o as ContainerChildBlock, p as ContextActionsBlock, q as ContextActionsElement, r as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, s as EditingConfig, F as FeedbackButtonSubobject, t as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, u as IconButtonIcon, v as InputBlock, L as LoadMessageInput, w as LoadResult, M as MarkdownBlock, P as PaletteSection, x as PaletteVariant, y as PieChart, z as PieChartSegment, G as PlanBlock, J as PreviewHooks, R as RecentMessage, S as SendAsUserStatus, O as SendPayload, Q as SendResult, T as SupportedBlock, U as SupportedBlockType, V as SupportedHeaderBlock, W as TableBlock, X as TableCell, Y as TableColumnSetting, Z as TaskCardBlock, _ as TaskCardStatus, a0 as UpdatePayload, a1 as UpdateResult, a2 as UrlSourceElement, a3 as VideoBlock, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.js';
+import { ReactNode } from 'react';
+import { c as BlockKitchenProps, Z as SupportedBlock, k as ChannelOption, V as SendAsUserStatus, X as SendPayload, W as SendExtrasContext, a5 as Template, Q as PreviewSurface, R as PreviewTheme } from './palette-Duj901T6.js';
+export { A as AlertBlock, a as AlertLevel, B as BlockKitchenBaseProps, b as BlockKitchenComposeOnlyProps, d as BlockKitchenSendProps, e as BrandPreset, f as BrandTheme, g as BrandTokens, h as BuilderBlock, C as CardBlock, i as CarouselBlock, j as CartesianChart, l as Chart, m as ChartAxisConfig, n as ChartDataPoint, o as ChartSeries, p as ChartType, q as ContainerBlock, r as ContainerChildBlock, s as ContextActionsBlock, t as ContextActionsElement, u as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, v as EditingConfig, F as FeedbackButtonSubobject, w as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, x as IconButtonIcon, y as InputBlock, L as LoadMessageInput, z as LoadResult, M as MarkdownBlock, P as PaletteSection, G as PaletteVariant, J as PieChart, K as PieChartSegment, N as PlanBlock, O as PreviewHooks, S as PrimaryActionConfig, T as PrimaryActionContext, U as RecentMessage, Y as SendResult, _ as SupportedBlockType, $ as SupportedHeaderBlock, a0 as TableBlock, a1 as TableCell, a2 as TableColumnSetting, a3 as TaskCardBlock, a4 as TaskCardStatus, a6 as UpdatePayload, a7 as UpdateResult, a8 as UrlSourceElement, a9 as ValidationSummary, aa as VideoBlock, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.js';
 export { decodeBlocksFromString, encodeBlocksToString, toSlackBlocks } from './helpers.js';
 import 'slack-web-api-client';
 
@@ -14,6 +15,85 @@ import 'slack-web-api-client';
  */
 declare function BlockKitchen(props: BlockKitchenProps): react.JSX.Element;
 
+/**
+ * Props for {@link SendDialog}. Exported so hosts building a bespoke send
+ * flow (compose-only mode) can reuse the built-in dialog standalone instead
+ * of rebuilding channel loading, identity, and sending states from scratch.
+ */
+interface SendDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Notified when the user closes the dialog. */
+    onOpenChange: (open: boolean) => void;
+    /** The draft blocks to send (builder-native format). */
+    blocks: SupportedBlock[];
+    /** Returns channels available to send to. Called when the dialog opens. */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /** Returns user-token status + OAuth URL. */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /** Terminal action; should return `{ ok }` or `{ ok: false, error }`. */
+    onSend: (payload: SendPayload) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Renders host-defined fields below the built-in pickers; collected
+     * values are delivered on {@link SendPayload.extras}.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /** Label for the final confirm button. Defaults to `'Send'`. */
+    confirmSendLabel?: string;
+    /** Total validation errors against the current draft. */
+    errorCount: number;
+    /** Asks the parent to open the global issues panel. */
+    onShowIssues?: () => void;
+}
+/**
+ * Modal dialog that collects the destination channel + send-as identity
+ * (plus any host-defined extras), then calls the consumer's `onSend`.
+ *
+ * Channels and user-token status are loaded async via callback props on open.
+ * The consumer brokers all I/O; the dialog never makes a network call.
+ * @param props - {@link SendDialogProps}
+ * @returns the rendered send dialog
+ */
+declare function SendDialog({ open, onOpenChange, blocks, loadChannels, loadSendAsUserStatus, onSend, renderSendExtras, confirmSendLabel, errorCount, onShowIssues }: SendDialogProps): react.JSX.Element;
+
+/**
+ * Tracks the "act as the user" Slack token status for a dialog and drives the
+ * OAuth sign-in flow. Shared by {@link SendDialog} and {@link UpdateDialog}.
+ *
+ * While `open && enabled` it fetches status on open and refreshes on window
+ * focus. Once `startSignIn` opens the OAuth tab it also background-polls until
+ * the token appears or the retry cap is hit, so the dialog unlocks itself
+ * without a manual reload. All work stops when the dialog closes, the token
+ * path doesn't apply, or the component unmounts.
+ *
+ * @param loadStatus - consumer callback returning user-token status + OAuth URL
+ * @param options.open - whether the host dialog is open
+ * @param options.enabled - whether the user-token path applies (idle when false)
+ * @returns `{ userStatus, polling, startSignIn }`
+ */
+declare function useSlackSignIn(loadStatus: () => Promise<SendAsUserStatus>, { open, enabled }: {
+    open: boolean;
+    enabled: boolean;
+}): {
+    userStatus: SendAsUserStatus | null;
+    polling: boolean;
+    startSignIn: () => void;
+};
+/**
+ * The "Sign in with Slack" button used by both dialogs. Opens OAuth and shows a
+ * spinner while {@link useSlackSignIn} polls for the completed round-trip. The
+ * surrounding explanatory copy stays with each caller since it differs.
+ * @param props.onClick - starts the sign-in flow (typically `startSignIn`)
+ * @param props.polling - whether a background poll is in flight
+ */
+declare function SlackSignInButton({ onClick, polling }: {
+    onClick: () => void;
+    polling: boolean;
+}): react.JSX.Element;
+
 /**
  * Standalone, page-sized picker that displays {@link Template}s as a
  * grid of cards with live block previews, organized into category
@@ -51,4 +131,4 @@ declare function TemplatePicker({ templates, onSelect, surface, theme, heading,
     className?: string;
 }): react.JSX.Element;
 
-export { BlockKitchen, BlockKitchenProps, PreviewSurface, PreviewTheme, Template, TemplatePicker };
+export { BlockKitchen, BlockKitchenProps, ChannelOption, PreviewSurface, PreviewTheme, SendAsUserStatus, SendDialog, type SendDialogProps, SendExtrasContext, SendPayload, SlackSignInButton, SupportedBlock, Template, TemplatePicker, useSlackSignIn };