@promptbook/javascript 0.112.0-35 → 0.112.0-38

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -2,6 +2,7 @@ import type { CSSProperties, ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
 import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
+import type { string_href } from '../../../types/typeAliases';
 import { string_color } from '../../../types/typeAliases';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
@@ -124,6 +125,26 @@ export type ChatUiTranslations = {
      * @default "Write a message..."
      */
     readonly inputPlaceholder?: string;
+    /**
+     * Label shown above quoted reply previews in both composer and reply bubbles.
+     * @default "Replying to"
+     */
+    readonly replyingToLabel?: string;
+    /**
+     * Visible label for the explicit reply action on one message.
+     * @default "Reply"
+     */
+    readonly replyActionLabel?: string;
+    /**
+     * Accessible title for the explicit reply action on one message.
+     * @default "Reply to this message"
+     */
+    readonly replyActionTitle?: string;
+    /**
+     * Accessible label for the composer button that cancels reply mode.
+     * @default "Cancel reply"
+     */
+    readonly cancelReplyLabel?: string;
     /**
      * Label for the "Save" button in the chat actions bar.
      * @default "Save"
@@ -433,7 +454,11 @@ export type ChatProps = {
      * - When set, the send textarea and button will be shown
      * - When undefined, the chat has no input and is read-only showing only the messages
      */
-    onMessage?(messageContent: string): Promisable<void>;
+    onMessage?(messageContent: string, attachments?: Array<{
+        name: string;
+        type: string;
+        url: string;
+    }>, replyingToMessage?: ChatMessage | null): Promisable<void>;
     /**
      * Called when user clicks a quick action button parsed from message markdown.
      *
@@ -447,6 +472,22 @@ export type ChatProps = {
      * When not provided, quick message buttons fall back to `onMessage`.
      */
     onQuickMessageButton?(messageContent: string): Promisable<void>;
+    /**
+     * Optional callback fired when the user starts replying to one existing message.
+     */
+    onReplyToMessage?(message: ChatMessage): void;
+    /**
+     * Optional callback fired when the user cancels the currently composed reply.
+     */
+    onCancelReply?(): void;
+    /**
+     * Optional callback that determines whether one message can be replied to.
+     */
+    canReplyToMessage?(message: ChatMessage): boolean;
+    /**
+     * Optional message currently being quoted by the composer.
+     */
+    readonly replyingToMessage?: ChatMessage | null;
     /**
      * Optional callback
      *
@@ -460,6 +501,14 @@ export type ChatProps = {
      * @default true
      */
     readonly resetRequiresConfirmation?: boolean;
+    /**
+     * Optional navigation target for the action-bar "New chat" control.
+     *
+     * When provided, the control is rendered as a plain link instead of invoking `onReset`.
+     * This allows host applications to rely on browser-native navigation affordances such as
+     * right-click "Open in new tab/window".
+     */
+    readonly newChatButtonHref?: string_href;
     /**
      * Determines whether the voice recognition button is rendered
      */

package/umd/src/book-components/Chat/Chat/ChatReplyPreview.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Props for one faded quoted-message preview rendered inside the chat UI.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatReplyPreviewProps = {
+    readonly label: string;
+    readonly senderLabel: string;
+    readonly previewText: string;
+    readonly className?: string;
+    readonly dismissLabel?: string;
+    readonly onDismiss?: () => void;
+};
+/**
+ * Renders the common faded preview used for reply bubbles and composer reply mode.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatReplyPreview(props: ChatReplyPreviewProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/Chat/Chat/createProgressCardChecklistMarkdown.d.ts

@@ -1,9 +1,9 @@
 import type { ChatMessage } from '../types/ChatMessage';
 /**
- * Converts one structured progress card payload into markdown checklist content.
+ * Converts one structured progress card payload into markdown content.
  *
  * @param progressCard Structured progress card payload.
- * @returns Markdown checklist rendered through the normal message markdown pipeline.
+ * @returns Markdown rendered through the normal message markdown pipeline.
  *
  * @private internal helper of `<ChatMessageItem/>`
  */

package/umd/src/book-components/Chat/MockedChat/MockedChat.d.ts

@@ -53,7 +53,7 @@ export type MockedChatDelayConfig = {
  *
  * @public exported from `@promptbook/components`
  */
-export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
+export type MockedChatProps = Omit<ChatProps, 'onReset' | 'newChatButtonHref' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
     /**
      * Whether the chat can be reset via the "New chat" button.
      *

package/umd/src/book-components/Chat/types/ChatMessage.d.ts

@@ -58,6 +58,37 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
+/**
+ * Serialized reference to an earlier chat message quoted by a reply bubble.
+ *
+ * Stores the durable relationship (`threadId` + `messageId`) together with a
+ * lightweight snapshot of the original message so UIs and prompt builders can
+ * render reply context without performing extra fetches.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatMessageReplyingTo = {
+    /**
+     * Durable chat thread identifier that owns the replied-to message.
+     */
+    readonly threadId: string;
+    /**
+     * Durable identifier of the specific replied-to message inside the thread.
+     */
+    readonly messageId: string;
+    /**
+     * Sender of the original replied-to message.
+     */
+    readonly sender: string;
+    /**
+     * Original markdown content of the replied-to message.
+     */
+    readonly content: string_markdown;
+    /**
+     * Optional list of attachment names from the replied-to message.
+     */
+    readonly attachmentNames?: ReadonlyArray<string>;
+};
 /**
  * Serializable prompt snapshot stored alongside one assistant message for debugging and inspection.
  */
@@ -243,5 +274,9 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      * resolved parameters, tool availability, and provider payload associated with one turn.
      */
     readonly prompt?: ChatMessagePrompt;
+    /**
+     * Optional metadata describing which earlier message this one replies to.
+     */
+    readonly replyingTo?: ChatMessageReplyingTo;
 };
 export {};

package/umd/src/book-components/Chat/utils/resolveChatMessageReplyPreviewText.d.ts

@@ -0,0 +1,25 @@
+import type { ChatMessage, ChatMessageReplyingTo } from '../types/ChatMessage';
+/**
+ * Lightweight message-like shape accepted by reply-preview text helpers.
+ *
+ * @private helper contract for chat reply previews
+ */
+type ChatMessageReplyPreviewSource = Pick<ChatMessage, 'content' | 'attachments'> & {
+    readonly attachmentNames?: ChatMessageReplyingTo['attachmentNames'];
+};
+/**
+ * Optional settings for reply-preview text generation.
+ *
+ * @private helper contract for chat reply previews
+ */
+type ResolveChatMessageReplyPreviewTextOptions = {
+    readonly maxLength?: number;
+    readonly emptyLabel?: string;
+};
+/**
+ * Resolves one compact plain-text preview for reply UI surfaces and prompt context.
+ *
+ * @private helper for chat reply previews
+ */
+export declare function resolveChatMessageReplyPreviewText(source: ChatMessageReplyPreviewSource, options?: ResolveChatMessageReplyPreviewTextOptions): string;
+export {};

package/umd/src/book-components/Chat/utils/resolveChatMessageReplySenderLabel.d.ts

@@ -0,0 +1,12 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Resolves the human-readable sender label shown in reply previews.
+ *
+ * @private helper for chat reply previews
+ */
+export declare function resolveChatMessageReplySenderLabel(options: {
+    sender: ChatMessage['sender'];
+    participants?: ReadonlyArray<ChatParticipant>;
+    fallbackLabel?: string;
+}): string;

package/umd/src/cli/cli-commands/coder/agentCodingFile.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
+/**
+ * Returns the default coder `AGENT_CODING.md` quick-reference content.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getDefaultCoderAgentCodingFileContent({ packageJsonScripts, }: {
+    readonly packageJsonScripts: Readonly<Record<string, string>>;
+}): string;

package/umd/src/cli/cli-commands/coder/agentsFile.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Relative path to the shared coder context file initialized in project roots.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const AGENTS_FILE_PATH = "AGENTS.md";
+/**
+ * Returns the default coder `AGENTS.md` boilerplate instructions.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getDefaultCoderAgentsFileContent(): string;

package/umd/src/cli/cli-commands/coder/appendBlock.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Appends one text block to existing file content while preserving readable newlines.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function appendBlock(currentContent: string, blockToAppend: string): string;

package/umd/src/cli/cli-commands/coder/boilerplateTemplates.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Relative path to the root prompts directory used by Promptbook coder utilities.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const PROMPTS_DIRECTORY_PATH = "prompts";
+/**
+ * Relative path to the archive directory used by `coder verify`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const PROMPTS_DONE_DIRECTORY_PATH: string;
+/**
+ * Relative path to the project-owned boilerplate templates directory.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const PROMPTS_TEMPLATES_DIRECTORY_PATH: string;
+/**
+ * Initialization statuses used when creating or updating coder configuration artifacts.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type InitializationStatus = 'created' | 'updated' | 'unchanged';
+/**
+ * Identifiers of built-in coder boilerplate templates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type BuiltInCoderPromptTemplate = 'common' | 'agents-server';
+/**
+ * One built-in coder boilerplate template definition.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type CoderPromptTemplateDefinition = {
+    /**
+     * Stable built-in identifier that can also be used as a CLI shorthand.
+     */
+    readonly id: BuiltInCoderPromptTemplate;
+    /**
+     * Project-relative path where `ptbk coder init` materializes the template file.
+     */
+    readonly relativeFilePath: string;
+    /**
+     * Prefix inserted into generated prompt file slugs.
+     */
+    readonly slugPrefix: string | null;
+    /**
+     * Markdown content of the template.
+     */
+    readonly content: string;
+    /**
+     * Whether `ptbk coder init` should materialize this template into project-owned files.
+     */
+    readonly isDefaultProjectTemplate: boolean;
+};
+/**
+ * Result of ensuring one default coder template file exists inside a project.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type EnsuredCoderPromptTemplateFile = {
+    /**
+     * Stable built-in identifier of the template.
+     */
+    readonly id: BuiltInCoderPromptTemplate;
+    /**
+     * Project-relative path of the materialized template file.
+     */
+    readonly relativeFilePath: string;
+    /**
+     * Status describing whether the file had to be created.
+     */
+    readonly status: InitializationStatus;
+};
+/**
+ * Fully resolved boilerplate template used by `coder generate-boilerplates`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type ResolvedCoderPromptTemplate = {
+    /**
+     * Identifier or relative file path that was resolved.
+     */
+    readonly identifier: string;
+    /**
+     * Project-relative path when the template corresponds to a project file.
+     */
+    readonly relativeFilePath?: string;
+    /**
+     * Markdown content of the resolved template.
+     */
+    readonly content: string;
+    /**
+     * Prefix inserted into generated prompt file slugs.
+     */
+    readonly slugPrefix: string | null;
+};
+/**
+ * Lists the built-in coder boilerplate templates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getDefaultCoderPromptTemplateDefinitions(): ReadonlyArray<CoderPromptTemplateDefinition>;
+/**
+ * Lists the built-in coder prompt templates that are safe to initialize in any project.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getDefaultCoderProjectPromptTemplateDefinitions(): ReadonlyArray<CoderPromptTemplateDefinition>;
+/**
+ * Resolves one built-in coder boilerplate template definition by its stable identifier.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getDefaultCoderPromptTemplateDefinition(template: BuiltInCoderPromptTemplate): CoderPromptTemplateDefinition;
+/**
+ * Ensures the default project-owned coder template files exist without overwriting user customizations.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function ensureDefaultCoderPromptTemplateFiles(projectPath: string): Promise<ReadonlyArray<EnsuredCoderPromptTemplateFile>>;
+/**
+ * Resolves the template requested by `coder generate-boilerplates`.
+ *
+ * Supports three modes:
+ * - omitted option => built-in `common`
+ * - built-in alias => one of the shared default templates
+ * - relative path => markdown template file resolved from the project root
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function resolveCoderPromptTemplate({ projectPath, templateOption, }: {
+    readonly projectPath: string;
+    readonly templateOption?: string;
+}): Promise<ResolvedCoderPromptTemplate>;

package/umd/src/cli/cli-commands/coder/boilerplateTemplates.test.d.ts

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

package/umd/src/cli/cli-commands/coder/ensureCoderEnvFile.d.ts

@@ -0,0 +1,15 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Result of ensuring coder environment variables inside `.env`.
+ */
+type EnsureCoderEnvFileResult = {
+    readonly envFileStatus: InitializationStatus;
+    readonly initializedEnvVariableNames: ReadonlyArray<string>;
+};
+/**
+ * Ensures `.env` exists and contains all required coder environment variables.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderEnvFile(projectPath: string): Promise<EnsureCoderEnvFileResult>;
+export {};

package/umd/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -0,0 +1,7 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Ensures `.gitignore` contains the standalone Promptbook coder cache entry.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderGitignoreFile(projectPath: string): Promise<InitializationStatus>;

package/umd/src/cli/cli-commands/coder/ensureCoderMarkdownFile.d.ts

@@ -0,0 +1,7 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Ensures one coder markdown file exists with the provided default boilerplate.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderMarkdownFile(projectPath: string, relativeFilePath: string, fileContent: string): Promise<InitializationStatus>;

package/umd/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.d.ts

@@ -0,0 +1,7 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Ensures `package.json` contains the standalone Promptbook coder helper scripts.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderPackageJsonFile(projectPath: string): Promise<InitializationStatus>;

package/umd/src/cli/cli-commands/coder/ensureCoderVscodeSettingsFile.d.ts

@@ -0,0 +1,7 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Ensures VS Code routes pasted prompt images into `prompts/screenshots`.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderVscodeSettingsFile(projectPath: string): Promise<InitializationStatus>;

package/umd/src/cli/cli-commands/coder/ensureDirectory.d.ts

@@ -0,0 +1,7 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Ensures a relative directory exists in the project root.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureDirectory(projectPath: string, relativeDirectoryPath: string): Promise<InitializationStatus>;

package/umd/src/cli/cli-commands/coder/find-refactor-candidates.d.ts

@@ -1,4 +1,4 @@
-import type { Command as Program } from 'commander';
+import { Command as Program } from 'commander';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
 /**
  * Initializes `coder find-refactor-candidates` command for Promptbook CLI utilities

package/umd/src/cli/cli-commands/coder/find-refactor-candidates.test.d.ts

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

package/umd/src/cli/cli-commands/coder/formatDisplayPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Normalizes one project-relative path for human-readable CLI output and markdown.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function formatDisplayPath(relativePath: string): string;

package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts

@@ -8,3 +8,13 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderGenerateBoilerplatesCommand(program: Program): $side_effect;
+/**
+ * Generates boilerplate prompt files with unique emoji tags.
+ *
+ * @private internal function of `generatePromptBoilerplate` command
+ */
+export declare function generatePromptBoilerplate({ projectPath, filesCount, templateOption, }: {
+    readonly projectPath: string;
+    readonly filesCount: number;
+    readonly templateOption?: string;
+}): Promise<void>;

