slack.ts 0.0.11 → 0.0.12

package/dist/{src/blocks → blocks}/elements/plain_text_input.js

@@ -1,5 +1,12 @@
 import { ensureIsTextObjectBuilder } from "../objects/text.js";
 import { BlockElementBuilder } from "./base.js";
+/**
+ * Builder for plain text input elements.
+ *
+ * Plain text input elements collect text input from users in modals and home tabs.
+ *
+ * @template ActionID The action ID type used to identify this input
+ */
 export class PlainTextInputBuilder extends BlockElementBuilder {
     _multiline = false;
     _default;
@@ -11,30 +18,72 @@ export class PlainTextInputBuilder extends BlockElementBuilder {
     id(actionId) {
         return this._id(actionId);
     }
+    /**
+     * Sets whether the input accepts multiple lines.
+     *
+     * @param multiline Whether to enable multiline input
+     * @returns This builder
+     */
     multiline(multiline = true) {
         this._multiline = multiline;
         return this;
     }
+    /**
+     * Sets the default value for this input.
+     *
+     * @param value The default value
+     * @returns This builder
+     */
     default(value) {
         this._default = value;
         return this;
     }
+    /**
+     * Sets whether this input should receive focus on load.
+     *
+     * @param autofocus Whether to autofocus
+     * @returns This builder
+     */
     autofocus(autofocus = true) {
         this._autofocus = autofocus;
         return this;
     }
+    /**
+     * Sets the placeholder text for this input.
+     *
+     * @param placeholder The placeholder text
+     * @returns This builder
+     */
     placeholder(placeholder) {
         this._placeholder = ensureIsTextObjectBuilder(placeholder).plain();
         return this;
     }
+    /**
+     * Sets the minimum length for input validation.
+     *
+     * @param minLength The minimum length
+     * @returns This builder
+     */
     min(minLength) {
         this._minLength = minLength;
         return this;
     }
+    /**
+     * Sets the maximum length for input validation.
+     *
+     * @param maxLength The maximum length
+     * @returns This builder
+     */
     max(maxLength) {
         this._maxLength = maxLength;
         return this;
     }
+    /**
+     * Sets dispatch actions to trigger on specific events.
+     *
+     * @param triggers The events that should trigger actions
+     * @returns This builder
+     */
     triggers(...triggers) {
         this._triggers = triggers;
         return this;
@@ -53,6 +102,11 @@ export class PlainTextInputBuilder extends BlockElementBuilder {
         };
     }
 }
+/**
+ * Creates a plain text input element builder.
+ *
+ * @returns A plain text input element builder
+ */
 export function plainTextInput() {
     return new PlainTextInputBuilder();
 }

package/dist/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/dist/{src/blocks → blocks}/input.d.ts

@@ -8,14 +8,35 @@ type TypedInputBlock<Element extends InputElementBuilder, BlockID extends string
     block_id: BlockID;
     element: Element extends BlockElementBuilder<infer Output> ? Output : never;
 };
+/**
+ * Builder for input blocks.
+ *
+ * Input blocks contain interactive elements for collecting user input.
+ *
+ * @template Element The input element type
+ * @template HasLabel Whether a label has been set
+ * @template BlockID The block ID type
+ */
 export declare class InputBlockBuilder<Element extends InputElementBuilder, HasLabel extends boolean = false, BlockID extends string = string> extends BlockBuilder<TypedInputBlock<Element, BlockID>, BlockID, HasLabel> {
     private _element;
     private _label?;
     constructor(_element: Element);
     id<BlockID extends string>(blockId: BlockID): InputBlockBuilder<Element, HasLabel, BlockID>;
+    /**
+     * Sets the label for this input block.
+     *
+     * @param text The label text
+     * @returns This builder with the label set
+     */
     label(text: string | TextObjectBuilder<false>): InputBlockBuilder<Element, true, BlockID>;
     build(this: InputBlockBuilder<Element, true, BlockID>): TypedInputBlock<Element, BlockID>;
 }
+/**
+ * Creates an input block builder.
+ *
+ * @param element The input element (typically a plain text input)
+ * @returns An input block builder
+ */
 export declare function input<Element extends InputElementBuilder>(element: Element): InputBlockBuilder<Element, false, string>;
 export {};
 //# sourceMappingURL=input.d.ts.map

package/dist/blocks/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/blocks/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElF,KAAK,mBAAmB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;AAExD,KAAK,eAAe,CAAC,OAAO,SAAS,mBAAmB,EAAE,OAAO,SAAS,MAAM,IAAI,UAAU,GAAG;IAChG,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,SAAS,mBAAmB,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;CAC3E,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB,CAC7B,OAAO,SAAS,mBAAmB,EACnC,QAAQ,SAAS,OAAO,GAAG,KAAK,EAChC,OAAO,SAAS,MAAM,GAAG,MAAM,CAC9B,SAAQ,YAAY,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC;IAG/D,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,MAAM,CAAC,CAA0B;gBAErB,QAAQ,EAAE,OAAO;IAI5B,EAAE,CAAC,OAAO,SAAS,MAAM,EACjC,OAAO,EAAE,OAAO,GACd,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IAIhD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;IAKhF,KAAK,CACb,IAAI,EAAE,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAC7C,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC;CAUpC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,SAAS,mBAAmB,EAAE,OAAO,EAAE,OAAO,6CAE1E"}

package/dist/{src/blocks → blocks}/input.js

@@ -1,6 +1,15 @@
 import { SlackError } from "../error.js";
 import { BlockBuilder } from "./base.js";
 import { ensureIsTextObjectBuilder } from "./objects/text.js";
