@promptbook/javascript 0.112.0-34 → 0.112.0-35

package/umd/src/utils/environment/$isRunningInWebWorker.d.ts

@@ -6,6 +6,3 @@
  * @public exported from `@promptbook/utils`
  */
 export declare function $isRunningInWebWorker(): boolean;
-/**
- * TODO: [🎺]
- */

package/umd/src/utils/execCommand/$execCommand.d.ts

@@ -3,7 +3,6 @@ import type { ExecCommandOptions } from './ExecCommandOptions';
 /**
  * Run one command in a shell
  *
- *
  * Note: There are 2 similar functions in the codebase:
  * - `$execCommand` which runs a single command
  * - `$execCommands` which runs multiple commands
@@ -12,4 +11,3 @@ import type { ExecCommandOptions } from './ExecCommandOptions';
  * @public exported from `@promptbook/node`
  */
 export declare function $execCommand(options: ExecCommandOptions): Promise<$side_effect & string>;
-/** Note: [🟢] Code for Node command-execution helper [$execCommand](src/utils/execCommand/$execCommand.ts) should never be published into packages that could be imported into browser environment */

package/umd/src/utils/execCommand/$execCommands.d.ts

@@ -14,4 +14,3 @@ export declare function $execCommands({ commands, cwd, crashOnError, }: $side_ef
     readonly cwd: string;
     readonly crashOnError?: boolean;
 }): Promise<void>;
-/** Note: [🟢] Code for Node command-execution helper [$execCommands](src/utils/execCommand/$execCommands.ts) should never be published into packages that could be imported into browser environment */

package/umd/src/utils/execCommand/ExecCommandOptions.d.ts

@@ -1,5 +1,7 @@
 /**
- * @deprecated Use sth from type-fest or move this to type helpers
+ * Use sth from type-fest or move this to type helpers.
+ *
+ * @deprecated
  */
 type RequiredAndOptional<TBase, TRequired extends keyof TBase, TOptional extends keyof TBase> = Pick<TBase, TRequired> & Partial<Pick<TBase, TOptional>>;
 /**
@@ -46,6 +48,3 @@ export type ExecCommandOptionsAdvanced = {
     readonly env?: Record<string, string>;
 };
 export {};
-/**
- * TODO: [⏳] Make DEFAULT_TIMEOUT_MS as global constant
- */

package/umd/src/utils/expectation-counters/constants.d.ts

@@ -10,7 +10,3 @@ export declare const CHARACTERS_PER_STANDARD_LINE = 63;
  * @public exported from `@promptbook/utils`
  */
 export declare const LINES_PER_STANDARD_PAGE = 44;
