@promptbook/wizard 0.102.0-1 → 0.102.0-3

package/esm/index.es.js

@@ -36,7 +36,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.102.0-1';
+const PROMPTBOOK_ENGINE_VERSION = '0.102.0-3';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/_packages/components.index.d.ts

@@ -26,14 +26,14 @@ import { MOCKED_CHAT_DELAY_CONFIGS } from '../book-components/Chat/MockedChat/co
 import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/MockedChat';
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
 import { MockedChat } from '../book-components/Chat/MockedChat/MockedChat';
-import type { string_chat_format_name } from '../book-components/Chat/save/savePlugins';
-import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { jsonSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { txtSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { mdSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { htmlSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { CHAT_SAVE_FORMATS } from '../book-components/Chat/save/savePlugins';
-import { getChatSaveFormatDefinitions } from '../book-components/Chat/save/savePlugins';
+import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
+import { getChatSaveFormatDefinitions } from '../book-components/Chat/save/_common/getChatSaveFormatDefinitions';
+import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
+import { htmlSaveFormatDefinition } from '../book-components/Chat/save/html/htmlSaveFormatDefinition';
+import { CHAT_SAVE_FORMATS } from '../book-components/Chat/save/index';
+import { jsonSaveFormatDefinition } from '../book-components/Chat/save/json/jsonSaveFormatDefinition';
+import { mdSaveFormatDefinition } from '../book-components/Chat/save/markdown/mdSaveFormatDefinition';
+import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -41,6 +41,8 @@ import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageB
 import { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
 import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
+import { AttachmentIcon } from '../book-components/icons/AttachmentIcon';
+import { CloseIcon } from '../book-components/icons/CloseIcon';
 import { PauseIcon } from '../book-components/icons/PauseIcon';
 import { PlayIcon } from '../book-components/icons/PlayIcon';
 import { ResetIcon } from '../book-components/icons/ResetIcon';
@@ -74,14 +76,14 @@ export { MOCKED_CHAT_DELAY_CONFIGS };
 export type { MockedChatDelayConfig };
 export type { MockedChatProps };
 export { MockedChat };
-export type { string_chat_format_name };
 export type { ChatSaveFormatDefinition };
-export { jsonSaveFormatDefinition };
-export { txtSaveFormatDefinition };
-export { mdSaveFormatDefinition };
+export { getChatSaveFormatDefinitions };
+export type { string_chat_format_name };
 export { htmlSaveFormatDefinition };
 export { CHAT_SAVE_FORMATS };
-export { getChatSaveFormatDefinitions };
+export { jsonSaveFormatDefinition };
+export { mdSaveFormatDefinition };
+export { txtSaveFormatDefinition };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
@@ -89,6 +91,8 @@ export { parseMessageButtons };
 export { renderMarkdown };
 export { isMarkdownContent };
 export { ArrowIcon };
+export { AttachmentIcon };
+export { CloseIcon };
 export { PauseIcon };
 export { PlayIcon };
 export { ResetIcon };

package/esm/typings/src/_packages/types.index.d.ts

@@ -16,8 +16,8 @@ import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/MockedChat';
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
-import type { string_chat_format_name } from '../book-components/Chat/save/savePlugins';
-import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
+import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
+import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -154,6 +154,7 @@ import type { ApplicationRemoteServerOptions } from '../remote-server/types/Remo
 import type { ApplicationRemoteServerClientOptions } from '../remote-server/types/RemoteServerOptions';
 import type { LoginRequest } from '../remote-server/types/RemoteServerOptions';
 import type { LoginResponse } from '../remote-server/types/RemoteServerOptions';
+import type { ServerInfo } from '../remote-server/ui/types';
 import type { Converter } from '../scrapers/_common/Converter';
 import type { ScraperAndConverterMetadata } from '../scrapers/_common/register/ScraperAndConverterMetadata';
 import type { ScraperConstructor } from '../scrapers/_common/register/ScraperConstructor';
@@ -347,8 +348,8 @@ export type { SendMessageToLlmChatFunction };
 export type { LlmChatProps };
 export type { MockedChatDelayConfig };
 export type { MockedChatProps };
-export type { string_chat_format_name };
 export type { ChatSaveFormatDefinition };
+export type { string_chat_format_name };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
@@ -485,6 +486,7 @@ export type { ApplicationRemoteServerOptions };
 export type { ApplicationRemoteServerClientOptions };
 export type { LoginRequest };
 export type { LoginResponse };
+export type { ServerInfo };
 export type { Converter };
 export type { ScraperAndConverterMetadata };
 export type { ScraperConstructor };

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.delete.test.d.ts

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

package/esm/typings/src/book-components/Chat/Chat/Chat.d.ts

@@ -1,4 +1,4 @@
-import { string_chat_format_name } from '../save/savePlugins';
+import { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatProps } from './ChatProps';
 /**
  * Renders a chat with messages and input for new messages

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -145,7 +145,16 @@ export type ChatProps = {
         expectedAnswer: string | null;
         url: string;
     }): Promisable<void>;
+    /**
+     * Optional callback for handling file uploads
+     * When provided, enables file upload functionality via drag-and-drop and file button
+     * The callback should process the file and return text content to be inserted into the message
+     *
+     * @param file - The uploaded file
+     * @returns Promise or string with the text content to insert into the chat message
+     */
+    onFileUpload?(file: File): Promisable<string>;
 };
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */ 
+ */

package/esm/typings/src/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -1,8 +1,9 @@
 import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
+import { id } from '../../../types/typeAliases';
 import type { ChatProps } from '../Chat/ChatProps';
+import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 /**
  * Props for LlmChat component, derived from ChatProps but with LLM-specific modifications
  *
@@ -34,4 +35,16 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * When provided, LlmChat will attach its internal handler to it (no React context needed).
      */
     readonly sendMessage?: SendMessageToLlmChatFunction;
+    /**
+     * Name of the USER as participant in the chat
+     *
+     * @default 'USER'
+     */
+    readonly userParticipantName?: id;
+    /**
+     * Name of the LLM as participant in the chat
+     *
+     * @default 'ASSISTANT'
+     */
+    readonly llmParticipantName?: id;
 };

package/esm/typings/src/book-components/Chat/save/_common/ChatSaveFormatDefinition.d.ts

@@ -0,0 +1,13 @@
+import { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
+import type { ChatMessage } from '../../types/ChatMessage';
+/**
+ * Plugin contract for chat export formatNames
+ * @public exported from `@promptbook/components`
+ */
+export type ChatSaveFormatDefinition = {
+    formatName: string_file_extension | string_mime_type | string;
+    label: string;
+    getContent: (messages: ChatMessage[]) => string;
+    mimeType: string;
+    fileExtension: string;
+};

package/esm/typings/src/book-components/Chat/save/_common/getChatSaveFormatDefinitions.d.ts

@@ -0,0 +1,8 @@
+import { ChatSaveFormatDefinition } from './ChatSaveFormatDefinition';
+import { string_chat_format_name } from './string_chat_format_name';
+/**
+ * Returns enabled chat save plugins filtered by formatNames (or all when omitted)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function getChatSaveFormatDefinitions(formatNames?: ReadonlyArray<string_chat_format_name>): ReadonlyArray<ChatSaveFormatDefinition>;

package/esm/typings/src/book-components/Chat/save/_common/string_chat_format_name.d.ts

@@ -0,0 +1,6 @@
+import { CHAT_SAVE_FORMATS } from '..';
+/**
+ * Supported chat export formatNames
+ * @public exported from `@promptbook/components`
+ */
+export type string_chat_format_name = typeof CHAT_SAVE_FORMATS[number]['formatName'];

package/esm/typings/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTML export plugin
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const htmlSaveFormatDefinition: {
+    readonly formatName: "html";
+    readonly label: "HTML";
+    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/html";
+    readonly fileExtension: "html";
+};

package/esm/typings/src/book-components/Chat/save/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Registry of all built-in chat save plugins
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const CHAT_SAVE_FORMATS: readonly [{
+    readonly formatName: "json";
+    readonly label: "JSON (full)";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "application/json";
+    readonly fileExtension: "json";
+}, {
+    readonly formatName: "txt";
+    readonly label: "Plain Text";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/plain";
+    readonly fileExtension: "txt";
+}, {
+    readonly formatName: "md";
+    readonly label: "Markdown";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/markdown";
+    readonly fileExtension: "md";
+}, {
+    readonly formatName: "html";
+    readonly label: "HTML";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/html";
+    readonly fileExtension: "html";
+}];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-components/Chat/save/json/jsonSaveFormatDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON export plugin (full metadata)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const jsonSaveFormatDefinition: {
+    readonly formatName: "json";
+    readonly label: "JSON (full)";
+    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "application/json";
+    readonly fileExtension: "json";
+};

package/esm/typings/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Markdown export plugin
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const mdSaveFormatDefinition: {
+    readonly formatName: "md";
+    readonly label: "Markdown";
+    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/markdown";
+    readonly fileExtension: "md";
+};

package/esm/typings/src/book-components/Chat/save/text/txtSaveFormatDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plain text export plugin (messages only)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const txtSaveFormatDefinition: {
+    readonly formatName: "txt";
+    readonly label: "Plain Text";
+    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/plain";
+    readonly fileExtension: "txt";
+};

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

@@ -1,16 +1,42 @@
-import type { string_markdown } from '../../../types/typeAliases';
-import type { string_name } from '../../../types/typeAliases';
+import type { id, string_markdown } from '../../../types/typeAliases';
 /**
  * A message in the chat
  *
  * @public exported from `@promptbook/components`
  */
 export type ChatMessage = {
-    id: string;
-    date: Date;
-    from: string_name;
+    /**
+     * Unique identifier of the message
+     */
+    id: id;
+    /**
+     * Date when the message was created
+     */
+    date?: Date;
+    /**
+     * The name of the participant who sent the message
+     */
+    from: id;
+    /**
+     * The content of the message with optional markdown formatting
+     */
     content: string_markdown;
+    /**
+     * Whether the message is complete (for example, if it's still being generated by an AI)
+     *
+     * @default true
+     */
     isComplete?: boolean;
+    /**
+     * @@@
+     */
     expectedAnswer?: string;
+    /**
+     * @@@
+     */
     isVoiceCall?: boolean;
 };
+/**
+ * TODO: Delete `expectedAnswer` from ChatMessage
+ * TODO: Rename `date` into `created`+`modified`
+ */

package/esm/typings/src/book-components/Chat/types/ChatParticipant.d.ts

@@ -1,4 +1,4 @@
-import type { string_color, string_name, string_person_fullname, string_url_image } from '../../../types/typeAliases';
+import type { id, string_color, string_person_fullname, string_url_image } from '../../../types/typeAliases';
 import { Color } from '../../../utils/color/Color';
 /**
  * A participant in the chat
@@ -9,11 +9,11 @@ export type ChatParticipant = {
     /**
      * Identifies the participant by their name, same as `message.from`
      */
-    name: string_name;
+    name: id;
     /**
      * Full name of the participant
      */
-    fullname: string_person_fullname;
+    fullname?: string_person_fullname;
     /**
      * Am I the participant? (i.e. is this the user)
      */

package/esm/typings/src/book-components/Chat/utils/exportChatHistory.d.ts

@@ -7,3 +7,6 @@ import type { ExportFormat } from './ExportFormat';
  * @private utility of `<Chat/>` component
  */
 export declare function exportChatHistory(messages: ChatMessage[], format: ExportFormat, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): Promise<void>;
+/**
+ * TODO: !!!! Delete this parallel chat history export
+ */

package/esm/typings/src/book-components/icons/AttachmentIcon.d.ts

@@ -0,0 +1,11 @@
+type AttachmentIconProps = {
+    size?: number;
+    color?: string;
+};
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AttachmentIcon({ size, color }: AttachmentIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/book-components/icons/CloseIcon.d.ts

@@ -0,0 +1,11 @@
+type CloseIconProps = {
+    size?: number;
+    color?: string;
+};
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function CloseIcon({ size, color }: CloseIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/remote-server/ui/ServerApp.d.ts

@@ -0,0 +1,13 @@
+import type { ServerInfo } from './types';
+/**
+ * @@@
+ *
+ * @private internal utility of Remote Server
+ */
+export declare function HtmlDoc({ info }: {
+    info: ServerInfo;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Add Note: [💞] Ignore a discrepancy between file name and entity name
+ *     <- TODO: !!! Maybe split into multiple files
+ */

package/esm/typings/src/remote-server/ui/renderServerIndexHtml.d.ts

@@ -0,0 +1,7 @@
+import type { ServerInfo } from './types';
+/**
+ * Render full HTML for the server index using React SSR without requiring TSX/JSX compiler flags.
+ *
+ * @private internal utility of Remote Server
+ */
+export declare function renderServerIndexHtml(info: ServerInfo): string;

package/esm/typings/src/remote-server/ui/types.d.ts

@@ -0,0 +1,16 @@
+export type ServerInfo = {
+    bookLanguageVersion: string;
+    promptbookEngineVersion: string;
+    nodeVersion: string;
+    port: number | string | undefined;
+    startupDate: string;
+    isAnonymousModeAllowed: boolean;
+    isApplicationModeAllowed: boolean;
+    pipelines: ReadonlyArray<string>;
+    runningExecutions: number;
+    paths: ReadonlyArray<string>;
+};
+/**
+ * Add Note: [💞] Ignore a discrepancy between file name and entity name
+ *     <- TODO: !!! Maybe split into multiple files
+ */

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

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.102.0-0`).
+ * It follows semantic versioning (e.g., `0.102.0-2`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.102.0-1",
+    "version": "0.102.0-3",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.102.0-1"
+        "@promptbook/core": "0.102.0-3"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.6",

package/umd/index.umd.js

@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.102.0-1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.102.0-3';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/book-components/Chat/save/savePlugins.d.ts

@@ -1,105 +0,0 @@
-import { string_file_extension, string_mime_type } from '../../../types/typeAliases';
-import type { ChatMessage } from '../types/ChatMessage';
-/**
- * Supported chat export formatNames
- * @public exported from `@promptbook/components`
- */
-export type string_chat_format_name = typeof CHAT_SAVE_FORMATS[number]['formatName'];
-/**
- * Plugin contract for chat export formatNames
- * @public exported from `@promptbook/components`
- */
-export type ChatSaveFormatDefinition = {
-    formatName: string_file_extension | string_mime_type | string;
-    label: string;
-    getContent: (messages: ChatMessage[]) => string;
-    mimeType: string;
-    fileExtension: string;
-};
-/**
- * JSON export plugin (full metadata)
- *
- * @public exported from `@promptbook/components`
- */
-export declare const jsonSaveFormatDefinition: {
-    readonly formatName: "json";
-    readonly label: "JSON (full)";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "application/json";
-    readonly fileExtension: "json";
-};
-/**
- * Plain text export plugin (messages only)
- *
- * @public exported from `@promptbook/components`
- */
-export declare const txtSaveFormatDefinition: {
-    readonly formatName: "txt";
-    readonly label: "Plain Text";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/plain";
-    readonly fileExtension: "txt";
-};
-/**
- * Markdown export plugin
- *
- * @public exported from `@promptbook/components`
- */
-export declare const mdSaveFormatDefinition: {
-    readonly formatName: "md";
-    readonly label: "Markdown";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/markdown";
-    readonly fileExtension: "md";
-};
-/**
- * HTML export plugin
- *
- * @public exported from `@promptbook/components`
- */
-export declare const htmlSaveFormatDefinition: {
-    readonly formatName: "html";
-    readonly label: "HTML";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/html";
-    readonly fileExtension: "html";
-};
-/**
- * Registry of all built-in chat save plugins
- *
- * @public exported from `@promptbook/components`
- */
-export declare const CHAT_SAVE_FORMATS: readonly [{
-    readonly formatName: "json";
-    readonly label: "JSON (full)";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "application/json";
-    readonly fileExtension: "json";
-}, {
-    readonly formatName: "txt";
-    readonly label: "Plain Text";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/plain";
-    readonly fileExtension: "txt";
-}, {
-    readonly formatName: "md";
-    readonly label: "Markdown";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/markdown";
-    readonly fileExtension: "md";
-}, {
-    readonly formatName: "html";
-    readonly label: "HTML";
-    readonly getContent: (messages: ChatMessage[]) => string;
-    readonly mimeType: "text/html";
-    readonly fileExtension: "html";
-}];
-/**
- * Returns enabled chat save plugins filtered by formatNames (or all when omitted)
- *
- * @public exported from `@promptbook/components`
- */
-export declare function getChatSaveFormatDefinitions(formatNames?: ReadonlyArray<string_chat_format_name>): ReadonlyArray<ChatSaveFormatDefinition>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */