@note3/utils 0.0.20 → 0.0.21

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './map';
 export * from './note3-regex-constants';
 export * from './note3-utils-nodeps';
 export * from './queries';
+export * from './tree-builder';
 export * from './types';
 export * from './relation-ordering';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA"}

package/dist/index.min.js

@@ -1,2 +1,2 @@
-import"./chunk-KHOUPFOL.min.js";import{a as o,b as r,c as e,d as f,e as m}from"./chunk-PA6WBVCJ.min.js";import{a as p}from"./chunk-IFY2JCCQ.min.js";import{a as H,b as I,c as J,d as K,e as L,f as M,g as N}from"./chunk-44UQ54GR.min.js";import{a as u,b as v,c as w,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F}from"./chunk-LDNVHZO7.min.js";import{a as t,b as x,c as a,d as b,e as c,f as d,g,h,i,j,k,l,m as n,n as q,o as s}from"./chunk-POX3PUJK.min.js";import{a as G}from"./chunk-KY36PVHK.min.js";import"./chunk-MXMMU6NF.min.js";export{i as RE_ANY_TAG_ONLY,s as RE_ANY_TAG_WITHCONTEXT,h as RE_AT_TAG_ONLY,q as RE_AT_TAG_WITHCONTEXT,d as RE_HASH_TAG_ONLY,l as RE_HASH_TAG_WITHCONTEXT,g as RE_PLUS_TAG_ONLY,n as RE_PLUS_TAG_WITHCONTEXT,c as RE_TAG_BODY,a as RE_TAG_BODY_CHAR,b as RE_TAG_BODY_REQUIRED_CHAR,k as RE_TAG_CONTEXT_POST,j as RE_TAG_CONTEXT_PRE,p as SetMap,x as TAG_MIN_LENGTH,t as TIPTAP_EMPTY,e as asyncIterableToArray,f as blobToAsyncIterable,F as contentVlToPlaintext,E as getAllTagsInText,H as getChildIDs,J as getChildRelations,L as getContent,M as getContentText,I as getParentIDs,K as getParentRelations,N as getRootIDs,o as lazyVal,G as orderRelations,v as parseBlockContentValue,B as plainContentMatchAnyTag,A as plainContentMatchAtTag,y as plainContentMatchHashTag,z as plainContentMatchPlusTag,C as plainContentMatchTagGeneric,u as plaintextStringToTiptap,r as racePromises,D as rawContentMatchTag,m as recurseWithLoopProtection,w as tiptapToPlaintext};
+import{a as O,b as P,c as Q,d as R,e as S}from"./chunk-K5PSO7Y4.min.js";import"./chunk-KHOUPFOL.min.js";import{a as o,b as r,c as e,d as f,e as m}from"./chunk-PA6WBVCJ.min.js";import{a as p}from"./chunk-IFY2JCCQ.min.js";import{a as H,b as I,c as J,d as K,e as L,f as M,g as N}from"./chunk-44UQ54GR.min.js";import{a as u,b as v,c as w,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F}from"./chunk-LDNVHZO7.min.js";import{a as t,b as x,c as a,d as b,e as c,f as d,g,h,i,j,k,l,m as n,n as q,o as s}from"./chunk-POX3PUJK.min.js";import{a as G}from"./chunk-KY36PVHK.min.js";import"./chunk-MXMMU6NF.min.js";export{i as RE_ANY_TAG_ONLY,s as RE_ANY_TAG_WITHCONTEXT,h as RE_AT_TAG_ONLY,q as RE_AT_TAG_WITHCONTEXT,d as RE_HASH_TAG_ONLY,l as RE_HASH_TAG_WITHCONTEXT,g as RE_PLUS_TAG_ONLY,n as RE_PLUS_TAG_WITHCONTEXT,c as RE_TAG_BODY,a as RE_TAG_BODY_CHAR,b as RE_TAG_BODY_REQUIRED_CHAR,k as RE_TAG_CONTEXT_POST,j as RE_TAG_CONTEXT_PRE,p as SetMap,x as TAG_MIN_LENGTH,t as TIPTAP_EMPTY,e as asyncIterableToArray,f as blobToAsyncIterable,F as contentVlToPlaintext,O as createBlockApplogs,P as createRelationApplogs,Q as createSingleNodeApplogs,S as createSingleTree,R as createTreeApplogs,E as getAllTagsInText,H as getChildIDs,J as getChildRelations,L as getContent,M as getContentText,I as getParentIDs,K as getParentRelations,N as getRootIDs,o as lazyVal,G as orderRelations,v as parseBlockContentValue,B as plainContentMatchAnyTag,A as plainContentMatchAtTag,y as plainContentMatchHashTag,z as plainContentMatchPlusTag,C as plainContentMatchTagGeneric,u as plaintextStringToTiptap,r as racePromises,D as rawContentMatchTag,m as recurseWithLoopProtection,w as tiptapToPlaintext};
 //# sourceMappingURL=index.min.js.map

package/dist/tree-builder.d.ts