package/umd/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lists the default npm scripts initialized by `ptbk coder init`.
+ *
+ * @private internal utility of `coder init` command
+ */
+export declare function getDefaultCoderPackageJsonScripts(): Readonly<Record<string, string>>;

package/umd/src/cli/cli-commands/coder/getDefaultCoderVscodeSettings.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lists the default VS Code settings initialized by `ptbk coder init`.
+ *
+ * @private internal utility of `coder init` command
+ */
+export declare function getDefaultCoderVscodeSettings(): Readonly<Record<string, Readonly<Record<string, string>>>>;

package/umd/src/cli/cli-commands/coder/init.d.ts

@@ -1,5 +1,8 @@
 import type { Command as Program } from 'commander';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+export { getDefaultCoderPackageJsonScripts } from './getDefaultCoderPackageJsonScripts';
+export { getDefaultCoderVscodeSettings } from './getDefaultCoderVscodeSettings';
+export { initializeCoderProjectConfiguration } from './initializeCoderProjectConfiguration';
 /**
  * Initializes `coder init` command for Promptbook CLI utilities.
  *

package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts

@@ -0,0 +1,25 @@
+import { type EnsuredCoderPromptTemplateFile, type InitializationStatus } from './boilerplateTemplates';
+/**
+ * Result summary returned after coder configuration initialization.
+ *
+ * @private internal utility of `coder init` command
+ */
+export type CoderInitializationSummary = {
+    readonly promptsDirectoryStatus: InitializationStatus;
+    readonly promptsDoneDirectoryStatus: InitializationStatus;
+    readonly promptsTemplatesDirectoryStatus: InitializationStatus;
+    readonly promptTemplateFileStatuses: ReadonlyArray<EnsuredCoderPromptTemplateFile>;
+    readonly agentsFileStatus: InitializationStatus;
+    readonly agentCodingFileStatus: InitializationStatus;
+    readonly envFileStatus: InitializationStatus;
+    readonly gitignoreFileStatus: InitializationStatus;
+    readonly packageJsonFileStatus: InitializationStatus;
+    readonly vscodeSettingsFileStatus: InitializationStatus;
+    readonly initializedEnvVariableNames: ReadonlyArray<string>;
+};
+/**
+ * Creates or updates all coder configuration artifacts required in the current project.
+ *
+ * @private internal utility of `coder init` command
+ */
+export declare function initializeCoderProjectConfiguration(projectPath: string): Promise<CoderInitializationSummary>;

