@su-labs/font-size 21.0.5 → 22.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [22.0.0] - 2026-11-04
9
+
10
+ ### Changed
11
+ - Upgrade to Angular 22 (peer dependencies now `^22.0.0`)
12
+ - Remove emojis from README.md
13
+
8
14
  ## [21.0.5] - 2026-02-04
9
15
 
10
16
  ### Changed
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  `@su-labs/font-size`
4
4
 
5
5
  ![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white)
6
- ![Angular Version](https://img.shields.io/badge/Angular-v21-DD0031?style=for-the-badge&logo=angular&logoColor=white)
6
+ ![Angular Version](https://img.shields.io/badge/Angular-v22-DD0031?style=for-the-badge&logo=angular&logoColor=white)
7
7
  ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
8
8
  ![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)
9
9
  ![NPM](https://img.shields.io/badge/NPM-CB3837?style=for-the-badge&logo=npm&logoColor=white)
@@ -13,7 +13,7 @@
13
13
 
14
14
  An accessible Angular service for managing font size preferences. Provides reactive controls for text scaling, user preference persistence, and WCAG-compliant font size management.
15
15
 
16
- ## 📚 Table of Contents
16
+ ## Table of Contents
17
17
 
18
18
  - [Why Use This Library?](#-why-use-this-library)
19
19
  - [Features](#features)
@@ -30,17 +30,17 @@ An accessible Angular service for managing font size preferences. Provides react
30
30
  - [Contributing](#contributing)
31
31
  - [License](#license)
32
32
 
33
- ## 💡 Why Use This Library?
33
+ ## Why Use This Library?
34
34
 
35
- - 🎯 **Lightweight** - Minimal bundle size
36
- - ⚡ **Reactive** - Built with Angular Signals
37
- - ♿ **Accessible** - WCAG 2.1 AA compliant
38
- - 💾 **Persistent** - Remembers user preference
39
- - 🎨 **CSS Variables** - Modern implementation
40
- - 🔒 **Type-Safe** - Full TypeScript support
41
- - 📦 **Zero Dependencies** - No bloat
42
- - 🧪 **Well Tested** - Comprehensive test coverage
43
- - 📝 **Well Documented** - Clear examples and API docs
35
+ - **Lightweight** - Minimal bundle size
36
+ - **Reactive** - Built with Angular Signals
37
+ - **Accessible** - WCAG 2.1 AA compliant
38
+ - **Persistent** - Remembers user preference
39
+ - **CSS Variables** - Modern implementation
40
+ - **Type-Safe** - Full TypeScript support
41
+ - **Zero Dependencies** - No bloat
42
+ - **Well Tested** - Comprehensive test coverage
43
+ - **Well Documented** - Clear examples and API docs
44
44
 
45
45
  ## Features
46
46
 
@@ -64,10 +64,10 @@ npm install @su-labs/font-size
64
64
  This library requires the following peer dependencies:
65
65
 
66
66
  ```sh
67
- npm install @angular/common@^21 @angular/core@^21
67
+ npm install @angular/common@^22 @angular/core@^22
68
68
  ```
69
69
 
70
- ## 🚀 Quick Start
70
+ ## Quick Start
71
71
 
72
72
  ```typescript
73
73
  // 1. Install
@@ -209,7 +209,7 @@ h2 {
209
209
  }
210
210
  ```
211
211
 
212
- ## 📖 API Reference
212
+ ## API Reference
213
213
 
214
214
  ### Service (SuFontSizeService)
215
215
 
@@ -257,9 +257,9 @@ interface SuFontSizeConfig {
257
257
 
258
258
  This library helps meet WCAG 2.1 guidelines:
259
259
 
260
- - ✅ **Success Criterion 1.4.4** - Text can be resized up to 200% without loss of content or functionality
261
- - ✅ **Success Criterion 1.4.8** - User can select foreground and background colors (when combined with theme management)
262
- - ✅ **Success Criterion 1.4.12** - Text spacing is adjustable
260
+ - **Success Criterion 1.4.4** - Text can be resized up to 200% without loss of content or functionality
261
+ - **Success Criterion 1.4.8** - User can select foreground and background colors (when combined with theme management)
262
+ - **Success Criterion 1.4.12** - Text spacing is adjustable
263
263
 
264
264
  ### Best Practices
265
265
 
@@ -269,13 +269,13 @@ This library helps meet WCAG 2.1 guidelines:
269
269
  4. **Persist preference** - Always save user preference (enabled by default)
270
270
  5. **Respect system settings** - Consider reading system font size preferences
271
271
 
272
- ## 🌐 Browser Compatibility
272
+ ## Browser Compatibility
273
273
 
274
274
  Works in all modern browsers that support:
275
- - ✅ CSS Custom Properties
276
- - ✅ localStorage API
277
- - ✅ Angular 21+
278
- - ✅ ES2022+
275
+ - CSS Custom Properties
276
+ - localStorage API
277
+ - Angular 22+
278
+ - ES2022+
279
279
 
280
280
  | Browser | Version |
281
281
  |---------|---------|
@@ -284,16 +284,16 @@ Works in all modern browsers that support:
284
284
  | Safari | ≥ 14 |
285
285
  | Edge | ≥ 90 |
286
286
 
287
- ## 🔗 Related Libraries
287
+ ## Related Libraries
288
288
 
289
289
  Part of the **@su-labs** suite:
290
290
 
291
- - 👀 [@su-labs/visit-tracker](https://www.npmjs.com/package/@su-labs/visit-tracker) - User visit tracking
292
- - 🎨 [@su-labs/theme](https://www.npmjs.com/package/@su-labs/theme) - Theme management with dark mode support
293
- - 🔔 [@su-labs/notifications](https://www.npmjs.com/package/@su-labs/notifications) - Toast notification system
294
- - 🔍 [@su-labs/scroll-spy](https://www.npmjs.com/package/@su-labs/scroll-spy) - Scroll position tracking
291
+ - [@su-labs/visit-tracker](https://www.npmjs.com/package/@su-labs/visit-tracker) - User visit tracking
292
+ - [@su-labs/theme](https://www.npmjs.com/package/@su-labs/theme) - Theme management with dark mode support
293
+ - [@su-labs/notifications](https://www.npmjs.com/package/@su-labs/notifications) - Toast notification system
294
+ - [@su-labs/scroll-spy](https://www.npmjs.com/package/@su-labs/scroll-spy) - Scroll position tracking
295
295
 
296
- ## 🔧 Troubleshooting
296
+ ## Troubleshooting
297
297
 
298
298
  ### Font size not persisting?
299
299
 
@@ -309,13 +309,13 @@ Test your responsive design at all font sizes. Use relative units and flexible l
309
309
 
310
310
  ### TypeScript errors?
311
311
 
312
- Ensure you have Angular 21+ and TypeScript 5.7+ installed.
312
+ Ensure you have Angular 22+ and TypeScript 6.0+ installed.
313
313
 
314
- ## 💬 Support
314
+ ## Support
315
315
 
316
- - 🐛 Found a bug? [Open an issue](https://github.com/Greezaaa/settings-utils-lib/issues)
317
- - 💡 Have a feature request? [Start a discussion](https://github.com/Greezaaa/settings-utils-lib/discussions)
318
- - ⭐ Like this library? [Give it a star!](https://github.com/Greezaaa/settings-utils-lib)
316
+ - Found a bug? [Open an issue](https://github.com/Greezaaa/settings-utils-lib/issues)
317
+ - Have a feature request? [Start a discussion](https://github.com/Greezaaa/settings-utils-lib/discussions)
318
+ - Like this library? [Give it a star!](https://github.com/Greezaaa/settings-utils-lib)
319
319
 
320
320
  ## Contributing
321
321
 
@@ -1,184 +1,92 @@
1
- import * as i0 from '@angular/core';
2
- import { signal, computed, Injectable } from '@angular/core';
3
-
4
- class FontSizeService {
5
- /**
6
- * Default font size in pixels.
7
- * Can be overridden via {@link configure}.
8
- */
9
- defaultSize = signal(14, ...(ngDevMode ? [{ debugName: "defaultSize" }] : []));
10
- /**
11
- * Minimum allowed font size in pixels.
12
- * Can be overridden via {@link configure}.
13
- */
14
- minSize = signal(10, ...(ngDevMode ? [{ debugName: "minSize" }] : []));
15
- /**
16
- * Maximum allowed font size in pixels.
17
- * Can be overridden via {@link configure}.
18
- */
19
- maxSize = signal(22, ...(ngDevMode ? [{ debugName: "maxSize" }] : []));
20
- /**
21
- * Default step value (in pixels) for increase/decrease operations.
22
- * Can be overridden via {@link configure} or per call in {@link increase} / {@link decrease}.
23
- */
24
- step = signal(2, ...(ngDevMode ? [{ debugName: "step" }] : []));
25
- /**
26
- * Key used for persisting the font size in localStorage.
27
- * Defaults to `"app:font-size"`.
28
- */
29
- storageKey = 'su:font-size';
30
- /**
31
- * CSS custom property name where the font size is applied.
32
- * Defaults to `"--base-font-size"`.
33
- */
34
- cssVarName = '--base-font-size';
35
- /**
36
- * Current font size state (reactive).
37
- */
38
- fontSize = signal(this.readFromStorage(), ...(ngDevMode ? [{ debugName: "fontSize" }] : []));
39
- /**
40
- * True if current font size equals the default size.
41
- */
42
- isDefault = computed(() => this.fontSize() === this.defaultSize(), ...(ngDevMode ? [{ debugName: "isDefault" }] : []));
43
- /**
44
- * True if current font size equals the maximum size.
45
- */
46
- isMax = computed(() => this.fontSize() === this.maxSize(), ...(ngDevMode ? [{ debugName: "isMax" }] : []));
47
- /**
48
- * True if current font size equals the minimum size.
49
- */
50
- isMin = computed(() => this.fontSize() === this.minSize(), ...(ngDevMode ? [{ debugName: "isMin" }] : []));
51
- /**
52
- * Updates the configuration for font size handling.
53
- * Any omitted values will fall back to their defaults.
54
- *
55
- * @param cfg Partial configuration object (min, max, default, step, storage key, CSS variable name).
56
- */
57
- configure(cfg = {}) {
58
- if (cfg.minSize !== undefined)
59
- this.minSize.set(cfg.minSize);
60
- if (cfg.maxSize !== undefined)
61
- this.maxSize.set(cfg.maxSize);
62
- if (cfg.defaultSize !== undefined)
63
- this.defaultSize.set(cfg.defaultSize);
64
- if (cfg.step !== undefined)
65
- this.step.set(cfg.step);
66
- if (cfg.storageKey)
67
- this.storageKey = cfg.storageKey;
68
- if (cfg.cssVarName)
69
- this.cssVarName = cfg.cssVarName;
70
- // Ensure logical invariants
71
- if (this.minSize() > this.maxSize())
72
- this.maxSize.set(this.minSize());
73
- if (this.defaultSize() < this.minSize())
74
- this.defaultSize.set(this.minSize());
75
- if (this.defaultSize() > this.maxSize())
76
- this.defaultSize.set(this.maxSize());
77
- if (this.step() <= 0 || !Number.isFinite(this.step()))
78
- this.step.set(1);
79
- // Clamp current size after configuration changes
80
- this.fontSize.update((s) => this.clamp(s));
81
- }
82
- /**
83
- * Initializes the font size service.
84
- * Loads the persisted value (if available), clamps it,
85
- * applies it to the DOM, and updates internal state.
86
- * Should typically be called once at application startup.
87
- */
88
- init() {
89
- const size = this.readFromStorage();
90
- this.fontSize.set(this.clamp(size));
91
- this.applyCssVar(this.fontSize());
92
- }
93
- /**
94
- * Sets the font size to a specific value (clamped within min/max).
95
- *
96
- * @param size Desired font size in pixels.
97
- */
98
- setFontSize(size) {
99
- const clamped = this.clamp(size);
100
- this.fontSize.set(clamped);
101
- this.applyCssVar(clamped);
102
- this.writeToStorage(clamped);
103
- }
104
- /**
105
- * Increases the font size.
106
- *
107
- * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
108
- */
109
- increase(step) {
110
- this.setFontSize(this.fontSize() + (step ?? this.step()));
111
- }
112
- /**
113
- * Decreases the font size.
114
- *
115
- * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
116
- */
117
- decrease(step) {
118
- this.setFontSize(this.fontSize() - (step ?? this.step()));
119
- }
120
- /**
121
- * Resets the font size to the configured {@link defaultSize}.
122
- * Also removes the persisted value from localStorage.
123
- */
124
- reset() {
125
- const d = this.defaultSize();
126
- this.fontSize.set(d);
127
- this.applyCssVar(d);
128
- localStorage.removeItem(this.storageKey);
129
- }
130
- /**
131
- * Clamps a given value between the configured {@link minSize} and {@link maxSize}.
132
- *
133
- * @param size Value to clamp.
134
- * @returns Clamped value within the allowed range.
135
- */
136
- clamp(size) {
137
- return Math.min(Math.max(size, this.minSize()), this.maxSize());
138
- }
139
- /**
140
- * Reads the font size from localStorage.
141
- * Falls back to {@link defaultSize} if no value is stored or value is invalid.
142
- *
143
- * @returns Stored font size or default.
144
- */
145
- readFromStorage() {
146
- const stored = localStorage.getItem(this.storageKey);
147
- const parsed = stored ? Number(stored) : this.defaultSize();
148
- return Number.isFinite(parsed) ? parsed : this.defaultSize();
149
- }
150
- /**
151
- * Persists the current font size in localStorage.
152
- *
153
- * @param size Font size value to persist.
154
- */
155
- writeToStorage(size) {
156
- localStorage.setItem(this.storageKey, String(size));
157
- }
158
- /**
159
- * Applies the current font size to the DOM
160
- * using the configured CSS custom property name.
161
- *
162
- * @param size Font size value in pixels.
163
- */
164
- applyCssVar(size) {
165
- document.documentElement.style.setProperty(this.cssVarName, `${size}px`);
166
- }
167
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.2", ngImport: i0, type: FontSizeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
168
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.2", ngImport: i0, type: FontSizeService, providedIn: 'root' });
169
- }
170
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.2", ngImport: i0, type: FontSizeService, decorators: [{
171
- type: Injectable,
172
- args: [{ providedIn: 'root' }]
173
- }] });
174
-
175
- /*
176
- * Public API Surface of font-size
177
- */
178
-
179
- /**
180
- * Generated bundle index. Do not edit.
181
- */
182
-
1
+ import * as i0 from "@angular/core";
2
+ import { Injectable, computed, signal } from "@angular/core";
3
+ var FontSizeService = class FontSizeService {
4
+ defaultSize = signal(14, ...ngDevMode ? [{ debugName: "defaultSize" }] : /* istanbul ignore next */ []);
5
+ minSize = signal(10, ...ngDevMode ? [{ debugName: "minSize" }] : /* istanbul ignore next */ []);
6
+ maxSize = signal(22, ...ngDevMode ? [{ debugName: "maxSize" }] : /* istanbul ignore next */ []);
7
+ step = signal(2, ...ngDevMode ? [{ debugName: "step" }] : /* istanbul ignore next */ []);
8
+ storageKey = "su:font-size";
9
+ cssVarName = "--base-font-size";
10
+ fontSize = signal(this.readFromStorage(), ...ngDevMode ? [{ debugName: "fontSize" }] : /* istanbul ignore next */ []);
11
+ isDefault = computed(() => this.fontSize() === this.defaultSize(), ...ngDevMode ? [{ debugName: "isDefault" }] : /* istanbul ignore next */ []);
12
+ isMax = computed(() => this.fontSize() === this.maxSize(), ...ngDevMode ? [{ debugName: "isMax" }] : /* istanbul ignore next */ []);
13
+ isMin = computed(() => this.fontSize() === this.minSize(), ...ngDevMode ? [{ debugName: "isMin" }] : /* istanbul ignore next */ []);
14
+ configure(cfg = {}) {
15
+ if (cfg.minSize !== void 0) this.minSize.set(cfg.minSize);
16
+ if (cfg.maxSize !== void 0) this.maxSize.set(cfg.maxSize);
17
+ if (cfg.defaultSize !== void 0) this.defaultSize.set(cfg.defaultSize);
18
+ if (cfg.step !== void 0) this.step.set(cfg.step);
19
+ if (cfg.storageKey) this.storageKey = cfg.storageKey;
20
+ if (cfg.cssVarName) this.cssVarName = cfg.cssVarName;
21
+ if (this.minSize() > this.maxSize()) this.maxSize.set(this.minSize());
22
+ if (this.defaultSize() < this.minSize()) this.defaultSize.set(this.minSize());
23
+ if (this.defaultSize() > this.maxSize()) this.defaultSize.set(this.maxSize());
24
+ if (this.step() <= 0 || !Number.isFinite(this.step())) this.step.set(1);
25
+ this.fontSize.update((s) => this.clamp(s));
26
+ }
27
+ init() {
28
+ const size = this.readFromStorage();
29
+ this.fontSize.set(this.clamp(size));
30
+ this.applyCssVar(this.fontSize());
31
+ }
32
+ setFontSize(size) {
33
+ const clamped = this.clamp(size);
34
+ this.fontSize.set(clamped);
35
+ this.applyCssVar(clamped);
36
+ this.writeToStorage(clamped);
37
+ }
38
+ increase(step) {
39
+ this.setFontSize(this.fontSize() + (step ?? this.step()));
40
+ }
41
+ decrease(step) {
42
+ this.setFontSize(this.fontSize() - (step ?? this.step()));
43
+ }
44
+ reset() {
45
+ const d = this.defaultSize();
46
+ this.fontSize.set(d);
47
+ this.applyCssVar(d);
48
+ localStorage.removeItem(this.storageKey);
49
+ }
50
+ clamp(size) {
51
+ return Math.min(Math.max(size, this.minSize()), this.maxSize());
52
+ }
53
+ readFromStorage() {
54
+ const stored = localStorage.getItem(this.storageKey);
55
+ const parsed = stored ? Number(stored) : this.defaultSize();
56
+ return Number.isFinite(parsed) ? parsed : this.defaultSize();
57
+ }
58
+ writeToStorage(size) {
59
+ localStorage.setItem(this.storageKey, String(size));
60
+ }
61
+ applyCssVar(size) {
62
+ document.documentElement.style.setProperty(this.cssVarName, `${size}px`);
63
+ }
64
+ static ɵfac = i0.ɵɵngDeclareFactory({
65
+ minVersion: "12.0.0",
66
+ version: "22.2.4",
67
+ ngImport: i0,
68
+ type: FontSizeService,
69
+ deps: [],
70
+ target: i0.ɵɵFactoryTarget.Injectable
71
+ });
72
+ static ɵprov = i0.ɵɵngDeclareInjectable({
73
+ minVersion: "12.0.0",
74
+ version: "22.2.4",
75
+ ngImport: i0,
76
+ type: FontSizeService,
77
+ providedIn: "root"
78
+ });
79
+ };
80
+ i0.ɵɵngDeclareClassMetadata({
81
+ minVersion: "12.0.0",
82
+ version: "22.2.4",
83
+ ngImport: i0,
84
+ type: FontSizeService,
85
+ decorators: [{
86
+ type: Injectable,
87
+ args: [{ providedIn: "root" }]
88
+ }]
89
+ });
183
90
  export { FontSizeService };
184
- //# sourceMappingURL=su-labs-font-size.mjs.map
91
+
92
+ //# sourceMappingURL=su-labs-font-size.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"su-labs-font-size.mjs","sources":["../../../../projects/su-labs/font-size/src/lib/font-size.service.ts","../../../../projects/su-labs/font-size/src/public-api.ts","../../../../projects/su-labs/font-size/src/su-labs-font-size.ts"],"sourcesContent":["import { Injectable, signal, computed } from '@angular/core';\nimport { FontSizeConfig } from './font-size-config.interface';\n\n@Injectable({ providedIn: 'root' })\nexport class FontSizeService {\n /**\n * Default font size in pixels.\n * Can be overridden via {@link configure}.\n */\n defaultSize = signal(14);\n\n /**\n * Minimum allowed font size in pixels.\n * Can be overridden via {@link configure}.\n */\n minSize = signal(10);\n\n /**\n * Maximum allowed font size in pixels.\n * Can be overridden via {@link configure}.\n */\n maxSize = signal(22);\n\n /**\n * Default step value (in pixels) for increase/decrease operations.\n * Can be overridden via {@link configure} or per call in {@link increase} / {@link decrease}.\n */\n step = signal(2);\n\n /**\n * Key used for persisting the font size in localStorage.\n * Defaults to `\"app:font-size\"`.\n */\n private storageKey = 'su:font-size';\n\n /**\n * CSS custom property name where the font size is applied.\n * Defaults to `\"--base-font-size\"`.\n */\n private cssVarName = '--base-font-size';\n\n /**\n * Current font size state (reactive).\n */\n fontSize = signal<number>(this.readFromStorage());\n\n /**\n * True if current font size equals the default size.\n */\n isDefault = computed(() => this.fontSize() === this.defaultSize());\n\n /**\n * True if current font size equals the maximum size.\n */\n isMax = computed(() => this.fontSize() === this.maxSize());\n\n /**\n * True if current font size equals the minimum size.\n */\n isMin = computed(() => this.fontSize() === this.minSize());\n\n /**\n * Updates the configuration for font size handling.\n * Any omitted values will fall back to their defaults.\n *\n * @param cfg Partial configuration object (min, max, default, step, storage key, CSS variable name).\n */\n configure(cfg: Partial<FontSizeConfig> = {}): void {\n if (cfg.minSize !== undefined) this.minSize.set(cfg.minSize);\n if (cfg.maxSize !== undefined) this.maxSize.set(cfg.maxSize);\n if (cfg.defaultSize !== undefined) this.defaultSize.set(cfg.defaultSize);\n if (cfg.step !== undefined) this.step.set(cfg.step);\n if (cfg.storageKey) this.storageKey = cfg.storageKey;\n if (cfg.cssVarName) this.cssVarName = cfg.cssVarName;\n\n // Ensure logical invariants\n if (this.minSize() > this.maxSize()) this.maxSize.set(this.minSize());\n if (this.defaultSize() < this.minSize())\n this.defaultSize.set(this.minSize());\n if (this.defaultSize() > this.maxSize())\n this.defaultSize.set(this.maxSize());\n if (this.step() <= 0 || !Number.isFinite(this.step())) this.step.set(1);\n\n // Clamp current size after configuration changes\n this.fontSize.update((s) => this.clamp(s));\n }\n\n /**\n * Initializes the font size service.\n * Loads the persisted value (if available), clamps it,\n * applies it to the DOM, and updates internal state.\n * Should typically be called once at application startup.\n */\n init(): void {\n const size = this.readFromStorage();\n this.fontSize.set(this.clamp(size));\n this.applyCssVar(this.fontSize());\n }\n\n /**\n * Sets the font size to a specific value (clamped within min/max).\n *\n * @param size Desired font size in pixels.\n */\n setFontSize(size: number): void {\n const clamped = this.clamp(size);\n this.fontSize.set(clamped);\n this.applyCssVar(clamped);\n this.writeToStorage(clamped);\n }\n\n /**\n * Increases the font size.\n *\n * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.\n */\n increase(step?: number): void {\n this.setFontSize(this.fontSize() + (step ?? this.step()));\n }\n\n /**\n * Decreases the font size.\n *\n * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.\n */\n decrease(step?: number): void {\n this.setFontSize(this.fontSize() - (step ?? this.step()));\n }\n\n /**\n * Resets the font size to the configured {@link defaultSize}.\n * Also removes the persisted value from localStorage.\n */\n reset(): void {\n const d = this.defaultSize();\n this.fontSize.set(d);\n this.applyCssVar(d);\n localStorage.removeItem(this.storageKey);\n }\n\n /**\n * Clamps a given value between the configured {@link minSize} and {@link maxSize}.\n *\n * @param size Value to clamp.\n * @returns Clamped value within the allowed range.\n */\n private clamp(size: number): number {\n return Math.min(Math.max(size, this.minSize()), this.maxSize());\n }\n\n /**\n * Reads the font size from localStorage.\n * Falls back to {@link defaultSize} if no value is stored or value is invalid.\n *\n * @returns Stored font size or default.\n */\n private readFromStorage(): number {\n const stored = localStorage.getItem(this.storageKey);\n const parsed = stored ? Number(stored) : this.defaultSize();\n return Number.isFinite(parsed) ? parsed : this.defaultSize();\n }\n\n /**\n * Persists the current font size in localStorage.\n *\n * @param size Font size value to persist.\n */\n private writeToStorage(size: number): void {\n localStorage.setItem(this.storageKey, String(size));\n }\n\n /**\n * Applies the current font size to the DOM\n * using the configured CSS custom property name.\n *\n * @param size Font size value in pixels.\n */\n private applyCssVar(size: number): void {\n document.documentElement.style.setProperty(this.cssVarName, `${size}px`);\n }\n}\n","/*\n * Public API Surface of font-size\n */\n\nexport * from './lib/font-size.service';\nexport * from './lib/font-size-config.interface';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"su-labs-font-size.mjs","names":[],"sources":["../../../../projects/su-labs/font-size/src/lib/font-size.service.ts"],"sourcesContent":["import { Injectable, signal, computed } from '@angular/core';\nimport { FontSizeConfig } from './font-size-config.interface';\n\n@Injectable({ providedIn: 'root' })\nexport class FontSizeService {\n /**\n * Default font size in pixels.\n * Can be overridden via {@link configure}.\n */\n defaultSize = signal(14);\n\n /**\n * Minimum allowed font size in pixels.\n * Can be overridden via {@link configure}.\n */\n minSize = signal(10);\n\n /**\n * Maximum allowed font size in pixels.\n * Can be overridden via {@link configure}.\n */\n maxSize = signal(22);\n\n /**\n * Default step value (in pixels) for increase/decrease operations.\n * Can be overridden via {@link configure} or per call in {@link increase} / {@link decrease}.\n */\n step = signal(2);\n\n /**\n * Key used for persisting the font size in localStorage.\n * Defaults to `\"app:font-size\"`.\n */\n private storageKey = 'su:font-size';\n\n /**\n * CSS custom property name where the font size is applied.\n * Defaults to `\"--base-font-size\"`.\n */\n private cssVarName = '--base-font-size';\n\n /**\n * Current font size state (reactive).\n */\n fontSize = signal<number>(this.readFromStorage());\n\n /**\n * True if current font size equals the default size.\n */\n isDefault = computed(() => this.fontSize() === this.defaultSize());\n\n /**\n * True if current font size equals the maximum size.\n */\n isMax = computed(() => this.fontSize() === this.maxSize());\n\n /**\n * True if current font size equals the minimum size.\n */\n isMin = computed(() => this.fontSize() === this.minSize());\n\n /**\n * Updates the configuration for font size handling.\n * Any omitted values will fall back to their defaults.\n *\n * @param cfg Partial configuration object (min, max, default, step, storage key, CSS variable name).\n */\n configure(cfg: Partial<FontSizeConfig> = {}): void {\n if (cfg.minSize !== undefined) this.minSize.set(cfg.minSize);\n if (cfg.maxSize !== undefined) this.maxSize.set(cfg.maxSize);\n if (cfg.defaultSize !== undefined) this.defaultSize.set(cfg.defaultSize);\n if (cfg.step !== undefined) this.step.set(cfg.step);\n if (cfg.storageKey) this.storageKey = cfg.storageKey;\n if (cfg.cssVarName) this.cssVarName = cfg.cssVarName;\n\n // Ensure logical invariants\n if (this.minSize() > this.maxSize()) this.maxSize.set(this.minSize());\n if (this.defaultSize() < this.minSize())\n this.defaultSize.set(this.minSize());\n if (this.defaultSize() > this.maxSize())\n this.defaultSize.set(this.maxSize());\n if (this.step() <= 0 || !Number.isFinite(this.step())) this.step.set(1);\n\n // Clamp current size after configuration changes\n this.fontSize.update((s) => this.clamp(s));\n }\n\n /**\n * Initializes the font size service.\n * Loads the persisted value (if available), clamps it,\n * applies it to the DOM, and updates internal state.\n * Should typically be called once at application startup.\n */\n init(): void {\n const size = this.readFromStorage();\n this.fontSize.set(this.clamp(size));\n this.applyCssVar(this.fontSize());\n }\n\n /**\n * Sets the font size to a specific value (clamped within min/max).\n *\n * @param size Desired font size in pixels.\n */\n setFontSize(size: number): void {\n const clamped = this.clamp(size);\n this.fontSize.set(clamped);\n this.applyCssVar(clamped);\n this.writeToStorage(clamped);\n }\n\n /**\n * Increases the font size.\n *\n * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.\n */\n increase(step?: number): void {\n this.setFontSize(this.fontSize() + (step ?? this.step()));\n }\n\n /**\n * Decreases the font size.\n *\n * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.\n */\n decrease(step?: number): void {\n this.setFontSize(this.fontSize() - (step ?? this.step()));\n }\n\n /**\n * Resets the font size to the configured {@link defaultSize}.\n * Also removes the persisted value from localStorage.\n */\n reset(): void {\n const d = this.defaultSize();\n this.fontSize.set(d);\n this.applyCssVar(d);\n localStorage.removeItem(this.storageKey);\n }\n\n /**\n * Clamps a given value between the configured {@link minSize} and {@link maxSize}.\n *\n * @param size Value to clamp.\n * @returns Clamped value within the allowed range.\n */\n private clamp(size: number): number {\n return Math.min(Math.max(size, this.minSize()), this.maxSize());\n }\n\n /**\n * Reads the font size from localStorage.\n * Falls back to {@link defaultSize} if no value is stored or value is invalid.\n *\n * @returns Stored font size or default.\n */\n private readFromStorage(): number {\n const stored = localStorage.getItem(this.storageKey);\n const parsed = stored ? Number(stored) : this.defaultSize();\n return Number.isFinite(parsed) ? parsed : this.defaultSize();\n }\n\n /**\n * Persists the current font size in localStorage.\n *\n * @param size Font size value to persist.\n */\n private writeToStorage(size: number): void {\n localStorage.setItem(this.storageKey, String(size));\n }\n\n /**\n * Applies the current font size to the DOM\n * using the configured CSS custom property name.\n *\n * @param size Font size value in pixels.\n */\n private applyCssVar(size: number): void {\n document.documentElement.style.setProperty(this.cssVarName, `${size}px`);\n }\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@su-labs/font-size",
3
- "version": "21.0.5",
3
+ "version": "22.0.0",
4
4
  "description": "A lightweight Angular service for dynamic font size management.",
5
5
  "keywords": [
6
6
  "angular",
@@ -25,8 +25,8 @@
25
25
  "url": "https://github.com/Greezaaa"
26
26
  },
27
27
  "peerDependencies": {
28
- "@angular/common": "^21.0.0",
29
- "@angular/core": "^21.0.0"
28
+ "@angular/common": "^22.0.0",
29
+ "@angular/core": "^22.0.0"
30
30
  },
31
31
  "dependencies": {
32
32
  "tslib": "^2.3.0"
@@ -51,5 +51,6 @@
51
51
  "types": "./types/su-labs-font-size.d.ts",
52
52
  "default": "./fesm2022/su-labs-font-size.mjs"
53
53
  }
54
- }
54
+ },
55
+ "type": "module"
55
56
  }
@@ -1,128 +1,123 @@
1
- import * as _angular_core from '@angular/core';
2
-
3
- interface FontSizeConfig {
4
- defaultSize: number;
5
- minSize: number;
6
- maxSize: number;
7
- step: number;
8
- storageKey?: string;
9
- cssVarName?: string;
1
+ import * as i0 from "@angular/core";
2
+ export interface FontSizeConfig {
3
+ defaultSize: number;
4
+ minSize: number;
5
+ maxSize: number;
6
+ step: number;
7
+ storageKey?: string;
8
+ cssVarName?: string;
10
9
  }
11
-
12
- declare class FontSizeService {
13
- /**
14
- * Default font size in pixels.
15
- * Can be overridden via {@link configure}.
16
- */
17
- defaultSize: _angular_core.WritableSignal<number>;
18
- /**
19
- * Minimum allowed font size in pixels.
20
- * Can be overridden via {@link configure}.
21
- */
22
- minSize: _angular_core.WritableSignal<number>;
23
- /**
24
- * Maximum allowed font size in pixels.
25
- * Can be overridden via {@link configure}.
26
- */
27
- maxSize: _angular_core.WritableSignal<number>;
28
- /**
29
- * Default step value (in pixels) for increase/decrease operations.
30
- * Can be overridden via {@link configure} or per call in {@link increase} / {@link decrease}.
31
- */
32
- step: _angular_core.WritableSignal<number>;
33
- /**
34
- * Key used for persisting the font size in localStorage.
35
- * Defaults to `"app:font-size"`.
36
- */
37
- private storageKey;
38
- /**
39
- * CSS custom property name where the font size is applied.
40
- * Defaults to `"--base-font-size"`.
41
- */
42
- private cssVarName;
43
- /**
44
- * Current font size state (reactive).
45
- */
46
- fontSize: _angular_core.WritableSignal<number>;
47
- /**
48
- * True if current font size equals the default size.
49
- */
50
- isDefault: _angular_core.Signal<boolean>;
51
- /**
52
- * True if current font size equals the maximum size.
53
- */
54
- isMax: _angular_core.Signal<boolean>;
55
- /**
56
- * True if current font size equals the minimum size.
57
- */
58
- isMin: _angular_core.Signal<boolean>;
59
- /**
60
- * Updates the configuration for font size handling.
61
- * Any omitted values will fall back to their defaults.
62
- *
63
- * @param cfg Partial configuration object (min, max, default, step, storage key, CSS variable name).
64
- */
65
- configure(cfg?: Partial<FontSizeConfig>): void;
66
- /**
67
- * Initializes the font size service.
68
- * Loads the persisted value (if available), clamps it,
69
- * applies it to the DOM, and updates internal state.
70
- * Should typically be called once at application startup.
71
- */
72
- init(): void;
73
- /**
74
- * Sets the font size to a specific value (clamped within min/max).
75
- *
76
- * @param size Desired font size in pixels.
77
- */
78
- setFontSize(size: number): void;
79
- /**
80
- * Increases the font size.
81
- *
82
- * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
83
- */
84
- increase(step?: number): void;
85
- /**
86
- * Decreases the font size.
87
- *
88
- * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
89
- */
90
- decrease(step?: number): void;
91
- /**
92
- * Resets the font size to the configured {@link defaultSize}.
93
- * Also removes the persisted value from localStorage.
94
- */
95
- reset(): void;
96
- /**
97
- * Clamps a given value between the configured {@link minSize} and {@link maxSize}.
98
- *
99
- * @param size Value to clamp.
100
- * @returns Clamped value within the allowed range.
101
- */
102
- private clamp;
103
- /**
104
- * Reads the font size from localStorage.
105
- * Falls back to {@link defaultSize} if no value is stored or value is invalid.
106
- *
107
- * @returns Stored font size or default.
108
- */
109
- private readFromStorage;
110
- /**
111
- * Persists the current font size in localStorage.
112
- *
113
- * @param size Font size value to persist.
114
- */
115
- private writeToStorage;
116
- /**
117
- * Applies the current font size to the DOM
118
- * using the configured CSS custom property name.
119
- *
120
- * @param size Font size value in pixels.
121
- */
122
- private applyCssVar;
123
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<FontSizeService, never>;
124
- static ɵprov: _angular_core.ɵɵInjectableDeclaration<FontSizeService>;
125
- }
126
-
127
- export { FontSizeService };
128
- export type { FontSizeConfig };
10
+ export declare class FontSizeService {
11
+ /**
12
+ * Default font size in pixels.
13
+ * Can be overridden via {@link configure}.
14
+ */
15
+ defaultSize: import("@angular/core").WritableSignal<number>;
16
+ /**
17
+ * Minimum allowed font size in pixels.
18
+ * Can be overridden via {@link configure}.
19
+ */
20
+ minSize: import("@angular/core").WritableSignal<number>;
21
+ /**
22
+ * Maximum allowed font size in pixels.
23
+ * Can be overridden via {@link configure}.
24
+ */
25
+ maxSize: import("@angular/core").WritableSignal<number>;
26
+ /**
27
+ * Default step value (in pixels) for increase/decrease operations.
28
+ * Can be overridden via {@link configure} or per call in {@link increase} / {@link decrease}.
29
+ */
30
+ step: import("@angular/core").WritableSignal<number>;
31
+ /**
32
+ * Key used for persisting the font size in localStorage.
33
+ * Defaults to `"app:font-size"`.
34
+ */
35
+ private storageKey;
36
+ /**
37
+ * CSS custom property name where the font size is applied.
38
+ * Defaults to `"--base-font-size"`.
39
+ */
40
+ private cssVarName;
41
+ /**
42
+ * Current font size state (reactive).
43
+ */
44
+ fontSize: import("@angular/core").WritableSignal<number>;
45
+ /**
46
+ * True if current font size equals the default size.
47
+ */
48
+ isDefault: import("@angular/core").Signal<boolean>;
49
+ /**
50
+ * True if current font size equals the maximum size.
51
+ */
52
+ isMax: import("@angular/core").Signal<boolean>;
53
+ /**
54
+ * True if current font size equals the minimum size.
55
+ */
56
+ isMin: import("@angular/core").Signal<boolean>;
57
+ /**
58
+ * Updates the configuration for font size handling.
59
+ * Any omitted values will fall back to their defaults.
60
+ *
61
+ * @param cfg Partial configuration object (min, max, default, step, storage key, CSS variable name).
62
+ */
63
+ configure(cfg?: Partial<FontSizeConfig>): void;
64
+ /**
65
+ * Initializes the font size service.
66
+ * Loads the persisted value (if available), clamps it,
67
+ * applies it to the DOM, and updates internal state.
68
+ * Should typically be called once at application startup.
69
+ */
70
+ init(): void;
71
+ /**
72
+ * Sets the font size to a specific value (clamped within min/max).
73
+ *
74
+ * @param size Desired font size in pixels.
75
+ */
76
+ setFontSize(size: number): void;
77
+ /**
78
+ * Increases the font size.
79
+ *
80
+ * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
81
+ */
82
+ increase(step?: number): void;
83
+ /**
84
+ * Decreases the font size.
85
+ *
86
+ * @param step Optional custom step (pixels). Falls back to configured {@link step} if omitted.
87
+ */
88
+ decrease(step?: number): void;
89
+ /**
90
+ * Resets the font size to the configured {@link defaultSize}.
91
+ * Also removes the persisted value from localStorage.
92
+ */
93
+ reset(): void;
94
+ /**
95
+ * Clamps a given value between the configured {@link minSize} and {@link maxSize}.
96
+ *
97
+ * @param size Value to clamp.
98
+ * @returns Clamped value within the allowed range.
99
+ */
100
+ private clamp;
101
+ /**
102
+ * Reads the font size from localStorage.
103
+ * Falls back to {@link defaultSize} if no value is stored or value is invalid.
104
+ *
105
+ * @returns Stored font size or default.
106
+ */
107
+ private readFromStorage;
108
+ /**
109
+ * Persists the current font size in localStorage.
110
+ *
111
+ * @param size Font size value to persist.
112
+ */
113
+ private writeToStorage;
114
+ /**
115
+ * Applies the current font size to the DOM
116
+ * using the configured CSS custom property name.
117
+ *
118
+ * @param size Font size value in pixels.
119
+ */
120
+ private applyCssVar;
121
+ static ɵfac: i0.ɵɵFactoryDeclaration<FontSizeService, never>;
122
+ static ɵprov: i0.ɵɵInjectableDeclaration<any>;
123
+ }