@@ -0,0 +1,114 @@
+import type { ApplogForInsertOptionalAgent, EntityID } from '@wovin/core/applog';
+import type { TiptapContent } from './note3-utils-nodeps';
+/**
+ * Represents a single node in a tree structure.
+ * Content can be a string or a Tiptap JSON object.
+ * Children are optional and can be recursively nested.
+ */
+export interface TreeNode {
+    /** Content as string or Tiptap object (auto-serialized) */
+    content: string | TiptapContent;
+    /** Optional child nodes */
+    children?: TreeNode[];
+}
+/**
+ * Result of creating a single node with its applogs
+ */
+export interface NodeCreationResult {
+    blockID: EntityID;
+    applogs: ApplogForInsertOptionalAgent[];
+}
+/**
+ * Result of creating a tree with applogs
+ */
+export interface TreeCreationResult {
+    rootIDs: EntityID[];
+    applogs: ApplogForInsertOptionalAgent[];
+}
+/**
+ * Creates block applogs for a single piece of content.
+ * Generates an entity ID using getHashID.
+ *
+ * @param content - String or TiptapContent object
+ * @param entityID - Optional pre-computed entity ID
+ * @returns Object with generated entityID and applogs array
+ */
+export declare function createBlockApplogs(content: string | TiptapContent, entityID?: EntityID): {
+    en: EntityID;
+    applogs: ApplogForInsertOptionalAgent[];
+};
+/**
+ * Creates relation applogs that connect a block as a child of a parent.
+ * Generates three applogs: one for the block reference, one for the parent reference,
+ * and one for the sibling ordering (after).
+ *
+ * @param blockID - The ID of the child block
+ * @param childOf - The ID of the parent block
+ * @param after - The ID of the previous sibling (or null if first child)
+ * @param relationID - Optional pre-computed relation entity ID
+ * @returns Object with relation entity ID and applogs array
+ */
+export declare function createRelationApplogs(blockID: EntityID, childOf: EntityID, after: EntityID | null, relationID?: EntityID): {
+    en: EntityID;
+    applogs: ApplogForInsertOptionalAgent[];
+};
+/**
+ * Recursively creates applogs for a single node and its children.
+ * Maintains proper sibling ordering using the 'after' field.
+ *
+ * @param node - The node to create
+ * @param parentID - Optional parent block ID. If provided, creates a relation to parent.
+ * @param after - Optional previous sibling ID for proper ordering
+ * @returns Object with block ID and flattened applogs array
+ */
+export declare function createSingleNodeApplogs(node: TreeNode, parentID?: EntityID, after?: EntityID | null): NodeCreationResult;
+/**
+ * Creates applogs for multiple root nodes (nodes without a parent).
+ * All nodes are created as standalone roots.
+ *
+ * @param nodes - Array of root nodes
+ * @returns Object with array of root IDs and flattened applogs
+ *
+ * @example
+ * const nodes: TreeNode[] = [
+ *   { content: 'Root 1', children: [{ content: 'Child 1' }] },
+ *   { content: 'Root 2' }
+ * ]
+ * const { rootIDs, applogs } = createTreeApplogs(nodes)
+ */
+export declare function createTreeApplogs(nodes: TreeNode[]): TreeCreationResult;
+/**
+ * Creates applogs for multiple nodes as children of a parent.
+ * All nodes are created as children of the specified parent.
+ *
+ * @param nodes - Array of nodes
+ * @param parentID - Parent block ID. Nodes will be created as children of this parent.
+ * @returns Object with array of created block IDs and flattened applogs
+ *
+ * @example
+ * const subtree: TreeNode[] = [
+ *   { content: 'Child 1' },
+ *   { content: 'Child 2' }
+ * ]
+ * const { rootIDs, applogs } = createTreeApplogs(subtree, 'existingParentID')
+ */
+export declare function createTreeApplogs(nodes: TreeNode[], parentID: EntityID): TreeCreationResult;
+/**
+ * Creates applogs for a single root node with its descendants.
+ * Convenience function that returns just the root block ID instead of an array.
+ *
+ * @param root - The root node
+ * @returns Object with root block ID and applogs
+ *
+ * @example
+ * const node: TreeNode = {
+ *   content: 'Parent',
+ *   children: [
+ *     { content: 'Child 1' },
+ *     { content: 'Child 2' }
+ *   ]
+ * }
+ * const { blockID, applogs } = createSingleTree(node)
+ */
+export declare function createSingleTree(root: TreeNode): NodeCreationResult;
+//# sourceMappingURL=tree-builder.d.ts.map

package/dist/tree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../src/tree-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,GAAG,aAAa,CAAA;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,QAAQ,CAAA;IACjB,OAAO,EAAE,4BAA4B,EAAE,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,OAAO,EAAE,4BAA4B,EAAE,CAAA;CACvC;AAWD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,GAAG,aAAa,EAC/B,QAAQ,CAAC,EAAE,QAAQ,GACjB;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,4BAA4B,EAAE,CAAA;CAAE,CAc3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,QAAQ,GAAG,IAAI,EACtB,UAAU,CAAC,EAAE,QAAQ,GACnB;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,4BAA4B,EAAE,CAAA;CAAE,CAa3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,QAAQ,EACnB,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,GACrB,kBAAkB,CA2BpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAA;AACxE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CAAA;AAoB5F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CAEnE"}

package/dist/tree-builder.min.js

@@ -0,0 +1,2 @@
+import{a,b,c,d,e}from"./chunk-K5PSO7Y4.min.js";import"./chunk-MXMMU6NF.min.js";export{a as createBlockApplogs,b as createRelationApplogs,c as createSingleNodeApplogs,e as createSingleTree,d as createTreeApplogs};
+//# sourceMappingURL=tree-builder.min.js.map

package/dist/tree-builder.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@note3/utils",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "private": false,
   "main": "./dist/index.min.js",
@@ -27,7 +27,7 @@
     "bundle": false
   },
   "dependencies": {
-    "@wovin/core": "0.0.20",
+    "@wovin/core": "0.0.21",
     "besonders-logger": "1.0.2",
     "comlink": "^4.4.2",
     "core-js": "^3.45.1",