@sendbird/actionbook-core 0.8.1 → 0.9.1

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2024-2026 Sendbird, Inc. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Sendbird, Inc. The Software is made available for
+viewing purposes only. No permission is granted to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+SENDBIRD, INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 Framework-agnostic core library for Actionbook documents.
 
-## Installation
+## Install
 
 ```bash
 npm install @sendbird/actionbook-core
@@ -10,4 +10,4 @@ npm install @sendbird/actionbook-core
 
 ## License
 
-Proprietary - Sendbird, Inc. All rights reserved.
+Proprietary — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BlockNode, a as BlockquoteNode, b as BoldMark, L as ListItemNode, c as BulletListNode, C as CodeMark, D as DocumentNode, H as HardBreakNode, I as InlineNode, d as HeadingNode, e as HorizontalRuleNode, f as ItalicMark, J as JinjaIfBranch, g as JinjaIfBlockNode, h as JinjaIfInlineNode, i as JumpPointNode, j as LinkMark, O as OrderedListNode, P as ParagraphNode, R as ResourceTagType, k as ResourceTagNode, S as StrikethroughMark, T as TableRowNode, l as TableNode, m as TableCellNode, M as Mark, n as TextNode, U as UnderlineMark, A as AstNode, N as NodePath, o as LintRule, p as LintContext, q as LintResult, r as LlmLintRule, s as LlmCompletionEndpoint, t as LintSection } from './types-rEXLrfo_.js';
-export { u as JSONContent, v as JUMP_POINT_ID_PATTERN, w as LintSeverity, x as RESOURCE_TAG_TYPES, y as fromProseMirrorJSON } from './types-rEXLrfo_.js';
+import { B as BlockNode, a as BlockquoteNode, b as BoldMark, L as ListItemNode, c as BulletListNode, C as CodeMark, D as DocumentNode, H as HardBreakNode, I as InlineNode, d as HeadingNode, e as HorizontalRuleNode, f as ItalicMark, J as JinjaIfBranch, g as JinjaIfBlockNode, h as JinjaIfInlineNode, i as JumpPointNode, j as LinkMark, N as NoteBlockNode, O as OrderedListNode, P as ParagraphNode, R as ResourceTagType, k as ResourceTagNode, S as StrikethroughMark, T as TableRowNode, l as TableNode, m as TableCellNode, M as Mark, n as TextNode, U as UnderlineMark, A as AstNode, o as NodePath, p as LintRule, q as LintContext, r as LintResult, s as LlmLintRule, t as LlmCompletionEndpoint, u as LintSection } from './types-DK_GhIWZ.js';
+export { v as JSONContent, w as JUMP_POINT_ID_PATTERN, x as LintSeverity, y as RESOURCE_TAG_TYPES, z as fromProseMirrorJSON } from './types-DK_GhIWZ.js';
 import { Root } from 'mdast';
 
 declare const bold: () => BoldMark;
@@ -21,6 +21,7 @@ declare function listItem(checked: boolean | null, ...content: BlockNode[]): Lis
 declare const todoItem: (checked: boolean, ...content: BlockNode[]) => ListItemNode;
 declare const blockquote: (...content: BlockNode[]) => BlockquoteNode;
 declare const horizontalRule: () => HorizontalRuleNode;
+declare const noteBlock: (...content: BlockNode[]) => NoteBlockNode;
 declare const tableCell: (header: boolean, ...content: InlineNode[]) => TableCellNode;
 declare const tableRow: (...cells: TableCellNode[]) => TableRowNode;
 declare const table: (...rows: TableRowNode[]) => TableNode;
@@ -222,6 +223,15 @@ declare function collectAllVariables(structures: JinjaIfStructure[]): Variable[]
  */
 declare function evaluateCondition(condition: string, variables: Map<string, VariableValue>): boolean | null;
 
+type HighlightCategory = 'variable' | 'operator' | 'value' | 'punctuation';
+interface ConditionToken {
+    readonly text: string;
+    readonly start: number;
+    readonly end: number;
+    readonly category: HighlightCategory;
+}
+declare function tokenizeCondition(input: string): ConditionToken[];
+
 /**
  * Evaluate Jinja if-block AST nodes by selecting the first truthy branch.
  * Post-processes adjacent same-type lists to merge and renumber.
@@ -338,6 +348,30 @@ interface BranchDecision {
     contextRequirements?: Record<string, string>;
 }
 
+/**
+ * Extract a hierarchical tree structure from a DocumentNode for the preview tree view.
+ *
+ * Walks the AST and produces a tree of:
+ * - Headings (H1/H2 as sections, H3-H6 as subsections)
+ * - Jump points with their IDs
+ * - Jinja if blocks with condition branches
+ * - Resource tags (tool, handoff, etc.)
+ */
+
+type DocumentTreeNodeType = 'heading' | 'jumpPoint' | 'jinjaIf' | 'jinjaBranch' | 'resourceTag' | 'noteBlock' | 'endAction';
+interface DocumentTreeNode {
+    readonly type: DocumentTreeNodeType;
+    readonly label: string;
+    readonly blockIndex: number;
+    readonly children: readonly DocumentTreeNode[];
+    readonly meta?: Record<string, unknown>;
+}
+/**
+ * Build a document outline tree from a DocumentNode.
+ * Extracts both structured jinjaIfBlock nodes and text-based {% if %} patterns.
+ */
+declare function buildDocumentTree(doc: DocumentNode): DocumentTreeNode[];
+
 /**
  * Tree Generator for Actionbook Decision Trees
  *
@@ -390,4 +424,4 @@ declare function actionbookToAST(manual: {
     logic: LogicV2;
 }): DocumentNode;
 
-export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, underline, validate, visit };
+export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type ConditionToken, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type DocumentTreeNode, type DocumentTreeNodeType, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, type HighlightCategory, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, NoteBlockNode, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, buildDocumentTree, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, noteBlock, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, tokenizeCondition, underline, validate, visit };