@promptbook/node 0.61.0-10 → 0.61.0-12

package/umd/typings/src/utils/formatNumber.d.ts

@@ -1,6 +1,6 @@
 /**
  * Format either small or big number
  *
- * @private within the package
+ * @private within the repository
  */
 export declare function formatNumber(value: number): string;

package/umd/typings/src/utils/isRunningInWhatever.d.ts

@@ -10,3 +10,6 @@ export declare const isRunningInNode: Function;
  * Detects if the code is running in a web worker
  */
 export declare const isRunningInWebWorker: Function;
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/utils`
+ */

package/umd/typings/src/utils/markdown/addAutoGeneratedSection.d.ts

@@ -3,7 +3,7 @@ import type { string_name } from '../../types/typeAliases';
 /**
  * Add or modify an auto-generated section in a markdown file
  *
- * @private within the package
+ * @private within the repository
  */
 export declare function addAutoGeneratedSection(content: string_markdown, options: {
     readonly sectionName: string_name;

package/umd/typings/src/utils/markdown/createMarkdownChart.d.ts

@@ -28,7 +28,7 @@ type CreateMarkdownChartOptions = {
 /**
  * Function createMarkdownChart will draw a chart in markdown from ⬛+🟦 tiles
  *
- * @private within the package
+ * @private within the repository
  */
 export declare function createMarkdownChart(options: CreateMarkdownChartOptions): string_markdown;
 export {};

package/umd/typings/src/utils/markdown/createMarkdownTable.d.ts

@@ -3,6 +3,6 @@ import type { string_markdown_text } from '../../types/typeAliases';
 /**
  * Create a markdown table from a 2D array of strings
  *
- * @private within the package
+ * @private within the repository
  */
 export declare function createMarkdownTable(table: Array<Array<string_markdown_text>>): string_markdown;

package/umd/typings/src/utils/markdown/extractAllBlocksFromMarkdown-real.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/typings/src/utils/markdown/extractAllBlocksFromMarkdown.d.ts

@@ -3,6 +3,10 @@ import type { string_markdown } from '../../types/typeAliases';
  * Single code block inside markdown.
  */
 export type CodeBlock = {
+    /**
+     * Which notation was used to open the code block
+     */
+    readonly blockNotation: '```' | '>';
     /**
      * Language of the code block OR null if the language is not specified in opening ```
      */
@@ -25,3 +29,6 @@ export type CodeBlock = {
  *
  */
 export declare function extractAllBlocksFromMarkdown(markdown: string_markdown): Array<CodeBlock>;
+/**
+ * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
+ */

package/umd/typings/src/utils/markdown/extractOneBlockFromMarkdown.d.ts

@@ -15,5 +15,5 @@ import type { CodeBlock } from './extractAllBlocksFromMarkdown';
  */
 export declare function extractOneBlockFromMarkdown(markdown: string_markdown): CodeBlock;
 /***
- * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+ * TODO: [🍓][🌻] Decide of this is internal util, external util OR validator/postprocessor
  */

package/umd/typings/src/utils/organization/TODO.d.ts

@@ -1,4 +1,6 @@
 /**
  * Organizational helper to better mark the place where the type is missing
+ *
+ * @private within the repository
  */
 export type TODO = any;

package/umd/typings/src/utils/organization/TODO_USE.d.ts

@@ -7,5 +7,6 @@ import type { really_any } from './really_any';
  *
  * @param value any values
  * @returns void
+ * @private within the repository
  */
 export declare function TODO_USE(...value: Array<really_any>): void;

package/umd/typings/src/utils/organization/___.d.ts

@@ -1,4 +1,6 @@
 /**
  * Formatting helper to put void to keep longer version of prettier
+ *
+ * @private within the repository
  */
 export type ___ = never;

package/umd/typings/src/utils/organization/just.d.ts

@@ -6,5 +6,6 @@
  *
  * @param value any values
  * @returns the same values
+ * @private within the repository
  */
 export declare function just<T>(value?: T): T;

package/umd/typings/src/utils/organization/keepImported.d.ts

@@ -0,0 +1,12 @@
+import type { really_any } from './really_any';
+/**
+ * Just says that the variable is not used but should be kept
+ * No side effects.
+ *
+ * Note: It can be usefull suppressing eager optimization of unused imports
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+export declare function keepImported(...value: Array<really_any>): void;

package/umd/typings/src/utils/organization/notUsing.d.ts

@@ -0,0 +1,12 @@
+import type { really_any } from './really_any';
+/**
+ * Just says that the variable is not used
+ * No side effects.
+ *
+ * Note: It can be usefull suppressing eslint errors of unused variables in the tests
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+export declare function notUsing(...value: Array<really_any>): void;

package/umd/typings/src/utils/organization/really_any.d.ts

@@ -1,4 +1,6 @@
 /**
  * Organizational helper to mark a place where to really use any
+ *
+ * @private within the repository
  */
 export type really_any = any;

package/umd/typings/src/utils/random/randomSeed.d.ts

@@ -0,0 +1,7 @@
+import type { number_seed } from '../../types/typeAliases';
+/**
+ * Generates random seed
+ *
+ * Warning: This function is not cryptographically secure (it uses Math.random internally)
+ */
+export declare function $randomSeed(): number_seed;

package/umd/typings/src/version.d.ts

@@ -4,3 +4,6 @@ import type { string_semantic_version } from './types/typeAliases';
  */
 export declare const PROMPTBOOK_VERSION: string_promptbook_version;
 export type string_promptbook_version = string_semantic_version;
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/code`
+ */

package/esm/typings/src/collection/constructors/justTestFsImport.d.ts

@@ -1,7 +0,0 @@
-/**
- * Just testing imports and compatibility
- */
-export declare function justTestFsImport(): Promise<void>;
-/**
- * TODO: !!! Remove this file
- */

package/esm/typings/src/knowledge/prepare-knowledge/_common/utils/getLlmToolsForTests.d.ts

@@ -1,7 +0,0 @@
-import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
-/**
- * Returns LLM tools for testing purposes
- *
- * @private within the package - JUST FOR TESTS
- */
-export declare function getLlmToolsForTests(): LlmExecutionTools;

package/umd/typings/src/collection/constructors/justTestFsImport.d.ts

@@ -1,7 +0,0 @@
-/**
- * Just testing imports and compatibility
- */
-export declare function justTestFsImport(): Promise<void>;
-/**
- * TODO: !!! Remove this file
- */

package/umd/typings/src/knowledge/prepare-knowledge/_common/utils/getLlmToolsForTests.d.ts

@@ -1,7 +0,0 @@
-import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
-/**
- * Returns LLM tools for testing purposes
- *
- * @private within the package - JUST FOR TESTS
- */
-export declare function getLlmToolsForTests(): LlmExecutionTools;