+/**
+ * Builder for input blocks.
+ *
+ * Input blocks contain interactive elements for collecting user input.
+ *
+ * @template Element The input element type
+ * @template HasLabel Whether a label has been set
+ * @template BlockID The block ID type
+ */
 export class InputBlockBuilder extends BlockBuilder {
     _element;
     _label;
@@ -11,6 +20,12 @@ export class InputBlockBuilder extends BlockBuilder {
     id(blockId) {
         return this._id(blockId);
     }
+    /**
+     * Sets the label for this input block.
+     *
+     * @param text The label text
+     * @returns This builder with the label set
+     */
     label(text) {
         this._label = ensureIsTextObjectBuilder(text).plain();
         return this;
@@ -26,6 +41,12 @@ export class InputBlockBuilder extends BlockBuilder {
         };
     }
 }
+/**
+ * Creates an input block builder.
+ *
+ * @param element The input element (typically a plain text input)
+ * @returns An input block builder
+ */
 export function input(element) {
     return new InputBlockBuilder(element);
 }

package/dist/{src/blocks → blocks}/objects/confirm.d.ts

@@ -1,6 +1,17 @@
 import type { ColorScheme, ConfirmationDialog } from "@slack/types";
 import { Builder } from "../base.js";
 import { type TextObjectBuilder } from "./text.js";
+/**
+ * Builder for confirmation dialogs.
+ *
+ * Confirmation dialogs are displayed when users interact with interactive elements and require
+ * confirmation before the action is executed.
+ *
+ * @template HasTitle Whether a title has been set
+ * @template HasText Whether text has been set
+ * @template HasConfirm Whether the confirm button text has been set
+ * @template HasDeny Whether the deny button text has been set
+ */
 export declare class ConfirmBuilder<HasTitle extends boolean = false, HasText extends boolean = false, HasConfirm extends boolean = false, HasDeny extends boolean = false> extends Builder<ConfirmationDialog> {
     private _title?;
     private _text?;
@@ -9,13 +20,52 @@ export declare class ConfirmBuilder<HasTitle extends boolean = false, HasText ex
     private _style?;
     private _brand?;
     constructor(_title?: TextObjectBuilder<false> | undefined, _text?: TextObjectBuilder | undefined, _confirm?: TextObjectBuilder<false> | undefined, _deny?: TextObjectBuilder<false> | undefined, _style?: ColorScheme | undefined);
+    /**
+     * Sets the title for this confirmation dialog.
+     *
+     * @param title The dialog title
+     * @returns This builder with the title set
+     */
     title(title: string | TextObjectBuilder<false>): ConfirmBuilder<true, HasText, HasConfirm, HasDeny>;
+    /**
+     * Sets the text for this confirmation dialog.
+     *
+     * @param text The dialog text
+     * @returns This builder with the text set
+     */
     text(text: string | TextObjectBuilder): ConfirmBuilder<HasTitle, true, HasConfirm, HasDeny>;
+    /**
+     * Sets the text for the confirm button.
+     *
+     * @param confirm The confirm button text
+     * @returns This builder with the confirm button text set
+     */
     confirm(confirm: string | TextObjectBuilder<false>): ConfirmBuilder<HasTitle, HasText, true, HasDeny>;
+    /**
+     * Sets the text for the deny button.
+     *
+     * @param deny The deny button text
+     * @returns This builder with the deny button text set
+     */
     deny(deny: string | TextObjectBuilder<false>): ConfirmBuilder<HasTitle, HasText, HasConfirm, true>;
+    /**
+     * Sets the style for the confirm button.
+     *
+     * @param style The button style ('primary' or 'danger')
+     * @returns This builder
+     */
     style(style: ColorScheme): this;
     build(this: ConfirmBuilder<true, true, true, true>): ConfirmationDialog;
 }
+/**
+ * Creates a confirmation dialog builder.
+ *
+ * Accepts partial field configuration. The `title`, `text`, `confirm`, and `deny` fields must be
+ * set before calling `build()`.
+ *
+ * @param fields Optional initial configuration fields
+ * @returns A confirmation dialog builder
+ */
 export declare function confirm<Fields extends {
     title?: string | TextObjectBuilder<false>;
     text?: string | TextObjectBuilder;

package/dist/blocks/objects/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../src/blocks/objects/confirm.ts"],"names":[],"mappings":"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"}

package/dist/{src/blocks → blocks}/objects/confirm.js

@@ -1,6 +1,17 @@
 import { Builder } from "../base.js";
 import { ensureIsTextObjectBuilder } from "./text.js";
 import { SlackError } from "../../error.js";
+/**
+ * Builder for confirmation dialogs.
+ *
+ * Confirmation dialogs are displayed when users interact with interactive elements and require
+ * confirmation before the action is executed.
+ *
+ * @template HasTitle Whether a title has been set
+ * @template HasText Whether text has been set
+ * @template HasConfirm Whether the confirm button text has been set
+ * @template HasDeny Whether the deny button text has been set
+ */
 export class ConfirmBuilder extends Builder {
     _title;
     _text;
@@ -16,22 +27,52 @@ export class ConfirmBuilder extends Builder {
         this._deny = _deny;
         this._style = _style;
     }
+    /**
+     * Sets the title for this confirmation dialog.
+     *
+     * @param title The dialog title
+     * @returns This builder with the title set
+     */
     title(title) {
         this._title = ensureIsTextObjectBuilder(title).plain();
         return this;
     }
+    /**
+     * Sets the text for this confirmation dialog.
+     *
+     * @param text The dialog text
+     * @returns This builder with the text set
+     */
     text(text) {
         this._text = ensureIsTextObjectBuilder(text);
         return this;
     }
+    /**
+     * Sets the text for the confirm button.
+     *
+     * @param confirm The confirm button text
+     * @returns This builder with the confirm button text set
+     */
     confirm(confirm) {
         this._confirm = ensureIsTextObjectBuilder(confirm).plain();
         return this;
     }
+    /**
+     * Sets the text for the deny button.
+     *
+     * @param deny The deny button text
+     * @returns This builder with the deny button text set
+     */
     deny(deny) {
         this._deny = ensureIsTextObjectBuilder(deny).plain();
         return this;
     }
+    /**
+     * Sets the style for the confirm button.
+     *
+     * @param style The button style ('primary' or 'danger')
+     * @returns This builder
+     */
     style(style) {
         this._style = style;
         return this;
@@ -49,6 +90,15 @@ export class ConfirmBuilder extends Builder {
         };
     }
 }
+/**
+ * Creates a confirmation dialog builder.
+ *
+ * Accepts partial field configuration. The `title`, `text`, `confirm`, and `deny` fields must be
+ * set before calling `build()`.
+ *
+ * @param fields Optional initial configuration fields
+ * @returns A confirmation dialog builder
+ */
 export function confirm(fields) {
     return new ConfirmBuilder(ensureIsTextObjectBuilder(fields?.title)?.plain(), ensureIsTextObjectBuilder(fields?.text), ensureIsTextObjectBuilder(fields?.confirm)?.plain(), ensureIsTextObjectBuilder(fields?.deny)?.plain(), fields?.style);
 }

package/dist/blocks/objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}

package/dist/{src/blocks → blocks}/objects/option.d.ts

@@ -4,14 +4,40 @@ import { type TextObjectBuilder } from "./text.js";
 type TypedPlainTextOption<Value extends string | undefined> = PlainTextOption & {
     value: Value;
 };
+/**
+ * Builder for option objects.
+ *
+ * Option objects are used in select menus to define the available choices.
+ *
+ * @template Value The option value type
+ */
 export declare class OptionObjectBuilder<Value extends string | undefined = string | undefined> extends Builder<TypedPlainTextOption<Value>> {
     private _text;
     private _value;
     constructor(_text: TextObjectBuilder<false>, _value: Value);
+    /**
+     * Sets the value for this option.
+     *
+     * @param value The option value
+     * @returns This builder with the value set
+     */
     value<Value extends string>(value: Value): OptionObjectBuilder<Value>;
     build(): TypedPlainTextOption<Value>;
 }
+/**
+ * Creates an option builder without an initial value.
+ *
+ * @param text The option text
+ * @returns An option builder without a value
+ */
 export declare function option(text: string | TextObjectBuilder<false>): OptionObjectBuilder<undefined>;
+/**
+ * Creates an option builder with an initial value.
+ *
+ * @param text The option text
+ * @param value The option value
+ * @returns An option builder with the value set
+ */
 export declare function option<Value extends string>(text: string | TextObjectBuilder<false>, value: Value): OptionObjectBuilder<Value>;
 export {};
 //# sourceMappingURL=option.d.ts.map

package/dist/blocks/objects/option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../../../src/blocks/objects/option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAE1E,KAAK,oBAAoB,CAAC,KAAK,SAAS,MAAM,GAAG,SAAS,IAAI,eAAe,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAEhG;;;;;;GAMG;AACH,qBAAa,mBAAmB,CAC/B,KAAK,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CACpD,SAAQ,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE5C,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;gBADN,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAC/B,MAAM,EAAE,KAAK;IAKtB;;;;;OAKG;IACH,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC;IAK5D,KAAK,IAAI,oBAAoB,CAAC,KAAK,CAAC;CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAA;AAC/F;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,SAAS,MAAM,EAC1C,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,EACvC,KAAK,EAAE,KAAK,GACV,mBAAmB,CAAC,KAAK,CAAC,CAAA"}

package/dist/{src/blocks → blocks}/objects/option.js

@@ -1,5 +1,12 @@
 import { Builder } from "../base.js";
 import { ensureIsTextObjectBuilder } from "./text.js";
+/**
+ * Builder for option objects.
+ *
+ * Option objects are used in select menus to define the available choices.
+ *
+ * @template Value The option value type
+ */
 export class OptionObjectBuilder extends Builder {
     _text;
     _value;
@@ -8,6 +15,12 @@ export class OptionObjectBuilder extends Builder {
         this._text = _text;
         this._value = _value;
     }
+    /**
+     * Sets the value for this option.
+     *
+     * @param value The option value
+     * @returns This builder with the value set
+     */
     value(value) {
         this._value = value;
         return this;

package/dist/blocks/objects/text.d.ts

@@ -0,0 +1,116 @@
+import type { MrkdwnElement, PlainTextElement } from "@slack/types";
+import { Builder } from "../base.js";
+/**
+ * Builder for text objects.
+ *
+ * Text objects support both plain text and markdown formatting.
+ *
+ * @template Mrkdwn Whether markdown formatting is enabled
+ */
+export declare class TextObjectBuilder<Mrkdwn extends boolean = boolean> extends Builder<Mrkdwn extends true ? MrkdwnElement : PlainTextElement> {
+    private _text;
+    private _mrkdwn;
+    private _emoji;
+    private _verbatim;
+    constructor(_text: string, _mrkdwn: Mrkdwn);
+    /**
+     * Enables emoji rendering for plain text (converts `:emoji_name:` to emoji).
+     *
+     * Only applicable to plain text objects.
+     *
+     * @param emoji Whether to enable emoji rendering
+     * @returns This builder
+     */
+    emoji(this: TextObjectBuilder<false>, emoji?: boolean): TextObjectBuilder<false>;
+    /**
+     * Disables automatic parsing of markdown formatting.
+     *
+     * Only applicable to markdown text objects.
+     *
+     * @param verbatim Whether to disable formatting
+     * @returns This builder
+     */
+    verbatim(this: TextObjectBuilder<true>, verbatim?: boolean): TextObjectBuilder<true>;
+    /**
+     * Switches to markdown formatting.
+     *
+     * @returns This builder with markdown enabled
+     */
+    mrkdwn(): TextObjectBuilder<true>;
+    /**
+     * Switches between plain text and markdown formatting.
+     *
+     * @param mrkdwn Whether to enable markdown
+     * @returns This builder with the specified format
+     */
+    mrkdwn<Mrkdwn extends boolean = true>(mrkdwn: Mrkdwn): TextObjectBuilder<Mrkdwn>;
+    /**
+     * Switches to plain text formatting.
+     *
+     * @returns This builder with plain text formatting
+     */
+    plain(): TextObjectBuilder<false>;
+    build(): Mrkdwn extends true ? MrkdwnElement : PlainTextElement;
+}
+/**
+ * Creates a markdown text object builder.
+ *
+ * @param text The markdown text
+ * @returns A text object builder with markdown enabled
+ */
+export declare function mrkdwn(text: string): TextObjectBuilder<true>;
+/** Alias for `mrkdwn()`. */
+export { mrkdwn as text };
+/**
+ * Creates a plain text object builder.
+ *
+ * @param text The plain text
+ * @returns A text object builder with plain text format
+ */
+export declare function plain(text: string): TextObjectBuilder<false>;
+/**
+ * Converts a string to a text object builder if needed.
+ *
+ * If the input is already a text object builder, it is returned as-is. If the input is a string, it
+ * is converted to a markdown text object builder.
+ *
+ * @param text A string or text object builder
+ * @returns A markdown text object builder
+ */
+export declare function ensureIsTextObjectBuilder(text: string): TextObjectBuilder<true>;
+/**
+ * Returns the text object builder as-is if it's already one.
+ *
+ * @param text A text object builder
+ * @returns The same text object builder
+ */
+export declare function ensureIsTextObjectBuilder<T extends TextObjectBuilder>(text: T): T;
+/**
+ * Converts a string to a text object builder or returns the builder as-is.
+ *
+ * @param text A string or text object builder
+ * @returns A text object builder
+ */
+export declare function ensureIsTextObjectBuilder<T extends TextObjectBuilder>(text: string | T): TextObjectBuilder<true> | T;
+/**
+ * Converts an optional string to a text object builder if present.
+ *
+ * @param text An optional string
+ * @returns A markdown text object builder or undefined
+ */
+export declare function ensureIsTextObjectBuilder(text?: string): TextObjectBuilder<true> | undefined;
+/**
+ * Returns an optional text object builder as-is if present.
+ *
+ * @param text An optional text object builder
+ * @returns The text object builder or undefined
+ */
+export declare function ensureIsTextObjectBuilder<T extends TextObjectBuilder>(text?: T): T | undefined;
+/**
+ * Converts an optional string to a text object builder or returns the builder as-is.
+ *
+ * @param text An optional string or text object builder
+ * @returns A text object builder or undefined
+ */
+export declare function ensureIsTextObjectBuilder<T extends TextObjectBuilder>(text?: string | T): TextObjectBuilder<true> | T | undefined;
+//# sourceMappingURL=text.d.ts.map

package/dist/blocks/objects/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/blocks/objects/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAAC,MAAM,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,OAAO,CAC/E,MAAM,SAAS,IAAI,GAAG,aAAa,GAAG,gBAAgB,CACtD;IAKC,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IALhB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAQ;gBAGhB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM;IAKxB;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAE,OAAc;IAK3D;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,OAAc;IAKhE;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC;IACjC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,SAAS,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAMhF;;;;OAIG;IACH,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC;IAIxB,KAAK,IAAI,MAAM,SAAS,IAAI,GAAG,aAAa,GAAG,gBAAgB;CAexE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAE5D;AAED,4BAA4B;AAC5B,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAA;AAEzB;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;AAChF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;AAClF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EACpE,IAAI,EAAE,MAAM,GAAG,CAAC,GACd,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9B;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;AAC7F;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;AAC/F;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EACpE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,GACf,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA"}

package/dist/{src/blocks → blocks}/objects/text.js

@@ -1,4 +1,11 @@
 import { Builder } from "../base.js";
+/**
+ * Builder for text objects.
+ *
+ * Text objects support both plain text and markdown formatting.
+ *
+ * @template Mrkdwn Whether markdown formatting is enabled
+ */
 export class TextObjectBuilder extends Builder {
     _text;
     _mrkdwn;
@@ -9,10 +16,26 @@ export class TextObjectBuilder extends Builder {
         this._text = _text;
         this._mrkdwn = _mrkdwn;
     }
+    /**
+     * Enables emoji rendering for plain text (converts `:emoji_name:` to emoji).
+     *
+     * Only applicable to plain text objects.
+     *
+     * @param emoji Whether to enable emoji rendering
+     * @returns This builder
+     */
     emoji(emoji = true) {
         this._emoji = emoji;
         return this;
     }
+    /**
+     * Disables automatic parsing of markdown formatting.
+     *
+     * Only applicable to markdown text objects.
+     *
+     * @param verbatim Whether to disable formatting
+     * @returns This builder
+     */
     verbatim(verbatim = true) {
         this._verbatim = verbatim;
         return this;
@@ -21,6 +44,11 @@ export class TextObjectBuilder extends Builder {
         this._mrkdwn = mrkdwn;
         return this;
     }
+    /**
+     * Switches to plain text formatting.
+     *
+     * @returns This builder with plain text formatting
+     */
     plain() {
         return this.mrkdwn(false);
     }
@@ -41,10 +69,23 @@ export class TextObjectBuilder extends Builder {
         }
     }
 }
+/**
+ * Creates a markdown text object builder.
+ *
+ * @param text The markdown text
+ * @returns A text object builder with markdown enabled
+ */
 export function mrkdwn(text) {
     return new TextObjectBuilder(text, true);
 }
+/** Alias for `mrkdwn()`. */
 export { mrkdwn as text };
+/**
+ * Creates a plain text object builder.
+ *
+ * @param text The plain text
+ * @returns A text object builder with plain text format
+ */
 export function plain(text) {
     return new TextObjectBuilder(text, false);
 }