@note3/utils 0.0.21 → 0.0.24

package/dist/applog-collection.d.ts

@@ -0,0 +1,49 @@
+import type { Applog, EntityID } from '@wovin/core/applog';
+import type { ThreadOnlyCurrentNoDeleted } from '@wovin/core/thread';
+/**
+ * Generic recursive traversal utility for note tree structures.
+ *
+ * Traverses a note and all its descendants, applying a mapping function to each
+ * node and combining results using a join function.
+ *
+ * @param thread - Pre-filtered thread (from `lastWriteWins(withoutDeleted(raw))`)
+ * @param blockID - The root block ID to start traversal from
+ * @param mapKid - Function to apply to each block/relation pair
+ * @param joinResults - Function to combine parent result with children results
+ * @returns The combined result of the traversal
+ *
+ * @throws Error if circular references are detected or depth exceeds 42 levels
+ *
+ * @internal Used by collectSubtreeApplogs; not typically used directly
+ */
+export declare function mapAndRecurseKids<R = void>(thread: ThreadOnlyCurrentNoDeleted, blockID: EntityID, mapKid: (kid: {
+    relID: EntityID | null;
+    blockID: EntityID;
+}) => R, joinResults: (blockResult: R, kidResults: R[]) => R): any;
+/**
+ * Collects all applogs for a note and its entire subtree (descendants).
+ *
+ * This is a non-reactive utility version for use in non-UI contexts (CLI, scripts, MCP server).
+ * It returns a flat array of all applogs found during tree traversal.
+ *
+ * **Important**: The thread parameter MUST be pre-filtered using `lastWriteWins(withoutDeleted(thread))`
+ * to ensure correct tree traversal. Unfiltered threads may:
+ * - Include deleted blocks/relations (incorrect tree structure)
+ * - Include multiple versions of the same applog (redundant)
+ *
+ * @param thread - Pre-filtered thread (must be result of `lastWriteWins(withoutDeleted(raw))`)
+ * @param blockID - The root block ID to collect from
+ * @returns Flat array of all applogs from the block and its descendants
+ *
+ * @example
+ * ```typescript
+ * import { collectSubtreeApplogs } from '@note3/utils'
+ * import { lastWriteWins, withoutDeleted } from '@wovin/core'
+ *
+ * const filteredThread = withoutDeleted(lastWriteWins(rawThread))
+ * const applogs = collectSubtreeApplogs(filteredThread, blockID)
+ * console.log(`Collected ${applogs.length} applogs`)
+ * ```
+ */
+export declare function collectSubtreeApplogs(thread: ThreadOnlyCurrentNoDeleted, blockID: EntityID): Applog[];
+//# sourceMappingURL=applog-collection.d.ts.map

package/dist/applog-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applog-collection.d.ts","sourceRoot":"","sources":["../src/applog-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAGpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,IAAI,EACzC,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,KAAK,CAAC,EACjE,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,CAAC,OA0BnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,QAAQ,GACf,MAAM,EAAE,CAoBV"}

package/dist/applog-collection.min.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-WZPDIIA2.min.js";import"./chunk-7XDDTUI3.min.js";import"./chunk-MXMMU6NF.min.js";export{b as collectSubtreeApplogs,a as mapAndRecurseKids};
+//# sourceMappingURL=applog-collection.min.js.map

package/dist/applog-collection.min.js.map

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