@qr-platform/qr-code.js 0.11.3 → 0.11.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qr-platform/qr-code.js",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "description": "QRCode.js is a professional JavaScript/TypeScript library for creating customized QR codes, offering a blend of simplicity and sophistication. With versatile styling options—dot shapes, colors, gradients, embedded images, borders, and text—it enables you to design unique, visually appealing QR codes that work flawlessly with standard scanners. QRCode.js is part of QR-Platform: All-in-One QR Codes Management Solution.",
   "type": "module",
   "main": "./lib/node.js",

package/docs/border-methods-update-plan.md

@@ -1,28 +0,0 @@
-# Plan: Update Documentation for Border Methods
-
-**Objective:** Update documentation files to include information about the new border configuration methods: `setBorder`, `setBorderId`, `useBorder`, and `useBorderId`.
-
-## 1. Target Files
-
-*   `README.md`
-*   `docs/documentation.md`
-*   `docs/usage-guide.md`
-*   `docs/api-reference-guide.md`
-*   `docs/examples.md`
-*   `docs/advanced-examples.md`
-*   `docs/typescript-types-definitions.md`
-
-## 2. Update Strategy & Content
-
-*   **Update README:** Briefly mention the new static methods (`setBorder`, `setBorderId`, `useBorder`, `useBorderId`) in a relevant section (e.g., Features) and link to the main documentation for details.
-*   **Explain Both Mechanisms:** In `documentation.md` and `usage-guide.md`, clearly differentiate the `set...` (global default) and `use...` (builder pattern) approaches for border configuration.
-*   **Update Method Tables:** Add entries for `setBorder`, `setBorderId`, `useBorder`, and `useBorderId` to static method tables in relevant files, detailing parameters, return types, and purpose.
-*   **Add Examples:**
-    *   In `examples.md`, add simple examples for `setBorder`, `setBorderId`, `useBorder`, and `useBorderId`.
-    *   In `advanced-examples.md`, add examples combining global defaults (`setTemplate`/`setStyle`/`setBorder`) and builder methods (`useTemplate`/`useStyle`/`useBorder`).
-*   **Update Options Tables:** Ensure the `borderOptions` description mentions configuration via the new static/builder methods.
-*   **Verify Types:** Briefly check `docs/typescript-types-definitions.md` for `BorderOptions`.
-
-## 3. Implementation
-
-This plan will be implemented by switching to Code mode after approval.

package/docs/border-text-implementation-plan.md

