@qr-platform/qr-code.js 0.10.1 → 0.10.3

package/docs/usage-guide.md

@@ -341,12 +341,13 @@ const qrCodeWithLogo = new QRCodeJs({
 | `value`                | `string`             | `''`           | The text content or image URL/data URI.                                                                                                |
 | `enableText`           | `boolean`            | `false`        | Enables the decoration for this side.                                                                                                  |
 | `disabled`             | `boolean`            | `false`        | Disables the decoration for this side.                                                                                                 |
-| `style`                | `object`             | `{}`           | Text styling options (`fontFace`, `fontSize`, `fontColor`, `letterSpacing`, `fontWeight`).                                              |
+| `style`                | `object`             | `{}`           | Text styling options (`fontFace`, `fontSize`, `fontColor`, `letterSpacing`, `fontWeight`).                                             |
 | `style.fontFace`       | `string`             | `'Helvetica'`  | The font face for the text.                                                                                                            |
 | `style.fontSize`       | `number`             | `28`           | The font size for the text in pixels.                                                                                                  |
 | `style.fontColor`      | `string`             | `'#ffffff'`    | The color of the text.                                                                                                                 |
 | `style.letterSpacing`  | `number`             | `0`            | The letter spacing for the text in pixels.                                                                                             |
-| `style.fontWeight`     | `'normal' \| 'bold'` | `'normal'`     | The font weight for the text.                                                                                                          |
+| `style.fontWeight`     | `'normal' \| 'bold'` | `'bold'`       | The font weight for the text.                                                                                                          |
+| `style.textTransform`  | `'uppercase' \| 'lowercase' \| 'capitalize'` | `'uppercase'` | The text transformation style.                                                                                  |
 | `offset`               | `number`             | `0`            | Vertical (top/bottom) or horizontal (left/right) offset from the border center.                                                        |
 | `curveDisabled`        | `boolean`            | `false`        | If `true`, text is drawn straight instead of curved along the border.                                                                  |
 | `curveRadius`          | `string`             | `'50%'`        | Overrides the curve radius for text (e.g., `'50%'`). Defaults to `borderOptions.radius`.                                               |
@@ -500,67 +501,62 @@ if (validationResult.isValid) {
 - **`validateScanning(): Promise<{ isValid: boolean; decodedText?: string; message?: string }>`**
   Validates that the QR code is scannable (Premium feature).
 
-#### Static Methods
-
-- **`QRCodeJs.license(licenseKey: string): Promise<ValidationResult>`**
-  Activates a license using a license key.
-
-- **`QRCodeJs.token(token: string | null): Promise<ValidationResult>`**
-  Activates a license using a pre-fetched JWT token.
-
-- **`QRCodeJs.getLicenseDetails(): DecodedLicenseToken | null`**
-  Retrieves current license information.
-
-- **`QRCodeJs.setLicenseUrl(url: string): void`**
-  Sets the URL endpoint for license key validation.
-
-- **`QRCodeJs.configureLicenseFetcher(fetcher: (licenseKey: string) => Promise<string>): void`**
-  Configures a custom function for fetching license tokens.
-
-- **`QRCodeJs.setTemplate(templateNameOrOptions: string | RecursivePartial<Options>): void`**
-  Sets a global default template (by name or options object) for subsequent instances.
-
-- **`QRCodeJs.setTemplateId(templateId: string): void`**
-  Sets a global default template by its ID.
 
-- **`QRCodeJs.setStyle(styleNameOrOptions: string | StyleOptions): void`**
-  Sets a global default style (by name or options object) for subsequent instances.
-
-- **`QRCodeJs.setStyleId(styleId: string): void`**
-  Sets a global default style by its ID.
-
-- **`QRCodeJs.setBorder(borderNameOrOptions: string | RecursivePartial<BorderOptions>): void`**
-  Sets a global default border configuration (by name or options object) for subsequent instances.
-
-- **`QRCodeJs.setBorderId(borderId: string): void`**
-  Sets a global default border configuration by its ID.
-
-- **`QRCodeJs.useTemplate(templateNameOrOptions: string | RecursivePartial<Options>): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a template (by name or options object).
-
-- **`QRCodeJs.useTemplateId(templateId: string): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a template by its ID.
+#### Static Methods
 
-- **`QRCodeJs.useStyle(styleNameOrOptions: string | StyleOptions): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a style (by name or options object).
+These methods are called directly on the `QRCodeJs` class (e.g., `QRCodeJs.setTemplate(...)`).
+
+- **License Management:**
+  - `QRCodeJs.license(licenseKey: string): Promise<ValidationResult>`: Activates a license using a license key.
+  - `QRCodeJs.token(token: string | null): Promise<ValidationResult>`: Activates a license using a pre-fetched JWT token.
+  - `QRCodeJs.getLicenseDetails(): DecodedLicenseToken | null`: Retrieves current license information.
+  - `QRCodeJs.setLicenseUrl(url: string): void`: Sets the URL endpoint for license key validation.
+  - `QRCodeJs.configureLicenseFetcher(fetcher: (licenseKey: string) => Promise<string>): void`: Configures a custom function for fetching license tokens.
+
+- **Global Configuration Defaults:**
+  - `QRCodeJs.setTemplate(templateNameOrOptions: string | RecursivePartial<Options> | null): typeof QRCodeJs`: Sets a global default template.
+  - `QRCodeJs.setTemplateId(templateId: string | null): typeof QRCodeJs`: Sets a global default template by its ID.
+  - `QRCodeJs.setStyle(styleNameOrOptions: string | StyleOptions | null): typeof QRCodeJs`: Sets a global default style.
+  - `QRCodeJs.setStyleId(styleId: string | null): typeof QRCodeJs`: Sets a global default style by its ID.
+  - `QRCodeJs.setBorder(borderNameOrOptions: string | RecursivePartial<BorderOptions> | null): typeof QRCodeJs`: Sets a global default border configuration.
+  - `QRCodeJs.setBorderId(borderId: string | null): typeof QRCodeJs`: Sets a global default border configuration by its ID.
+  - `QRCodeJs.setText(textNameOrOptions: string | TextOptions | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs`: Sets global default border text. `overrideOpts` (e.g., `{ override: true }`) ensures precedence.
+  - `QRCodeJs.setTextId(textId: string | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs`: Sets global default border text by ID. `overrideOpts` ensures precedence.
+  - `QRCodeJs.setImage(imageUrl: string | DataURL | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs`: Sets a global default image. `overrideOpts` ensures precedence.
+  - `QRCodeJs.setData(data: string | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs`: Sets a global default data string. `overrideOpts` ensures precedence.
+  - `QRCodeJs.setOptions(options: RecursivePartial<Options> | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs`: Sets global default options (merged deeply). `overrideOpts` ensures higher precedence.
+  - `QRCodeJs.setSettings(settings: SettingsOptions | null): typeof QRCodeJs`: Sets multiple global defaults from a `SettingsOptions` object. Acts as a macro, calling other static setters. Clears all static defaults if `null` is passed. See [Centralized Settings Configuration](#centralized-settings-configuration-settingsoptions-setsettings-and-usesettings) for more details.
+
+**Example: Setting Global Data and Options**
+```typescript
+// Set global data that will be used if no data is provided at instantiation
+QRCodeJs.setData('https://www.default-link.com');
 
-- **`QRCodeJs.useStyleId(styleId: string): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a style by its ID.
+// Set global options for margin and error correction
+QRCodeJs.setOptions({
+  margin: 15,
+  qrOptions: { errorCorrectionLevel: 'M' }
+});
 
-- **`QRCodeJs.useBorder(borderNameOrOptions: string | BorderOptions): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a border configuration (by name or options object).
+// This QR code will use the global data, margin, and error correction level
+const qrWithGlobalSettings = new QRCodeJs({}); // Data is optional now
+qrWithGlobalSettings.append(document.getElementById('qr-global-container'));
 
-- **`QRCodeJs.useBorderId(borderId: string): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with a border configuration by its ID.
+// Override global data with an instance-specific value
+const qrOverrideData = new QRCodeJs({ data: 'https://specific-link.com' });
+// qrOverrideData will use 'https://specific-link.com', but still use global margin and EC level.
 
-- **`QRCodeJs.setImage(imageUrl: string | DataURL | null): void`**
-  Sets a global default image URL for subsequent `QRCodeJs` instances.
+// Using override to make global data sticky
+QRCodeJs.setData('https://sticky-link.com', { override: true });
+const qrStickyData = new QRCodeJs({ data: 'https://ignored-link.com' });
+// qrStickyData will use 'https://sticky-link.com' due to the override.
 
-- **`QRCodeJs.useImage(imageUrl: string | DataURL): QRCodeBuilder`**
-  Initiates the builder pattern pre-configured with an image URL.
+// Clear global settings when no longer needed
+QRCodeJs.setData(null);
+QRCodeJs.setOptions(null);
+```
 
 ### Setting Global Defaults for Styles, Borders, and Images (`setStyle`, `setBorder`, `setImage`)
-
 Similar to `setTemplate`, you can set global defaults for styles, border configurations, and images that will apply to subsequently created instances:
 
 - **`QRCodeJs.setStyle(styleNameOrOptions)` / `QRCodeJs.setStyleId(styleId)`**: Sets a default style by name, object, or ID.
@@ -603,17 +599,144 @@ const qrCode = QRCodeJs.useTemplate('dots')       // Base: dots template (e.g.,
 
 qrCode.append(document.getElementById('builder-example-container'));
 
-### Builder Pattern for Styles, Borders, and Images (`useStyle`, `useBorder`, `useImage`)
 
-The builder pattern fully supports styles, borders, and images:
+### Builder Pattern Methods (`useStyle`, `useBorder`, `useImage`, `useData`, `useOptions`, `useSettings`)
+
+These methods are called on `QRCodeJs` to initiate a builder chain (e.g., `QRCodeJs.useStyle(...)`) or on an existing `QRCodeBuilder` instance (e.g., `builder.useStyle(...)`).
+
+- **`useStyle(styleNameOrOptions)` / `useStyleId(styleId)`**: Applies a style.
+- **`useBorder(borderNameOrOptions)` / `useBorderId(borderId)`**: Applies a border configuration.
+- **`useImage(imageUrl, overrideOpts?)`**: Sets an image. `overrideOpts` ensures precedence over image in final `.options()`.
+- **`useData(data, overrideOpts?)`**: Sets the data. `overrideOpts` ensures precedence over data in final `.options()`.
+- **`useOptions(options, overrideOpts?)`**: Merges general options. `overrideOpts` ensures precedence for these specific options over final `.options()`.
+- **`useSettings(settings)`**: Applies a comprehensive `SettingsOptions` object as a new baseline for the builder chain, **resetting** any configurations previously applied to *that builder instance* via other `use...` methods.
+
+You can chain these methods (e.g., `QRCodeJs.useTemplate(...).useStyle(...).useBorder(...).useImage(...)`) before finalizing with `.options(...)` or `.build()`. Options are merged progressively, with later calls overriding earlier ones for the same properties, unless an `override: true` was used.
+
+**Example: Using Builder Methods**
+```typescript
+// Start with a template, layer on a style, then specific data and options
+const qrBuilt = QRCodeJs.useTemplate('dots') // Start with 'dots' template
+  .useStyle({ dotsOptions: { color: 'green' } }) // Override dot color to green
+  .useData('https://example.com/builder-path') // Set data via builder
+  .useOptions({ margin: 5 }) // Set margin via builder
+  .options({ qrOptions: { errorCorrectionLevel: 'Q' } }); // Final options, builds the instance
+
+qrBuilt.append(document.getElementById('qr-builder-container'));
+
+// Using useData with override
+const qrBuilderDataOverride = QRCodeJs.useTemplate('rounded')
+  .useData('https://forced-builder-link.com', { override: true })
+  .options({ data: 'https://this-data-is-ignored.com' }); // Data from useData takes precedence
+
+qrBuilderDataOverride.append(document.getElementById('qr-builder-data-override'));
+```
+
+---
+
+## Centralized Settings Configuration (`SettingsOptions`, `setSettings`, and `useSettings`)
+
+For a comprehensive way to define or apply a complete QR code configuration in one go, QRCode.js provides:
+- A `SettingsOptions` interface to structure a full configuration.
+- A static `QRCodeJs.setSettings()` method for establishing global defaults using a `SettingsOptions` object.
+- A `useSettings()` method for the `QRCodeBuilder` to apply a `SettingsOptions` object as a baseline for a specific builder chain.
+
+### `SettingsOptions` Object
+
+The `SettingsOptions` interface allows you to define multiple aspects of a QR code configuration simultaneously, including `id`, `name`, `description`, `data`, `image`, `template`/`templateId`, `style`/`styleId`, `text`/`textId`, `border`/`borderId`, and a general `options` field for direct overrides.
+
+Refer to the [TypeScript Types and Definitions](./typescript-types-definitions.md#settingsoptions) for the full structure.
+
+### Static `QRCodeJs.setSettings(settings: SettingsOptions | null)`
+
+This static method is used to set multiple global defaults at once using a comprehensive `SettingsOptions` object.
+
+- **Behavior**: It acts as a macro, internally calling other static setters (like `QRCodeJs.setTemplate()`, `QRCodeJs.setStyle()`, `QRCodeJs.setData()`, `QRCodeJs.setImage()`, `QRCodeJs.setOptions()`, etc.) based on the properties provided in the `settings` object. It will **override/reset** any previously set static configurations for the aspects it covers.
+- If `null` is passed, all static configurations (template, style, text, border, image, data, and options) are cleared.
 
-- **`QRCodeJs.useStyle(styleNameOrOptions)` / `QRCodeJs.useStyleId(styleId)`**: Starts the builder pre-configured with a style.
-- **`QRCodeJs.useBorder(borderNameOrOptions)` / `QRCodeJs.useBorderId(borderId)`**: Starts the builder pre-configured with a border configuration.
-- **`QRCodeJs.useImage(imageUrl)`**: Starts the builder pre-configured with an image.
+**Example: Using Static `setSettings()`**
+
+```typescript
+const myCompanyPreset: SettingsOptions = {
+  name: 'CompanyStandardQR',
+  description: 'Standard QR code style for company communications.',
+  data: 'https://company.website.com', // Default data
+  image: 'https://company.website.com/assets/logo.png', // Default image
+  templateId: 'modern-dark', // Assumes this template ID exists
+  style: { dotsOptions: { color: '#00447C' } }, // Company blue dots
+  borderOptions: { hasBorder: true, thickness: 10, color: '#00447C' },
+  options: { // General options
+    margin: 10,
+    qrOptions: { errorCorrectionLevel: 'Q' }
+  }
+};
+
+QRCodeJs.setSettings(myCompanyPreset);
+
+// This instance will use the 'CompanyStandardQR' preset
+const qrFromPreset = new QRCodeJs({ /* Data can be omitted if in preset */ });
+qrFromPreset.append(document.getElementById('qr-preset-container'));
+
+// Override specific parts of the preset for another instance
+const qrModifiedPreset = new QRCodeJs({
+  data: 'https://company.website.com/specific-campaign', // Override data
+  image: 'https://company.website.com/assets/campaign-logo.png' // Override image
+  // Other settings like template, style, border, margin, EC level from preset still apply
+});
+qrModifiedPreset.append(document.getElementById('qr-modified-preset-container'));
 
-You can chain these methods (e.g., `QRCodeJs.useTemplate(...).useStyle(...).useBorder(...).useImage(...)`) before finalizing with `.options(...)` or `.build()`. Options are merged progressively, with later calls overriding earlier ones.
+// Clearing all static settings
+QRCodeJs.setSettings(null);
+const qrAfterClear = new QRCodeJs({ data: 'https://another.link.com/after-clear' }); // Uses base defaults, requires data
+qrAfterClear.append(document.getElementById('qr-cleared-container'));
 ```
 
+### Builder `useSettings(settings: SettingsOptions)`
+
+The `QRCodeBuilder.useSettings(settings: SettingsOptions)` method applies a `SettingsOptions` object as a new baseline for a specific builder chain.
+
+- **Behavior**: Calling `useSettings()` on a builder instance will **reset** any configurations previously applied to *that builder instance* via methods like `useTemplate()`, `useStyle()`, `useBorder()`, `useText()`, `useImage()`, `useData()`, or `useOptions()`. The provided `settings` object then establishes the new comprehensive baseline for that builder.
+- Subsequent builder methods chained *after* `useSettings()` (e.g., `.useStyle()`, `.options()`) will then modify this new baseline.
+
+**Example: Using Builder `useSettings()`**
+```typescript
+const eventSpecificConfig: SettingsOptions = {
+  name: 'TechConference2024',
+  data: 'https://techconf.example/schedule', // Baseline data for this builder
+  image: 'https://techconf.example/assets/event-banner-qr.png', // Baseline image
+  styleId: 'modern-dark', // Assumes 'modern-dark' style ID exists
+  text: { // Border text configuration
+    topValue: 'Tech Conference 2024',
+    bottomValue: 'Scan for Schedule & Info'
+  },
+  borderOptions: {
+    hasBorder: true,
+    thickness: 25,
+    color: '#333333',
+    radius: '5px'
+  },
+  options: { // Baseline general options
+    qrOptions: { errorCorrectionLevel: 'H' },
+    isResponsive: true
+  }
+};
+
+const qrEvent = QRCodeJs.useTemplate('basic') // Initial template (will be reset by useSettings)
+  .useStyle({ dotsOptions: { color: 'red'} }) // This style will also be reset
+  .useSettings(eventSpecificConfig) // Resets builder and applies eventSpecificConfig as baseline
+  .useStyle({ // Further refine the style from useSettings
+    dotsOptions: { gradient: { type: 'linear', colorStops: [{offset:0, color:'blue'}, {offset:1, color:'green'}] } }
+  })
+  .options({ // Final data override and other specific options
+    data: 'https://techconf.example/live-updates', // Overrides data from eventSpecificConfig
+    margin: 5 // Overrides margin if it was part of eventSpecificConfig.options
+  })
+  .build();
+
+qrEvent.append(document.getElementById('event-qr-container'));
+```
+---
+
 ## FAQ
 ### How do I handle CORS issues with embedded images?
 
@@ -710,7 +833,7 @@ const qrCodePremium = new QRCodeJs({
       bottom: {
         type: 'text',
         value: 'LICENSED FEATURE',
-        style: { fontColor: '#FFFFFF', fontSize: 18, fontWeight: '500' },
+        style: { fontColor: '#FFFFFF', fontSize: 18, fontWeight: 'bold' },
         curveDisabled: true // Straight text
       }
     }
@@ -728,3 +851,55 @@ const qrCodePremium = new QRCodeJs({
 - [License Management](./license-management.md#start)
 - [Basic Examples](./examples.md#start)
 - [Advanced Examples](./advanced-examples.md#start)
+
+</file_content>
+
+Now that you have the latest state of the file, try the operation again with fewer, more precise SEARCH blocks. For large files especially, it may be prudent to try to limit yourself to <5 SEARCH/REPLACE blocks at a time, then wait for the user to respond with the result of the operation before following up with another replace_in_file call to make additional edits.
+(If you run into this error 3 times in a row, you may use the write_to_file tool as a fallback.)
+</error><environment_details>
+# VSCode Visible Files
+docs/usage-guide.md
+
+# VSCode Open Tabs
+src/types/text-options.ts
+src/core/templates/qr-templates.ts
+src/core/qr-code-js.ts
+src/index.ts
+src/node.ts
+docs/ft009-settings-option-continuation-plan.md
+tests/node/node.settings.test.ts
+docs/api-reference-guide.md
+docs/usage-guide.md
+src/types/settings-options.ts
+src/index.html
+src/node-pdf-demo.js
+src/options-demo.ts
+src/templates/borders-templates.html
+docs/documentation.md
+tests/node/node.text-image.test.ts
+docs/ft009-settings-option-plan.md
+../../../../../Untitled-2
+../../../../../Untitled-1
+docs/typescript-types-definitions.md
+src/license/LicenseManager.ts
+rollup.config.ts
+package.json
+node_modules/rollup-plugin-minify-template-literals/dist/index.d.ts
+src/config/runtime-config.js
+src/core/templates/qr-styles-dark.ts
+src/core/qr-svg.ts
+src/templates/borders-inner-outter.ts
+src/demo.ts
+src/core/templates/qr-template-borders.ts
+src/core/templates/qr-styles.ts
+docs/border-text-implementation-plan.md
+
+# Current Time
+5/11/2025, 5:15:20 PM (America/New_York, UTC-4:00)
+
+# Context Window Usage
+258,040 / 1,048.576K tokens used (25%)
+
+# Current Mode
+ACT MODE
+</environment_details>

package/lib/core/qr-code-js.d.ts

@@ -1,5 +1,6 @@
 import { CanvasOptions } from '~/utils/canvas-options';
 import { MethodOverrideOptions, RecursivePartial } from '../types/helper';
+import { SettingsOptions } from '../types/settings-options';
 import { StyleOptions } from '../types/style-options';
 import { QRTextTemplateDefinition, TextOptions } from '../types/text-options';
 import { BorderOptions, Options } from '../utils/options';
@@ -25,6 +26,10 @@ export declare class QRCodeJs {
     private static _selectedImageOverride;
     private static _selectedText;
     private static _selectedTextOverride;
+    private static _selectedData;
+    private static _selectedDataOverride;
+    private static _selectedOptions;
+    private static _selectedOptionsOverride;
     private options;
     private container?;
     private qr?;
@@ -36,7 +41,7 @@ export declare class QRCodeJs {
         width: number;
         height: number;
     } | undefined;
-    constructor(options: RecursivePartial<Options>, _?: boolean);
+    constructor(options: RecursivePartial<Options> | undefined, _?: boolean);
     /**
      * Sets the static template to be used as a base for new instances,
      * accepting either a template name or a template options object.
@@ -97,6 +102,13 @@ export declare class QRCodeJs {
      * @returns The QRCodeJs class for chaining.
      */
     static setImage(imageUrl: string | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs;
+    /**
+     * Sets the static Data to be used by new instances.
+     * @param data - The data to be encoded in the QR code.
+     * @returns The QRCodeJs class for chaining.
+     */
+    static setData(data: string | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs;
+    static setOptions(options: RecursivePartial<Options> | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs;
     /**
      * Sets the static text template or options to be used for new instances.
      * @param textNameOrOptions - The name of the text template, a TextOptions object, or null to clear.
@@ -109,6 +121,7 @@ export declare class QRCodeJs {
      * @returns The QRCodeJs class for chaining.
      */
     static setTextId(textId: string | null, overrideOpts?: MethodOverrideOptions): typeof QRCodeJs;
+    static setSettings(settings: SettingsOptions | null): typeof QRCodeJs;
     getOptions(): Options;
     update(options?: RecursivePartial<Options>): Promise<void>;
     append(container?: HTMLElement): this;

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 import { QRCodeJs as _QRCodeJs } from './core/qr-code-js';
 import { MethodOverrideOptions, RecursivePartial } from './types/helper';
+import { SettingsOptions } from './types/settings-options';
 import { StyleOptions } from './types/style-options';
 import { TextOptions } from './types/text-options';
 import { type Options as _QRCodeJsOptions, type BorderOptions } from './utils/options';
@@ -115,14 +116,18 @@ export declare class QRCodeJs extends _QRCodeJs {
      * @returns A new QRCodeBuilder instance.
      */
     static useTextId(textId: string, overrideOpts?: MethodOverrideOptions): QRCodeBuilder;
+    static useData(data: string, overrideOpts?: MethodOverrideOptions): QRCodeBuilder;
+    static useOptions(options: RecursivePartial<Options>, // Changed from Options to RecursivePartial<Options>
+    overrideOpts?: MethodOverrideOptions): QRCodeBuilder;
+    static useSettings(settings: SettingsOptions): QRCodeBuilder;
 }
 export declare class _ extends QRCodeJs {
     protected _hls(): boolean;
     constructor(options: Options);
 }
-declare class QRCodeBuilder {
+export declare class QRCodeBuilder {
     private _qrCodeConstructor;
-    protected _templateSource: string | Options | null;
+    protected _templateSource: string | RecursivePartial<Options> | null;
     protected _borderSource: string | BorderOptions | null;
     protected _styleSource: string | StyleOptions | null;
     protected _imageSource: string | null;
@@ -133,83 +138,25 @@ declare class QRCodeBuilder {
     protected _isBorderById: boolean;
     protected _isStyleById: boolean;
     protected _isTextById: boolean;
-    protected _initialOptions: Options | null;
-    /**
-     * Creates a new QRCodeBuilder instance.
-     * @param qrCodeConstructor - The constructor function (QRCodeJs or _) to use for the final instance.
-     * @param templateNameOrOptions - Optional name of a predefined template or a partial options object to start with.
-     */
-    constructor(qrCodeConstructor: QRCodeJsConstructor, templateNameOrOptions?: string | Options);
-    /**
-     * Sets the template to use by its name. Overwrites any previously set template.
-     * @param templateName - The user-friendly name of the template to apply.
-     * @returns The builder instance for chaining.
-     */
+    protected _optionsSource: RecursivePartial<Options> | null;
+    protected _optionsOverride: boolean;
+    protected _dataSource: string | null;
+    protected _dataOverride: boolean;
+    protected _initialOptions: RecursivePartial<Options> | null;
+    constructor(qrCodeConstructor: QRCodeJsConstructor, templateNameOrOptions?: string | RecursivePartial<Options>);
     useTemplate(templateName: string): this;
-    /**
-     * Sets the template to use by its ID. Overwrites any previously set template.
-     * @param templateId - The ID (original key) of the template to apply.
-     * @returns The builder instance for chaining.
-     */
     useTemplateId(templateId: string): this;
-    /**
-     * Sets the style to use by its name or a style options object. Overwrites any previously set style.
-     * @param styleNameOrOptions - Name of a predefined style or a StyleOptions object to apply.
-     * @returns The builder instance for chaining.
-     */
     useStyle(styleNameOrOptions: string | StyleOptions): this;
-    /**
-     * Sets the style to use by its ID. Overwrites any previously set style.
-     * @param styleId - ID of the predefined style to apply.
-     * @returns The builder instance for chaining.
-     */
     useStyleId(styleId: string): this;
-    /**
-     * Sets the border to use by its name or a border options object. Overwrites any previously set border.
-     * @param borderNameOrOptions - Name of a predefined border or a BorderOptions object to apply.
-     * @returns The builder instance for chaining.
-     */
     useBorder(borderNameOrOptions: string | BorderOptions): this;
-    /**
-     * Sets the border to use by its ID. Overwrites any previously set border.
-     * @param borderId - ID of the predefined border to apply.
-     * @returns The builder instance for chaining.
-     */
     useBorderId(borderId: string): this;
-    /**
-     * Sets the image to use. Overwrites any previously set image from other sources like templates.
-     * @param imageUrl - The URL or data URL of the image to apply.
-     * @returns The builder instance for chaining.
-     */
     useImage(imageUrl: string, overrideOpts?: MethodOverrideOptions): this;
-    /**
-     * Sets the text to use by its name or a text options object. Overwrites any previously set text.
-     * @param textNameOrOptions - Name of a predefined text template or a TextOptions object to apply.
-     * @returns The builder instance for chaining.
-     */
+    useData(data: string, overrideOpts?: MethodOverrideOptions): this;
     useText(textNameOrOptions: string | TextOptions, overrideOpts?: MethodOverrideOptions): this;
-    /**
-     * Sets the text to use by its ID. Overwrites any previously set text.
-     * @param textId - ID of the predefined text template to apply.
-     * @returns The builder instance for chaining.
-     */
     useTextId(textId: string, overrideOpts?: MethodOverrideOptions): this;
-    /**
-     * Resolves the template, border, style, and image sources and merges them in the correct order.
-     * Order: Base Template -> Selected Template -> Selected Border -> Selected Text -> Selected Style -> Selected Image -> Final Options
-     * @param finalOptions - The final options object passed to .options() or .build().
-     * @returns The fully resolved and merged Options object.
-     */
+    useOptions(options: RecursivePartial<Options>, overrideOpts?: MethodOverrideOptions): this;
+    useSettings(settings: SettingsOptions): this;
     private _resolveAndMergeConfig;
-    /**
-     * Merges the provided options into the builder's configuration and creates the QRCodeJs instance.
-     * @param options - A partial options object to merge as the final step.
-     * @returns The created QRCodeJs instance.
-     */
-    options(options: Options): QRCodeJs;
-    /**
-     * Builds the QRCodeJs instance with the accumulated configuration.
-     * @returns The created QRCodeJs instance.
-     */
+    options(options: RecursivePartial<Options>): QRCodeJs;
     build(): QRCodeJs;
 }