package/umd/src/cli/cli-commands/coder/mergeStringRecordJsonFile.d.ts

@@ -0,0 +1,18 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Parameters controlling one string-record merge into a JSON file.
+ */
+type MergeStringRecordJsonFileOptions = {
+    readonly projectPath: string;
+    readonly relativeFilePath: string;
+    readonly fieldPath: string;
+    readonly nextEntries: Readonly<Record<string, string>>;
+    readonly ensureParentDirectoryPath?: string;
+};
+/**
+ * Ensures one JSON object field contains the provided string-record entries.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function mergeStringRecordJsonFile({ projectPath, relativeFilePath, fieldPath, nextEntries, ensureParentDirectoryPath, }: MergeStringRecordJsonFileOptions): Promise<InitializationStatus>;
+export {};

package/umd/src/cli/cli-commands/coder/printInitializationSummary.d.ts

@@ -0,0 +1,7 @@
+import type { CoderInitializationSummary } from './initializeCoderProjectConfiguration';
+/**
+ * Prints a readable summary of what was initialized for the user.
+ *
+ * @private function of `coder init` command
+ */
+export declare function printInitializationSummary(summary: CoderInitializationSummary): void;

package/umd/src/cli/cli-commands/coder/readTextFileIfExists.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads one text file when it exists, otherwise returns `undefined`.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function readTextFileIfExists(path: string): Promise<string | undefined>;