@@ -1,155 +0,0 @@
-# Plan for Implementing Border Text Functionality
-
-This document outlines the plan to implement `setText`, `useText`, `setTextId`, and `useTextId` functionality for managing text on QR code borders.
-
-## Phase 1: Define Core Structures and Text Templates
-
-1.  **Create `TextOptions` and `QRTextTemplateDefinition` Types:**
-    *   Define these interfaces. A new file like `src/types/text-options.ts` or an existing relevant types file (e.g., `src/utils/options.ts` or `src/types/style-options.ts`) can be used.
-    *   **`TextOptions` Interface:**
-        ```typescript
-        export interface TextOptions {
-          topValue?: string | null;
-          leftValue?: string | null;
-          rightValue?: string | null;
-          bottomValue?: string | null;
-        }
-        ```
-    *   **`QRTextTemplateDefinition` Interface:** (similar to `QRTemplateDefinition`)
-        ```typescript
-        // Assuming TextOptions is in 'text-options.ts' or similar
-        import { TextOptions } from './text-options'; // Adjust path as needed
-
-        export interface QRTextTemplateDefinition {
-          id: string;
-          name: string;
-          options: TextOptions;
-        }
-        ```
-
-2.  **Create New Text Templates File: `src/core/templates/qr-template-text.ts`**
-    *   This file will be analogous to `src/core/templates/qr-template-borders.ts`.
-    *   It will import `QRTextTemplateDefinition` and `TextOptions`.
-    *   Define at least 20 unique `QRTextTemplateDefinition` objects.
-        *   Each template will have a unique `id` (e.g., `"scan-me-top"`, `"return-if-found-bottom-left"`).
-        *   Each template will have a unique, descriptive `name` (e.g., `"Scan Me (Top Text)"`, `"Return If Found (Bottom & Left Text)"`).
-        *   The `options` field will be a `TextOptions` object with various combinations of `topValue`, `leftValue`, `rightValue`, `bottomValue`.
-        *   Include `null` values where appropriate to signify no text for a particular side.
-        *   Focus on call-to-action phrases like "Scan Me", "Visit Website", "Follow Us", "Contact Info", "Scan to Pay", "Product Details", "Event Info", "Lost & Found", etc.
-    *   Export an array `qrTextTemplates: QRTextTemplateDefinition[]`.
-    *   Export helper functions `findTextByName(name: string): QRTextTemplateDefinition | undefined` and `findTextById(id: string): QRTextTemplateDefinition | undefined`.
-
-## Phase 2: Implement Core Logic in `QRCodeJs` (`src/core/qr-code-js.ts`)
-
-1.  **Add Static Properties for Selected Text:**
-    *   `private static _selectedText: QRTextTemplateDefinition | TextOptions | null = null;`
-
-2.  **Implement `setText` Static Method:**
-    *   `public static setText(textNameOrOptions: string | TextOptions | null): typeof QRCodeJs`
-    *   If `null`, set `_selectedText` to `null`.
-    *   If `string`, use `findTextByName` from `qr-template-text.ts` to find the template. If found, store the `QRTextTemplateDefinition` in `_selectedText`. If not found, log a warning.
-    *   If `object` (instance of `TextOptions`), store it directly in `_selectedText`.
-
-3.  **Implement `setTextId` Static Method:**
-    *   `public static setTextId(textId: string | null): typeof QRCodeJs`
-    *   If `null`, set `_selectedText` to `null`.
-    *   Use `findTextById` from `qr-template-text.ts`. If found, store the `QRTextTemplateDefinition` in `_selectedText`. If not found, log a warning.
-
-4.  **Update Constructor and `update` Method Logic:**
-    *   In the constructor and `update` method, after merging `borderOptions`, apply `_selectedText`.
-    *   **Merging Logic:**
-        *   Resolve `_selectedText` to a `TextOptions` object (either from `QRTextTemplateDefinition.options` or directly).
-        *   Iterate through `topValue`, `leftValue`, `rightValue`, `bottomValue` of the resolved `TextOptions`.
-        *   For each provided value (not `undefined`):
-            *   Update `this.options.borderOptions.decorations.<side>.value`.
-            *   Set `this.options.borderOptions.decorations.<side>.enableText = true`.
-            *   If the value is `null`, set `this.options.borderOptions.decorations.<side>.value = null` and `this.options.borderOptions.decorations.<side>.enableText = false`.
-        *   Ensure `this.options.borderOptions.decorations` and each side object (`top`, `left`, etc.) are initialized if they don't exist.
-
-## Phase 3: Implement Builder Logic in `QRCodeBuilder` (`src/index.ts` and `src/node.ts`)
-
-*   Changes need to be mirrored in `QRCodeBuilder` in both `src/index.ts` and `src/node.ts`.
-
-1.  **Add Properties to `QRCodeBuilder`:**
-    *   `protected _textSource: string | TextOptions | null = null;`
-    *   `protected _isTextById: boolean = false;`
-
-2.  **Implement `useText` Method in `QRCodeBuilder`:**
-    *   `public useText(textNameOrOptions: string | TextOptions): this`
-    *   Stores `textNameOrOptions` in `_textSource`. Sets `_isTextById = false`.
-
-3.  **Implement `useTextId` Method in `QRCodeBuilder`:**
-    *   `public useTextId(textId: string): this`
-    *   Stores `textId` in `_textSource`. Sets `_isTextById = true`.
-
-4.  **Update `_resolveAndMergeConfig` in `QRCodeBuilder`:**
-    *   Add a step to apply text options after border options.
-    *   **Order:** Base Template -> Selected Template -> Selected Border -> **Selected Text** -> Selected Style -> Selected Image -> Final Options.
-    *   **Logic:**
-        *   Resolve `_textSource` (using `findTextById`/`findTextByName` if string, or directly if object).
-        *   If valid `TextOptions` are found:
-            *   Create a partial `Options` object: `let textOptionsToApply: RecursivePartial<Options> = { borderOptions: { decorations: {} } };`
-            *   For each key in resolved `TextOptions` (e.g., `topValue`):
-                *   `textOptionsToApply.borderOptions.decorations.top = { value: textOptions.topValue, enableText: textOptions.topValue !== null };`
-            *   Repeat for `left`, `right`, `bottom`.
-            *   Merge `textOptionsToApply` into `resolvedConfig`.
-
-5.  **Add Static `useText` and `useTextId` Methods to `QRCodeJs` class (in `src/index.ts` and `src/node.ts`):**
-    *   `public static useText(textNameOrOptions: string | TextOptions): QRCodeBuilder`
-        *   `return new QRCodeBuilder(this).useText(textNameOrOptions);`
-    *   `public static useTextId(textId: string): QRCodeBuilder`
-        *   `return new QRCodeBuilder(this).useTextId(textId);`
-
-## Phase 4: Update Imports and Exports
-
-1.  **In `src/index.ts` and `src/node.ts`:**
-    *   Import `findTextById`, `findTextByName` from `./core/templates/qr-template-text`.
-    *   Import `TextOptions`, `QRTextTemplateDefinition` (if in a separate file).
-    *   Export these types if intended for public use.
-
-## Phase 5: Testing and Documentation
-
-1.  **Update `src/templates/borders-templates.html`:**
-    *   Add a new dropdown selector for "Text Templates" populated from `qrTextTemplates`.
-    *   Modify the rendering loop:
-        *   After applying base template, style, and border, add a step to apply a selected text template using `QRCodeJs.setTextId()` or `QRCodeJs.setText()`.
-        *   This will demonstrate the override behavior where `setText` modifies the text values on borders already configured by `setBorder`.
-    *   Ensure the visual output clearly shows the text being applied/overridden.
-
-2.  **Add Unit Tests (Recommended):**
-    *   Test `findTextByName` and `findTextById`.
-    *   Test `setText`/`setTextId` in `QRCodeJs` core.
-    *   Test `useText`/`useTextId` in `QRCodeBuilder`.
-
-3.  **Update Documentation (`README.md`, API docs):**
-    *   Document new types, static methods, and builder methods.
-    *   Provide usage examples.
-
-## Mermaid Diagram: `QRCodeBuilder._resolveAndMergeConfig` Flow
-
-```mermaid
-graph TD
-    A[Start _resolveAndMergeConfig] --> B{Initial Options or Base Template};
-    B -- Initial Options --> C[Merge Initial Options];
-    B -- Base Template --> C[Merge baseQRTemplateOptions];
-    C --> D{Template Source Set?};
-    D -- Yes --> E[Find/Apply Template Options];
-    D -- No --> F;
-    E --> F;
-    F{Border Source Set?} --> G;
-    G -- Yes --> H[Find/Apply Border Options];
-    G -- No --> I;
-    H --> I;
-    I{Text Source Set?} --> J;
-    J -- Yes --> K[Find/Apply Text Options to Decorations];
-    J -- No --> L;
-    K --> L;
-    L{Style Source Set?} --> M;
-    M -- Yes --> N[Find/Apply Style Options];
-    M -- No --> O;
-    N --> O;
-    O{Image Source Set?} --> P;
-    P -- Yes --> Q[Apply Image Option];
-    P -- No --> R;
-    Q --> R;
-    R[Merge Final User Options] --> S[Return Resolved Config];

package/docs/ft009-settings-option-continuation-plan.md

@@ -1,124 +0,0 @@
-# Feature Task FT009 - Settings Option - Continuation Plan
-
-## 1. Original Task Description (FT009)
-
-**Feature:** Settings Option
-**Task Description:** Add a mechanism to configure QR code instances using a comprehensive `SettingsOptions` object. This was initially planned as an instance method `setSettings()` and a static builder-style method `QRCodeJs.settings()`. The requirements evolved to include a `useSettings()` method for the `QRCodeBuilder` and to make the instance-level application a static utility method.
-
-**Core Requirements:**
-*   Provide a centralized way to configure multiple QR code properties: `id`, `name`, `description`, `data`, `image`, `template`, `templateId`, `style`, `styleId`, `text`, `textId`, `border`, `borderId`, and a general `options` override.
-*   Ensure this new configuration method interacts correctly with existing setup methods, generally by overriding previous settings.
-
-## 2. Current Implementation Status
-
-### 2.1. Core Class Changes ([`src/core/qr-code-js.ts`](src/core/qr-code-js.ts))
-*   **`SettingsOptions` Type:** Defined in [`src/types/settings-options.ts`](src/types/settings-options.ts). It includes:
-    ```typescript
-    export interface SettingsOptions {
-      id?: string;
-      name?: string;
-      description?: string;
-      data?: string;
-      image?: string | Buffer | Blob;
-      template?: string | RecursivePartial<Options>;
-      templateId?: string;
-      style?: string | StyleOptions;
-      styleId?: string;
-      text?: string | TextOptions;
-      textId?: string;
-      border?: string | RecursivePartial<BorderOptions>;
-      borderId?: string;
-      options?: RecursivePartial<Options>;
-    }
-    ```
-*   **Static `setSettings` Method:**
-    *   A `public static async setSettings(instance: QRCodeJs, settings: SettingsOptions): Promise<void>` method has been added to `QRCodeJs`.
-    *   This method applies the provided `SettingsOptions` to a given `QRCodeJs` instance.
-    *   It completely replaces the instance's current options by:
-        1.  Starting with `baseQRTemplateOptions`.
-        2.  Applying `template`, `style`, `text`, `border` from the `settings` object.
-        3.  Setting `newOptions.image = settings.image` if `settings.image` is provided.
-        4.  Setting `newOptions.data = settings.data` if `settings.data` is provided. If not, it attempts to use `settings.options.data`. If still not present, it retains `instance.options.data`.
-        5.  Merging `settings.options` for any other direct overrides.
-        6.  Validating and sanitizing the resulting options.
-        7.  Calling `await instance.update()`.
-*   **Removed Static Configuration:** The previously planned static `QRCodeJs.settings()` method (that would set static defaults like `_selectedSettings`) and related static properties (`_selectedSettings`, `_selectedData`) have been removed from `QRCodeJs` as per user feedback.
-
-### 2.2. Documentation
-*   [`docs/typescript-types-definitions.md`](docs/typescript-types-definitions.md): Updated with the `SettingsOptions` interface.
-*   [`docs/api-reference-guide.md`](docs/api-reference-guide.md): Updated to reflect the new static `QRCodeJs.setSettings(instance, settings)` method and remove the old static `QRCodeJs.settings()` method.
-*   [`docs/usage-guide.md`](docs/usage-guide.md): Updated with examples for the new static `QRCodeJs.setSettings(instance, settings)` method.
-
-### 2.3. Unit Tests
-*   [`tests/node/node.settings.test.ts`](tests/node/node.settings.test.ts): Initial tests for the static `setSettings(instance, settings)` method have been created and partially debugged. Import paths and type assertions have been refined.
-
-## 3. Remaining Tasks
-
-### 3.1. Implement `useSettings` in `QRCodeBuilder`
-This is the primary remaining coding task. The `useSettings` method needs to be added to the `QRCodeBuilder` class in both:
-*   [`src/index.ts`](src/index.ts) (for browser environment)
-*   [`src/node.ts`](src/node.ts) (for Node.js environment)
-
-**`QRCodeBuilder.useSettings(settings: SettingsOptions): this` Method Details:**
-*   **Store Settings:**
-    *   Add a new protected property to `QRCodeBuilder`: `protected _settingsSource: SettingsOptions | null = null;`
-    *   The `useSettings` method will set `this._settingsSource = settings;`.
-*   **Override Behavior:**
-    *   Calling `useSettings` must reset/nullify all other builder-specific configuration sources to ensure it takes precedence over any prior `useTemplate()`, `useStyle()`, `useBorder()`, `useText()`, `useImage()` calls, and `_initialOptions`. This includes:
-        *   `this._templateSource = null;`
-        *   `this._isTemplateById = false;`
-        *   `this._borderSource = null;`
-        *   `this._isBorderById = false;`
-        *   `this._styleSource = null;`
-        *   `this._isStyleById = false;`
-        *   `this._imageSource = null;`
-        *   `this._imageOverride = false;`
-        *   `this._textSource = null;`
-        *   `this._isTextById = false;`
-        *   `this._textOverride = false;`
-        *   `this._initialOptions = null;`
-*   **Modify `_resolveAndMergeConfig(finalOptions: RecursivePartial<Options> = {})` in `QRCodeBuilder`:**
-    *   **Priority for `_settingsSource`:**
-        1.  If `this._settingsSource` is set:
-            *   Initialize `resolvedConfig = mergeDeep({}, baseQRTemplateOptions)`.
-            *   Apply `template/templateId` from `this._settingsSource` to `resolvedConfig`.
-            *   Apply `style/styleId` from `this._settingsSource` (mapping style options) to `resolvedConfig`.
-            *   Apply `border/borderId` from `this._settingsSource` to `resolvedConfig`.
-            *   Apply `text/textId` from `this._settingsSource` (mapping to `borderOptions.decorations`) to `resolvedConfig`.
-            *   If `this._settingsSource.image` is defined, set `resolvedConfig.image = this._settingsSource.image;`.
-            *   If `this._settingsSource.data` is defined, set `resolvedConfig.data = this._settingsSource.data;`.
-            *   Merge `this._settingsSource.options` into `resolvedConfig`.
-    *   **Else (no `_settingsSource`):**
-        *   Follow the existing logic: apply `_initialOptions`, then `_templateSource`, `_borderSource`, `_styleSource`, `_imageSource` (non-override), `_textSource` (non-override).
-    *   **Final Merge & Overrides:**
-        *   Merge `finalOptions` (from a subsequent `.options()` call) into `resolvedConfig`. This allows `.options()` to override settings from `useSettings`.
-        *   The existing `_imageOverride` and `_textOverride` logic should apply last. If `useImage(..., {override:true})` or `useText(..., {override:true})` is called *after* `useSettings()`, it effectively clears `_settingsSource` (because `useSettings` resets those specific sources) and these specific overrides would then apply as intended.
-
-### 3.2. Unit Testing
-*   Add comprehensive unit tests for `QRCodeBuilder.useSettings` in both [`tests/node/node.settings.test.ts`](tests/node/node.settings.test.ts) and potentially a new browser-specific test file if behavior differs or requires DOM.
-*   Tests should cover:
-    *   `useSettings` correctly applying all properties from `SettingsOptions`.
-    *   `useSettings` overriding configurations from previous `useTemplate`, `useStyle`, `useBorder`, `useText`, `useImage` calls.
-    *   A subsequent `.options()` call overriding configurations set by `useSettings`.
-    *   `.build()` using the correct configuration when `useSettings` is involved.
-    *   Interaction with `useImage(..., {override:true})` and `useText(..., {override:true})` when called after `useSettings`.
-
-### 3.3. Documentation Updates
-*   **[`docs/api-reference-guide.md`](docs/api-reference-guide.md):** Add `useSettings` to the `QRCodeBuilder` methods table.
-*   **[`docs/usage-guide.md`](docs/usage-guide.md):** Add a new subsection explaining `QRCodeBuilder.useSettings` with clear examples, emphasizing its override behavior and interaction with `.options()`.
-
-## 4. Files to be Modified for Remaining Tasks
-*   [`src/index.ts`](src/index.ts) (for `QRCodeBuilder`)
-*   [`src/node.ts`](src/node.ts) (for `QRCodeBuilder`)
-*   [`tests/node/node.settings.test.ts`](tests/node/node.settings.test.ts) (and potentially new test files)
-*   [`docs/api-reference-guide.md`](docs/api-reference-guide.md)
-*   [`docs/usage-guide.md`](docs/usage-guide.md)
-
-## 5. Key Considerations for `_resolveAndMergeConfig`
-The logic for merging needs to be precise:
-1.  If `_settingsSource` is present, it forms the new "base" by applying its constituent parts (template, style, border, text, image, data, options) sequentially on top of `baseQRTemplateOptions`.
-2.  If `_settingsSource` is NOT present, the old logic of applying `_initialOptions`, `_templateSource`, etc., applies.
-3.  `finalOptions` (from `.options()`) are merged *after* the above, allowing them to override anything set by `useSettings` or other builder methods.
-4.  Specific `override: true` calls for `useImage` or `useText` should still function as the ultimate override for those specific properties if they are called *after* `useSettings` (which would have nulled out `_settingsSource` and re-activated `_imageSource`/`_textSource`).
-
-This structured plan should allow for a smooth continuation of the task.

package/docs/ft009-settings-option-plan.md

@@ -1,254 +0,0 @@
-# Feature FT009 - Settings Option Implementation Plan
-
-This document outlines the plan to implement the `setSettings()` instance method and the `.settings()` builder method for the `QRCodeJs` class, as per Task ID FT009.
-
-## I. Define `SettingsOptions` Type
-
-1.  **Create/Update Type Definition File:**
-    *   A new file, `src/types/settings-options.ts`, will be created.
-    *   **Content:**
-        ```typescript
-        import { RecursivePartial } from './helper';
-        import { Options, BorderOptions } from '../utils/options';
-        import { StyleOptions } from './style-options';
-        import { TextOptions } from './text-options';
-
-        export interface SettingsOptions {
-          id?: string;
-          name?: string;
-          description?: string;
-          template?: string | RecursivePartial<Options>;
-          templateId?: string;
-          style?: string | StyleOptions;
-          styleId?: string;
-          text?: string | TextOptions;
-          textId?: string;
-          border?: string | RecursivePartial<BorderOptions>;
-          borderId?: string;
-          options?: RecursivePartial<Options>; // For direct overrides/merges into the main Options
-        }
-        ```
-2.  **Export:** Ensure `SettingsOptions` is exported from this new file.
-3.  **Import in `qr-code-js.ts`:** Add the necessary import for `SettingsOptions`.
-
-## II. Implement Static `QRCodeJs.settings()` Method in `qr-code-js.ts`
-
-1.  **Add Static Property:**
-    ```typescript
-    private static _selectedSettings: SettingsOptions | null = null;
-    ```
-2.  **Create Static `settings()` Method:**
-    *   Define the public static method:
-        ```typescript
-        public static settings(settings: SettingsOptions | null): typeof QRCodeJs {
-          // 1. Reset all existing static configurations to ensure "replace" behavior
-          QRCodeJs._selectedTemplate = null;
-          QRCodeJs._selectedBorder = null;
-          QRCodeJs._selectedStyle = null;
-          QRCodeJs._selectedImage = null;
-          QRCodeJs._selectedImageOverride = false;
-          QRCodeJs._selectedText = null;
-          QRCodeJs._selectedTextOverride = false;
-          // Potentially other static states if any are missed here.
-
-          if (settings === null) {
-            QRCodeJs._selectedSettings = null;
-            return QRCodeJs;
-          }
-
-          QRCodeJs._selectedSettings = settings;
-
-          // 2. Apply individual configurations from the 'settings' object
-          if (settings.templateId) {
-            QRCodeJs.setTemplateId(settings.templateId);
-          } else if (settings.template) {
-            QRCodeJs.setTemplate(settings.template);
-          }
-
-          if (settings.styleId) {
-            QRCodeJs.setStyleId(settings.styleId);
-          } else if (settings.style) {
-            QRCodeJs.setStyle(settings.style);
-          }
-
-          if (settings.textId) {
-            QRCodeJs.setTextId(settings.textId);
-          } else if (settings.text) {
-            QRCodeJs.setText(settings.text);
-          }
-
-          if (settings.borderId) {
-            QRCodeJs.setBorderId(settings.borderId);
-          } else if (settings.border) {
-            QRCodeJs.setBorder(settings.border);
-          }
-          
-          return QRCodeJs;
-        }
-        ```
-
-## III. Modify `QRCodeJs` Constructor in `qr-code-js.ts`
-
-*   The constructor's option merging logic needs to account for `_selectedSettings`.
-*   **Revised Constructor Logic (Conceptual):**
-    1.  Initialize `baseOptions`.
-    2.  Initialize `staticSettingsOptions = {}`.
-    3.  **If `QRCodeJs._selectedSettings` exists:**
-        *   If `QRCodeJs._selectedSettings.options` exists, `staticSettingsOptions` is merged with `QRCodeJs._selectedSettings.options`.
-        *   The presence of `_selectedSettings` implies that `_selectedTemplate`, `_selectedStyle`, etc., would have already been set by the `QRCodeJs.settings()` static method. The existing constructor logic that processes these will pick up the values derived from `_selectedSettings`.
-    4.  The merging order would be: `baseQRTemplateOptions`, then `staticSettingsOptions` (from `_selectedSettings.options`), then options from `_selectedTemplate`, `_selectedBorder`, `_selectedText`, `_selectedStyle`, `_selectedImage` (if any), and finally `rawOptions` passed to the constructor.
-    5.  `mergeDeep` will handle the combination.
-    6.  Proceed with validation and sanitization.
-
-## IV. Implement Instance `setSettings()` Method in `qr-code-js.ts`
-
-1.  **Create Instance `setSettings()` Method:**
-    ```typescript
-    public async setSettings(settings: SettingsOptions): Promise<void> {
-      let newOptions: RecursivePartial<Options> = { ...baseQRTemplateOptions }; // Start fresh for "replace"
-
-      // 1. Apply template
-      if (settings.templateId) {
-        const foundTemplate = findTemplateById(settings.templateId);
-        if (foundTemplate) newOptions = mergeDeep(newOptions, foundTemplate.options);
-      } else if (settings.template) {
-        if (typeof settings.template === 'string') {
-          const foundTemplate = findTemplateByName(settings.template);
-          if (foundTemplate) newOptions = mergeDeep(newOptions, foundTemplate.options);
-        } else {
-          newOptions = mergeDeep(newOptions, settings.template);
-        }
-      }
-
-      // 2. Apply style
-      if (settings.styleId) {
-        const foundStyleDef = findStyleById(settings.styleId);
-        if (foundStyleDef) newOptions = mergeDeep(newOptions, mapStyleToOptions(foundStyleDef.style));
-      } else if (settings.style) {
-        if (typeof settings.style === 'string') {
-          const foundStyleDef = findStyleByName(settings.style);
-          if (foundStyleDef) newOptions = mergeDeep(newOptions, mapStyleToOptions(foundStyleDef.style));
-        } else {
-          const { isValid, errors } = validateStyleOptions(settings.style);
-          if (isValid) {
-            newOptions = mergeDeep(newOptions, mapStyleToOptions(settings.style));
-          } else {
-            console.warn('Invalid style options in setSettings:', errors);
-          }
-        }
-      }
-
-      // 3. Apply text
-      let textOptionsToApply: RecursivePartial<Options> = {};
-      let textOpts: TextOptions | null = null;
-      if (settings.textId) {
-        const foundTextTemplate = findTextTemplateById(settings.textId);
-        if (foundTextTemplate) textOpts = foundTextTemplate.options;
-      } else if (settings.text) {
-        if (typeof settings.text === 'string') {
-          const foundTextTemplate = findTextByName(settings.text);
-          if (foundTextTemplate) textOpts = foundTextTemplate.options;
-        } else {
-          textOpts = settings.text;
-        }
-      }
-      if (textOpts) {
-        // Logic to map textOpts to borderOptions.decorations (similar to constructor)
-        if (!textOptionsToApply.borderOptions) textOptionsToApply.borderOptions = {};
-        if (!textOptionsToApply.borderOptions.decorations) textOptionsToApply.borderOptions.decorations = {};
-        const decorations = textOptionsToApply.borderOptions.decorations;
-        // ... (full mapping logic for value, topValue, leftValue, etc.)
-        newOptions = mergeDeep(newOptions, textOptionsToApply);
-      }
-
-      // 4. Apply border
-      if (settings.borderId) {
-        const foundBorder = findBorderById(settings.borderId);
-        if (foundBorder) newOptions = mergeDeep(newOptions, foundBorder.options);
-      } else if (settings.border) {
-        if (typeof settings.border === 'string') {
-          const foundBorder = findBorderByName(settings.border);
-          if (foundBorder) newOptions = mergeDeep(newOptions, foundBorder.options);
-        } else { // It's RecursivePartial<BorderOptions>
-          newOptions = mergeDeep(newOptions, { borderOptions: settings.border });
-        }
-      }
-
-      // 5. Apply direct options override
-      if (settings.options) {
-        newOptions = mergeDeep(newOptions, settings.options);
-      }
-
-      // 6. Validate and sanitize the completely new options
-      const { warnings, validatedOptions } = validateQROptions(newOptions);
-      if (warnings.length > 0) {
-        this._logValidationWarnings('QR Code setSettings Validation Warnings:', warnings);
-      }
-      
-      this.options = sanitizeOptions(validatedOptions as Options); // Replace current options
-
-      // 7. Update the QR code
-      await this.update();
-    }
-    ```
-
-## V. Documentation and Tests
-
-1.  **Documentation:**
-    *   Add `SettingsOptions` to `docs/typescript-types-definitions.md`.
-    *   Document `QRCodeJs.settings()` and `instance.setSettings()` in `docs/api-reference-guide.md` and `docs/usage-guide.md`.
-    *   Clearly explain the "replace" behavior for both methods.
-    *   Provide usage examples.
-2.  **Unit Tests:**
-    *   Add comprehensive tests for static `settings()`, instance `setSettings()`, their "replace" behavior, and interactions.
-
-## Mermaid Diagram
-
-```mermaid
-graph TD
-    subgraph Initialization
-        A[Define SettingsOptions Interface in src/types/settings-options.ts]
-    end
-
-    subgraph Static/Builder Method
-        B[Add static _selectedSettings to QRCodeJs]
-        C[Implement static QRCodeJs.settings(settings)]
-        C --> C1{settings === null?}
-        C1 -- Yes --> C2[Reset _selectedSettings AND all other static config (_template, _style, etc.)]
-        C1 -- No --> C3[Reset all other static config (_template, _style, etc.)]
-        C3 --> C4[Store in _selectedSettings]
-        C4 --> C5[Apply settings.template/Id via QRCodeJs.setTemplate/Id]
-        C5 --> C6[Apply settings.style/Id via QRCodeJs.setStyle/Id]
-        C6 --> C7[Apply settings.text/Id via QRCodeJs.setText/Id]
-        C7 --> C8[Apply settings.border/Id via QRCodeJs.setBorder/Id]
-    end
-
-    subgraph Constructor Modification
-        D[Modify QRCodeJs Constructor]
-        D --> D1[If _selectedSettings exists, its .options form part of the base]
-        D --> D2[Existing logic for _selectedTemplate, _selectedStyle, etc. then applies (values may come from _selectedSettings)]
-    end
-
-    subgraph Instance Method
-        E[Implement instance.setSettings(settings)]
-        E --> E1[Start with newOptions = baseQRTemplateOptions]
-        E1 --> E2[Apply settings.template/Id to newOptions (mergeDeep)]
-        E2 --> E3[Apply settings.style/Id to newOptions (map & mergeDeep)]
-        E3 --> E4[Apply settings.text/Id to newOptions (convert & mergeDeep)]
-        E4 --> E5[Apply settings.border/Id to newOptions (mergeDeep)]
-        E5 --> E6[Apply settings.options to newOptions (mergeDeep)]
-        E6 --> E7[Validate and Sanitize newOptions]
-        E7 --> E8[this.options = sanitizedNewOptions (REPLACE)]
-        E8 --> E9[Call this.update()]
-    end
-
-    subgraph Documentation & Testing
-        F[Update Documentation (Type, Static Method, Instance Method)]
-        G[Add Unit Tests (Static, Instance, Interactions, Replace Behavior)]
-    end
-
-    A --> C
-    A --> E
-    C8 --> D1
-    E9 --> G
-    F --> G