-/**
- * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/expectation-counters/countCharacters.d.ts

@@ -5,7 +5,3 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
  * @public exported from `@promptbook/utils`
  */
 export declare function countCharacters(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/expectation-counters/countLines.d.ts

@@ -7,7 +7,3 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
  * @public exported from `@promptbook/utils`
  */
 export declare function countLines(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/expectation-counters/countPages.d.ts

@@ -7,7 +7,3 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
  * @public exported from `@promptbook/utils`
  */
 export declare function countPages(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/expectation-counters/countParagraphs.d.ts

@@ -5,7 +5,3 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
  * @public exported from `@promptbook/utils`
  */
 export declare function countParagraphs(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/expectation-counters/countSentences.d.ts

@@ -11,7 +11,3 @@ export declare function splitIntoSentences(text: string): ReadonlyArray<string>;
  * @public exported from `@promptbook/utils`
  */
 export declare function countSentences(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/expectation-counters/countWords.d.ts

@@ -5,8 +5,3 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
  * @public exported from `@promptbook/utils`
  */
 export declare function countWords(text: string): ExpectationAmount;
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- * TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
- */

package/umd/src/utils/expectation-counters/index.d.ts

@@ -6,7 +6,3 @@ import type { ExpectationUnit } from '../../pipeline/PipelineJson/Expectations';
  * @public exported from `@promptbook/utils`
  */
 export declare const CountUtils: Record<ExpectationUnit, (text: string) => ExpectationAmount>;
-/**
- * TODO: [🧠][🤠] This should be probably as part of `TextFormatParser`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/files/$induceBookDownload.d.ts

@@ -8,4 +8,3 @@ import type { $side_effect } from '../organization/$side_effect';
  * @public exported from `@promptbook/browser`
  */
 export declare function $induceBookDownload(book: string_book): Promise<$side_effect>;
-/** Note: [🔵] Code for browser file helper [$induceBookDownload](src/utils/files/$induceBookDownload.ts) should never be published outside of `@promptbook/browser` */

package/umd/src/utils/files/$induceFileDownload.d.ts

@@ -8,4 +8,3 @@ import type { $side_effect } from '../organization/$side_effect';
  * @public exported from `@promptbook/browser`
  */
 export declare function $induceFileDownload(fileOrBlobOrUrl: File | Blob | URL | string_url): Promise<$side_effect>;
-/** Note: [🔵] Code for browser file helper [$induceFileDownload](src/utils/files/$induceFileDownload.ts) should never be published outside of `@promptbook/browser` */

package/umd/src/utils/files/ObjectUrl.d.ts

@@ -41,4 +41,3 @@ export declare class ObjectUrl extends Registration implements IDestroyable {
      */
     get url(): URL;
 }
-/** Note: [🔵] Code for browser file helper [ObjectUrl](src/utils/files/ObjectUrl.ts) should never be published outside of `@promptbook/browser` */

package/umd/src/utils/files/isDirectoryExisting.d.ts

@@ -6,9 +6,3 @@ import type { string_dirname } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function isDirectoryExisting(directoryPath: string_dirname, fs: FilesystemTools): Promise<boolean>;
-/**
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
- * TODO: [🧠][📂] "directory" vs "folder"
- * TODO: [🖇] What about symlinks?
- */

package/umd/src/utils/files/isExecutable.d.ts

@@ -5,7 +5,3 @@ import type { FilesystemTools } from '../../execution/FilesystemTools';
  * @private within the repository
  */
 export declare function isExecutable(path: string, fs: FilesystemTools): Promise<boolean>;
-/**
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🖇] What about symlinks?
- */

package/umd/src/utils/files/isFileExisting.d.ts

@@ -6,8 +6,3 @@ import type { string_filename } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function isFileExisting(filename: string_filename, fs: FilesystemTools): Promise<boolean>;
-/**
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
- * TODO: [🖇] What about symlinks?
- */

package/umd/src/utils/files/listAllFiles.d.ts

@@ -6,11 +6,7 @@ import type { string_dirname, string_filename } from '../../types/typeAliases';
  * @param path
  * @param isRecursive
  * @returns List of all files in the directory
+ *
  * @private internal function of `AgentCollectionInDirectory` and `createPipelineCollectionFromDirectory`
  */
 export declare function listAllFiles(path: string_dirname, isRecursive: boolean, fs: FilesystemTools): Promise<Array<string_filename>>;
-/**
- * TODO: [😶] Unite folder listing
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🖇] What about symlinks?
- */

package/umd/src/utils/files/readResponseBytes.d.ts

@@ -5,6 +5,7 @@
  * @param {number} maxBytes - Maximum number of bytes to capture.
  * @param {{ captureOverflowByte?: boolean }} [options] - Optional capture behavior.
  * @returns {Promise<{ bytes: Uint8Array }>} Captured bytes, optionally including one overflow byte.
+ *
  * @private internal utility for bounded response reads
  */
 export declare function readResponseBytes(response: Response, maxBytes: number, options?: {

package/umd/src/utils/knowledge/inlineKnowledgeSource.d.ts

@@ -2,6 +2,8 @@
 /// <reference types="node" />
 import type { string_data_url, string_filename, string_knowledge_source_link } from '../../types/typeAliases';
 /**
+ * Type describing inline knowledge source file.
+ *
  * @private Internal representation of inline knowledge prepared for uploads.
  */
 export type InlineKnowledgeSourceFile = {
@@ -10,11 +12,15 @@ export type InlineKnowledgeSourceFile = {
     readonly buffer: Buffer;
 };
 /**
- * @private Function signature used to upload inline knowledge files to external storage.
+ * Function signature used to upload inline knowledge files to external storage.
+ *
+ * @private
  */
 export type InlineKnowledgeSourceUploader = (file: InlineKnowledgeSourceFile) => Promise<string_knowledge_source_link>;
 /**
- * @private Converts inline knowledge into the internal metadata form used for uploads.
+ * Converts inline knowledge into the internal metadata form used for uploads.
+ *
+ * @private
  */
 export declare function createInlineKnowledgeSourceFile(content: string): InlineKnowledgeSourceFile;
 /**
@@ -24,7 +30,9 @@ export declare function createInlineKnowledgeSourceFile(content: string): Inline
  */
 export declare function isDataUrlKnowledgeSource(source: string): source is string_data_url;
 /**
- * @private Converts a stored inline knowledge file into a data URL for backwards compatibility.
+ * Converts a stored inline knowledge file into a data URL for backwards compatibility.
+ *
+ * @private
  */
 export declare function inlineKnowledgeSourceToDataUrl(source: InlineKnowledgeSourceFile): string_knowledge_source_link;
 /**
@@ -37,6 +45,3 @@ export declare function parseDataUrlKnowledgeSource(source: string): {
     readonly filename: string_filename;
     readonly mimeType: string;
 } | null;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/knowledge/simplifyKnowledgeLabel.d.ts

@@ -7,6 +7,7 @@
  *
  * @param label - Raw knowledge label or source value.
  * @returns Display-friendly chip label.
+ *
  * @private utility of knowledge/source chip rendering
  */
 export declare function simplifyKnowledgeLabel(label: string): string;
@@ -15,6 +16,7 @@ export declare function simplifyKnowledgeLabel(label: string): string;
  *
  * @param text - Candidate value (typically a filename segment).
  * @returns `'HUMAN'`, `'ID'`, or `'UNKNOWN'`.
+ *
  * @private utility of knowledge/source chip rendering
  */
 export declare function isHumanOrID(text: string): 'HUMAN' | 'ID' | 'UNKNOWN';

package/umd/src/utils/linguistic-hash/linguisticHash.d.ts

@@ -5,8 +5,9 @@ export { DEFAULT_LINGUISTIC_HASH_WORD_COUNT, MAX_LINGUISTIC_HASH_WORD_COUNT, MIN
 /**
  * Creates a human-readable hash as a short, story-like phrase.
  *
- * @param wordCount how many words to include (defaults to {@link DEFAULT_LINGUISTIC_HASH_WORD_COUNT}, clamped to
  * {@link MIN_LINGUISTIC_HASH_WORD_COUNT}..{@link MAX_LINGUISTIC_HASH_WORD_COUNT})
+ *
+ * @param wordCount how many words to include (defaults to {@link DEFAULT_LINGUISTIC_HASH_WORD_COUNT}, clamped to
  * @param language optional language code (defaults to {@link DEFAULT_LINGUISTIC_HASH_LANGUAGE})
  *
  * @public exported from `@promptbook/utils`

package/umd/src/utils/linguistic-hash/linguisticHashTypes.d.ts

@@ -14,6 +14,3 @@ export type LinguisticHashWordLists = {
     noun: readonly string[];
     verb: readonly string[];
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/linguistic-hash/linguisticHashWords.cs.d.ts

@@ -5,6 +5,3 @@ import type { LinguisticHashWordLists } from './linguisticHashTypes';
  * @private utility of `linguisticHash`
  */
 export declare const LINGUISTIC_HASH_WORD_LISTS_CS: LinguisticHashWordLists;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/linguistic-hash/linguisticHashWords.en.d.ts

@@ -5,6 +5,3 @@ import type { LinguisticHashWordLists } from './linguisticHashTypes';
  * @private utility of `linguisticHash`
  */
 export declare const LINGUISTIC_HASH_WORD_LISTS_EN: LinguisticHashWordLists;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

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

@@ -9,6 +9,3 @@ export declare function addAutoGeneratedSection(content: string_markdown, option
     readonly sectionName: string_name;
     readonly sectionContent: string_markdown;
 }): string_markdown;
-/**
- * TODO: [🏛] This can be part of markdown builder
- */

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

@@ -6,6 +6,3 @@ import type { string_markdown_text } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function createMarkdownTable(table: Array<Array<string_markdown_text>>): string_markdown;
-/**
- * TODO: [🏛] This can be part of markdown builder
- */

package/umd/src/utils/markdown/escapeMarkdownBlock.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown_text } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function escapeMarkdownBlock(value: string_markdown_text): string_markdown_text;
-/**
- * TODO: [🏛] This can be part of markdown builder
- */

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

@@ -28,9 +28,7 @@ export type MarkdownCodeBlock = {
  * @param markdown any valid markdown
  * @returns code blocks with language and content
  * @throws {ParseError} if block is not closed properly
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function extractAllBlocksFromMarkdown(markdown: string_markdown): ReadonlyArray<MarkdownCodeBlock>;
-/**
- * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
- */

package/umd/src/utils/markdown/extractAllListItemsFromMarkdown.d.ts

@@ -9,6 +9,7 @@ import type { string_markdown, string_markdown_text } from '../../types/typeAlia
  *
  * @param markdown any valid markdown
  * @returns An array of strings, each representing an individual list item found in the markdown
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function extractAllListItemsFromMarkdown(markdown: string_markdown): string_markdown_text[];

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

@@ -13,10 +13,8 @@ import type { MarkdownCodeBlock } from './extractAllBlocksFromMarkdown';
  *
  * @param markdown any valid markdown
  * @returns code block with language and content
- * @public exported from `@promptbook/markdown-utils`
  * @throws {ParseError} if there is not exactly one code block in the markdown
+ *
+ * @public exported from `@promptbook/markdown-utils`
  */
 export declare function extractOneBlockFromMarkdown(markdown: string_markdown): MarkdownCodeBlock;
-/***
- * TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
- */

package/umd/src/utils/markdown/humanizeAiText.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiText(aiText: string_markdown): string_markdown;
-/**
- * TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
- */

package/umd/src/utils/markdown/humanizeAiTextEllipsis.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiTextEllipsis(aiText: string_markdown): string_markdown;
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */

package/umd/src/utils/markdown/humanizeAiTextEmdashed.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiTextEmdashed(aiText: string_markdown): string_markdown;
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */

package/umd/src/utils/markdown/humanizeAiTextQuotes.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiTextQuotes(aiText: string_markdown): string_markdown;
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */

package/umd/src/utils/markdown/humanizeAiTextSources.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiTextSources(aiText: string_markdown): string_markdown;
-/**
- * Note: [??] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */

package/umd/src/utils/markdown/humanizeAiTextWhitespace.d.ts

@@ -8,6 +8,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function humanizeAiTextWhitespace(aiText: string_markdown): string_markdown;
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */

package/umd/src/utils/markdown/prettifyMarkdown.d.ts

@@ -4,8 +4,9 @@ import type { string_html } from '../../types/typeAliases';
  *
  * @param content raw html code
  * @returns formatted html code
- * @private withing the package because of HUGE size of prettier dependency
  * @deprecated Prettier removed from Promptbook due to package size
+ *
+ * @private withing the package because of HUGE size of prettier dependency
  */
 export declare function prettifyMarkdown<TContent extends string_html>(content: TContent): TContent;
 /**
@@ -13,7 +14,8 @@ export declare function prettifyMarkdown<TContent extends string_html>(content:
  *
  * @param content raw html code
  * @returns formatted html code
- * @private withing the package because of HUGE size of prettier dependency
  * @deprecated Prettier removed from Promptbook due to package size
+ *
+ * @private withing the package because of HUGE size of prettier dependency
  */
 export declare function prettifyMarkdownAsync<TContent extends string_html>(content: TContent): Promise<TContent>;

package/umd/src/utils/markdown/promptbookifyAiText.d.ts

@@ -7,6 +7,3 @@ import type { string_markdown } from '../../types/typeAliases';
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function promptbookifyAiText(text: string_markdown): string_markdown;
-/**
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */

package/umd/src/utils/markdown/removeMarkdownComments.d.ts

@@ -5,6 +5,7 @@ import type { string_markdown } from '../../types/typeAliases';
  *
  * @param {string} content - The string to remove comments from.
  * @returns {string} The input string with all comments removed.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function removeMarkdownComments<TContent extends string_html | string_markdown>(content: TContent): TContent;

package/umd/src/utils/markdown/removeMarkdownFormatting.d.ts

@@ -4,6 +4,7 @@ import type { string_markdown_text } from '../../types/typeAliases';
  *
  * @param {string} str - The string to remove Markdown tags from.
  * @returns {string} The input string with all Markdown tags removed.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function removeMarkdownFormatting(str: string_markdown_text): string;

package/umd/src/utils/markdown/removeMarkdownLinks.d.ts

@@ -3,6 +3,7 @@
  *
  * @param {string} str - The string to remove Markdown tags from.
  * @returns {string} The input string with all Markdown tags removed.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function removeMarkdownLinks(str: string): string;

package/umd/src/utils/markdown/trimCodeBlock.d.ts

@@ -3,7 +3,7 @@
  *
  * Note: [🔂] This function is idempotent.
  * Note: This is useful for post-processing of the result of the chat LLM model
- *       when the model wraps the result in the (markdown) code block.
+ * when the model wraps the result in the (markdown) code block.
  *
  * @public exported from `@promptbook/markdown-utils`
  */

package/umd/src/utils/markdown/trimEndOfCodeBlock.d.ts

@@ -2,7 +2,7 @@
  * Function trimEndOfCodeBlock will remove ending code block from the string if it is present.
  *
  * Note: This is useful for post-processing of the result of the completion LLM model
- *       if you want to start code block in the prompt but you don't want to end it in the result.
+ * if you want to start code block in the prompt but you don't want to end it in the result.
  *
  * @public exported from `@promptbook/markdown-utils`
  */

package/umd/src/utils/misc/$getCurrentDate.d.ts

@@ -5,6 +5,7 @@ import type { string_date_iso8601 } from '../../types/typeAliases';
  * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
  *
  * @returns string_date branded type
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function $getCurrentDate(): string_date_iso8601;

package/umd/src/utils/misc/aboutPromptbookInformation.d.ts

@@ -1,4 +1,7 @@
 import type { string_markdown } from '../../types/typeAliases';
+/**
+ * Options for about promptbook information.
+ */
 export type AboutPromptbookInformationOptions = {
     /**
      * Include information about available servers
@@ -22,6 +25,3 @@ export type AboutPromptbookInformationOptions = {
  * @public exported from `@promptbook/core`
  */
 export declare function aboutPromptbookInformation(options?: AboutPromptbookInformationOptions): string_markdown;
-/**
- * TODO: [🗽] Unite branding and make single place for it
- */

package/umd/src/utils/misc/computeHash.d.ts

@@ -6,6 +6,3 @@ import { really_unknown } from '../organization/really_unknown';
  * @public exported from `@promptbook/utils`
  */
 export declare function computeHash(value: really_unknown): string_sha256;
-/**
- * TODO: [🥬][🥬] Use this ACRY
- */

package/umd/src/utils/misc/debounce.d.ts

@@ -1,5 +1,7 @@
 import type { TODO_any } from '../organization/TODO_any';
 /**
+ * Handles debounce.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;

package/umd/src/utils/misc/emojis.d.ts

@@ -4,21 +4,16 @@ import type { string_char_emoji } from '../../types/typeAliasEmoji';
  * Note: this will be needed to update annually - now updated at 2022-01-19
  *
  * @see https://getemoji.com/
+ * @deprecated Use /\p{Extended_Pictographic}/ instead
  *
  * @private within the repository
- * @deprecated Use /\p{Extended_Pictographic}/ instead
  */
 export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
 /**
- *
  * All possible emoji chars like "🍆", "🍡", "🍤"...
  *
- * @private within the repository
  * @deprecated Use /\p{Extended_Pictographic}/ instead
+ *
+ * @private within the repository
  */
 export declare const EMOJIS: Set<string_char_emoji>;
-/**
- * TODO: [💴] DRY - just one version of emojis.ts
- * TODO: Mirror from Collboard or some common package
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/utils/misc/injectCssModuleIntoShadowRoot.d.ts

@@ -1,4 +1,7 @@
 import type { string_css_class } from '../../types/typeAliases';
+/**
+ * Options for inject Css module into shadow root.
+ */
 export type InjectCssModuleIntoShadowRootOptions = {
     /**
      * The shadow root where the styles should be injected
@@ -14,8 +17,10 @@ export type InjectCssModuleIntoShadowRootOptions = {
  * This allows CSS modules (which are normally emitted into the document head) to be
  * available inside the component's shadow DOM.
  *
- * @public exported from `@promptbook/components`
- *         <- TODO: [🧠] Make `@promptbook/components-utils`
+ * TODO: [🧠] Make `@promptbook/components-utils`
+ *
  * @deprecated This was used for BookEditor shadow DOM support, which is no longer needed
+ *
+ * @public exported from `@promptbook/components`
  */
 export declare function injectCssModuleIntoShadowRoot(options: InjectCssModuleIntoShadowRootOptions): void;

package/umd/src/utils/misc/parseNumber.d.ts

@@ -11,7 +11,3 @@
  * @public exported from `@promptbook/utils`
  */
 export declare function parseNumber(value: string | number | null | undefined): number;
-/**
- * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
- * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
- */

package/umd/src/utils/misc/xAboutPromptbookInformation.d.ts

@@ -1,4 +1,7 @@
 import type { AboutPromptbookInformationOptions } from './aboutPromptbookInformation';
+/**
+ * Props for about promptbook information.
+ */
 type AboutPromptbookInformationProps = AboutPromptbookInformationOptions;
 /**
  * Provide information about Promptbook, engine version, book language version, servers, ...
@@ -7,7 +10,3 @@ type AboutPromptbookInformationProps = AboutPromptbookInformationOptions;
  */
 export declare function AboutPromptbookInformation(props: AboutPromptbookInformationProps): import("react/jsx-runtime").JSX.Element;
 export {};
-/**
- * TODO: !!! Remove "x" from filename
- * TODO: [🗽] Unite branding and make single place for it
- */

package/umd/src/utils/normalization/IKeywords.d.ts

@@ -16,6 +16,3 @@ export type string_keyword = string;
  * @public exported from `@promptbook/utils`
  */
 export type Keywords = Set<string_keyword>;
-/**
- * TODO: [🌮] Keywords with weight
- */

package/umd/src/utils/normalization/nameToUriPart.d.ts

@@ -4,6 +4,7 @@
  * @param name The string to be converted to a URI-compatible format.
  * @returns A URI-compatible string derived from the input name.
  * @example 'Hello World' -> 'hello-world'
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function nameToUriPart(name: string): string;

package/umd/src/utils/normalization/nameToUriParts.d.ts

@@ -4,6 +4,7 @@
  * @param name The name to be converted into URI parts.
  * @returns An array of URI-compatible parts derived from the name.
  * @example 'Example Name' -> ['example', 'name']
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function nameToUriParts(name: string): string[];