@promptbook/markdown-utils 0.112.0-65 → 0.112.0-66

package/esm/src/avatars/types/AvatarVisualDefinition.d.ts

@@ -6,7 +6,7 @@ import type { AvatarDefinition } from './AvatarDefinition';
  *
  * @private shared contract for the avatar rendering system
  */
-export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'fractal' | 'orb';
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'minecraft2' | 'fractal' | 'orb';
 /**
  * Derived color palette used by avatar visuals.
  *

package/esm/src/avatars/visuals/minecraft2AvatarVisual.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Minecraft 3D 2 avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+export declare const minecraft2AvatarVisual: AvatarVisualDefinition;

package/esm/src/avatars/visuals/minecraftAvatarVisualShared.d.ts

@@ -0,0 +1,48 @@
+import type { AvatarPalette } from '../types/AvatarVisualDefinition';
+/**
+ * One Minecraft-style pixel texture sampled on a cuboid face.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftTexture = ReadonlyArray<ReadonlyArray<string>>;
+/**
+ * Full six-face texture pack for one rendered cuboid.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftCuboidTextures = {
+    readonly front: MinecraftTexture;
+    readonly back: MinecraftTexture;
+    readonly left: MinecraftTexture;
+    readonly right: MinecraftTexture;
+    readonly top: MinecraftTexture;
+    readonly bottom: MinecraftTexture;
+};
+/**
+ * Shared subset of avatar colors used by the Minecraft avatar helpers.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+type MinecraftTexturePalette = Pick<AvatarPalette, 'primary' | 'secondary' | 'accent' | 'highlight' | 'ink' | 'shadow'>;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style head cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the generated avatar should include a colored headband.
+ * @returns Head cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftHeadTextures(random: () => number, palette: MinecraftTexturePalette, hasHeadband: boolean): MinecraftCuboidTextures;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style torso cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns Torso cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftTorsoTextures(random: () => number, palette: MinecraftTexturePalette): MinecraftCuboidTextures;
+export {};

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

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
+ * Ensures `.gitignore` contains the shared Promptbook working-directory entry.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

package/esm/src/config.d.ts

@@ -270,7 +270,7 @@ export declare const DEFAULT_AGENTS_DIRNAME = "./agents";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME: string;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -278,7 +278,7 @@ export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-ca
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME: string;
 /**
  * Where to store the scrape cache
  *
@@ -286,7 +286,7 @@ export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME: string;
 /**
  * Id of application for the CLI when using remote server
  *

package/esm/src/utils/files/getPromptbookTempPath.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one absolute filesystem path inside the shared Promptbook working directory for a project root.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function resolvePromptbookTempPath(projectPath: string, ...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPosixPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one rooted `.gitignore` rule targeting a path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempGitignoreRule(...pathSegments: ReadonlyArray<string>): string;

package/esm/src/utils/files/getPromptbookTempPath.test.d.ts

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

package/esm/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.112.0-64`).
+ * It follows semantic versioning (e.g., `0.112.0-65`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/markdown-utils",
-    "version": "0.112.0-65",
+    "version": "0.112.0-66",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-markdown-utils"] = {}, global.spacetrim, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse));
-})(this, (function (exports, spacetrim, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('path'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('papaparse')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'path', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'papaparse'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-markdown-utils"] = {}, global.spacetrim, global.path, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.papaparse));
+})(this, (function (exports, spacetrim, path, crypto, rxjs, waitasecond, hexEncoder, sha256, cryptoJs, mimeTypes, papaparse) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-65';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-66';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1082,6 +1082,29 @@
     }
     // TODO: Maybe implement by mix+hsl
 
+    /**
+     * Relative directory name without the `./` prefix for Git ignore rules and glob patterns.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    const PROMPTBOOK_TEMP_DIRECTORY_NAME = '.promptbook';
+    /**
+     * Builds one project-relative path inside the shared Promptbook working directory.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    function getPromptbookTempPath(...pathSegments) {
+        return `./${getPromptbookTempPosixPath(...pathSegments)}`;
+    }
+    /**
+     * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    function getPromptbookTempPosixPath(...pathSegments) {
+        return path.posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+    }
+
     /**
      * Returns the same value that is passed as argument.
      * No side effects.
@@ -1263,7 +1286,6 @@
      */
     const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
     // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
-    // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
      * Where to store the temporary downloads
      *
@@ -1271,7 +1293,15 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
+    const DEFAULT_DOWNLOAD_CACHE_DIRNAME = getPromptbookTempPath('download-cache');
+    /**
+     * Where to store the cache of executions for promptbook CLI
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+    getPromptbookTempPath('execution-cache');
     /**
      * Where to store the scrape cache
      *
@@ -1279,7 +1309,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
+    const DEFAULT_SCRAPE_CACHE_DIRNAME = getPromptbookTempPath('scrape-cache');
     // <- TODO: [🧜‍♂️]
     /**
      * Default settings for parsing and generating CSV files in Promptbook.