package/docs/template-update-plan.md

@@ -1,53 +0,0 @@
-# Plan: Update Documentation for `useTemplates` Feature
-
-**Objective:** Update the documentation in the `docs` directory to accurately reflect the template features, including modifying `useTemplate` to accept options directly and ensuring both `setTemplate` and the updated `useTemplate` builder pattern are correctly documented.
-
-## Phase 1: Code Modification (To be done in Code Mode)
-
-1.  **Modify `useTemplate` Signature:**
-    *   In `src/index.ts`, change `QRCodeJs.useTemplate(templateName: string)` to `QRCodeJs.useTemplate(templateNameOrOptions: string | RecursivePartial<Options>)`.
-    *   In `src/node.ts`, make the same change: `QRCodeJs.useTemplate(templateNameOrOptions: string | RecursivePartial<Options>)`.
-2.  **Modify `QRCodeBuilder` Constructor:**
-    *   In `src/index.ts`, update the `QRCodeBuilder` constructor to handle the `templateNameOrOptions` parameter. If it's a string, look up the template; if it's an object, use it directly as the base configuration.
-    *   In `src/node.ts`, make the corresponding change to the `QRCodeBuilder` constructor.
-
-## Phase 2: Documentation Update (Reflecting Both Methods)
-
-1.  **`docs/examples.md`:**
-    *   **`setTemplate` Section:** Ensure this section accurately explains setting global template defaults.
-    *   **`useTemplate` Section:** Update this section to:
-        *   Explain the builder pattern: `QRCodeJs.useTemplate(...).options({...})`.
-        *   Show examples using a template name: `useTemplate('rounded').options(...)`.
-        *   Show examples providing options directly: `useTemplate({ dotsOptions: {...} }).options(...)`.
-        *   Clarify that `.options()` is always needed to provide `data` and final overrides.
-
-2.  **`docs/usage-guide.md`:**
-    *   **`setTemplate`:** Verify its documentation is correct.
-    *   **`useTemplate`:** Update its description to reflect the new signature (`string | RecursivePartial<Options>`) and explain its use in the builder pattern.
-    *   **Static Methods List:** Ensure both `setTemplate` and the updated `useTemplate` are listed correctly.
-
-3.  **`docs/documentation.md`:**
-    *   **Verify `setTemplate`:** Ensure it's correctly described throughout (main body, API reference, FAQ).
-    *   **Update `useTemplate`:** Update its description in the API reference section to show the new signature and explain the builder pattern usage.
-
-4.  **`docs/api-reference-guide.md`:**
-    *   **Verify `setTemplate`:** Ensure it's listed correctly in the methods table.
-    *   **Update `useTemplate`:** Update the parameter type to `string | RecursivePartial<Options>` and clarify its role in initiating the builder pattern.
-
-5.  **Review Other Files:** Briefly check `advanced-examples.md`, `typescript-types-definitions.md`, and `license-management.md` for consistency regarding both `setTemplate` and the updated `useTemplate`.
-
-## Conceptual Flow Diagram (`useTemplate`)
-
-```mermaid
-graph LR
-    subgraph useTemplate Flow
-        A[User Code] --> B{QRCodeJs.useTemplate(nameOrOptions)};
-        B -- name --> C[Lookup Template];
-        B -- options --> D[Use Provided Options];
-        C --> E{QRCodeBuilder Instance};
-        D --> E;
-        A --> F(Specific Options e.g., data);
-        E --> G(builder.options(Specific Options));
-        F --> G;
-        G --> H(Final QRCodeJs Instance);
-    end