package/umd/src/types/string_agent_url.d.ts

@@ -0,0 +1,7 @@
+import type { string_agent_url_private } from './string_agent_url_private';
+/**
+ * Semantic helper
+ *
+ * For example `"https://s6.ptbk.io/agents/agent-007"`
+ */
+export type string_agent_url = string_agent_url_private;

package/umd/src/types/string_agent_url_private.d.ts

@@ -0,0 +1,9 @@
+import type { string_url_private } from './string_url_private';
+/**
+ * Semantic helper
+ *
+ * For example `"https://s6.ptbk.io/agents/agent-007"`
+ *
+ * @private internal utility of `string_agent_url.ts`
+ */
+export type string_agent_url_private = string_url_private;

package/umd/src/types/string_base64.d.ts

@@ -0,0 +1,13 @@
+import type { string_base64_private, string_data_url_private } from './string_base64_private';
+/**
+ * Semantic helper
+ *
+ * For example `"SGVsbG8sIFdvcmxkIQ=="`
+ */
+export type string_base64 = string_base64_private;
+/**
+ * Semantic helper
+ *
+ * For example `"data:text/plain;base64,SGVsbG8sIFdvcmxkIQ=="`
+ */
+export type string_data_url = string_data_url_private;

package/umd/src/types/string_base64_private.d.ts

@@ -4,7 +4,7 @@ import type { string_mime_type_private } from './string_mime_type_private';
  *
  * For example `"SGVsbG8sIFdvcmxkIQ=="`
  *
- * @private internal utility of `string_url.ts`
+ * @private internal utility of `string_base64.ts`
  */
 export type string_base64_private = string;
 /**
@@ -12,6 +12,6 @@ export type string_base64_private = string;
  *
  * For example `"data:text/plain;base64,SGVsbG8sIFdvcmxkIQ=="`
  *
- * @private internal utility of `string_url.ts`
+ * @private internal utility of `string_base64.ts`
  */
 export type string_data_url_private = `data:${string_mime_type_private};base64,${string_base64_private}`;

package/umd/src/types/string_base_url.d.ts

@@ -0,0 +1,7 @@
+import type { string_base_url_private } from './string_base_url_private';
+/**
+ * Semantic helper
+ *
+ * For example `"https://collboard.com"`
+ */
+export type string_base_url = string_base_url_private;

package/umd/src/types/string_base_url_private.d.ts

@@ -0,0 +1,9 @@
+import type { string_url_private } from './string_url_private';
+/**
+ * Semantic helper
+ *
+ * For example `"https://collboard.com"`
+ *
+ * @private internal utility of `string_base_url.ts`
+ */
+export type string_base_url_private = string_url_private;