@iyulab/components 1.35.0 → 1.35.6

package/dist/utilities/BrowserStorage.js

@@ -30,7 +30,7 @@ var BrowserStorage = class {
 				sameSite: this.options.sameSite,
 				partitioned: this.options.partitioned
 			});
-			else throw new Error(`Unsupported storage type`);
+			else throw new Error(`Unsupported storage type: "${this.options.type}" (expected "localStorage" or "cookie")`);
 		} catch (e) {
 			console.error("[BrowserStorage Error: set]", e);
 		}
@@ -45,7 +45,7 @@ var BrowserStorage = class {
 		try {
 			if (this.options.type === "localStorage") return window.localStorage.getItem(key);
 			else if (this.options.type === "cookie") return (await window.cookieStore.get({ name: key }))?.value || null;
-			else throw new Error(`Unsupported storage type`);
+			else throw new Error(`Unsupported storage type: "${this.options.type}" (expected "localStorage" or "cookie")`);
 		} catch (e) {
 			console.error("[BrowserStorage Error: get]", e);
 			return null;
@@ -60,7 +60,7 @@ var BrowserStorage = class {
 		try {
 			if (this.options.type === "localStorage") window.localStorage.removeItem(key);
 			else if (this.options.type === "cookie") await window.cookieStore.delete({ name: key });
-			else throw new Error(`Unsupported storage type`);
+			else throw new Error(`Unsupported storage type: "${this.options.type}" (expected "localStorage" or "cookie")`);
 		} catch (e) {
 			console.error("[BrowserStorage Error: remove]", e);
 		}

package/dist/utilities/Locale.d.ts

@@ -12,7 +12,7 @@ export type SupportedLocale = 'en' | 'ko' | 'ja' | 'zh-CN' | 'zh-TW' | 'es' | 'f
 /** 내장 로케일은 자동완성되지만, 임의의 BCP47 태그도 그대로 받는다. */
 export type LocaleTag = SupportedLocale | (string & {});
 /** 라이브러리가 제공하는 chrome 문자열 키. 지금은 검증 메시지뿐이지만 이후 다른 UI 문구도 추가될 수 있다. */
-export type LocaleMessageKey = 'valueMissing' | 'badInput' | 'typeMismatch' | 'patternMismatch' | 'rangeUnderflow' | 'rangeOverflow' | 'stepMismatch' | 'tooShort' | 'tooLong' | 'increment' | 'decrement' | 'clear' | 'today' | 'time' | 'showPassword' | 'hidePassword' | 'previousSlide' | 'nextSlide' | 'goToSlide';
+export type LocaleMessageKey = 'valueMissing' | 'badInput' | 'typeMismatch' | 'patternMismatch' | 'rangeUnderflow' | 'rangeOverflow' | 'stepMismatch' | 'tooShort' | 'tooLong' | 'increment' | 'decrement' | 'clear' | 'today' | 'time' | 'showPassword' | 'hidePassword' | 'previousSlide' | 'nextSlide' | 'goToSlide' | 'chooseDate' | 'previousMonth' | 'nextMonth' | 'close' | 'copy' | 'copied';
 type LocaleTable = Record<LocaleMessageKey, string>;
 /**
  * 한 패키지(또는 앱 영역)의 문자열 묶음.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.35.0",
+  "version": "1.35.6",
   "keywords": [
     "iyulab",
     "components",
@@ -47,6 +47,7 @@
     "./plugins/*": "./dist/plugins/*"
   },
   "scripts": {
+    "preversion": "node -e \"if(require('fs').existsSync('../../scripts/preversion-check.mjs'))require('child_process').execFileSync('node',['../../scripts/preversion-check.mjs'],{stdio:'inherit'})\"",
     "start": "vite --force",
     "test": "vitest run",
     "test:browser": "vitest run --project=browser",

package/skills/iyulab-components/references/utilities/browser-storage.md

@@ -6,6 +6,11 @@ import { BrowserStorage } from '@iyulab/components';
 
 Unified key-value storage API over `localStorage` or browser cookies.
 
+⚠ Cookie storage uses the [Cookie Store API](https://developer.mozilla.org/en-US/docs/Web/API/CookieStore)
+(`window.cookieStore`) — supported in Chromium browsers, not yet in Safari or Firefox as of
+writing. `new BrowserStorage({ type: 'cookie' })` throws `"Cookies are not supported in this
+browser."` where it's unavailable; `localStorage` has no such restriction.
+
 ## Usage
 
 ```ts
@@ -20,7 +25,7 @@ await storage.remove('theme');
 const cookieStorage = new BrowserStorage({
   type: 'cookie',
   path: '/',
-  maxAge: 60 * 60 * 24 * 30  // 30 days
+  expires: Date.now() + 30 * 24 * 60 * 60 * 1000  // 30 days, ms since epoch
 });
 
 await cookieStorage.set('session', 'abc123');
@@ -37,7 +42,10 @@ await cookieStorage.set('session', 'abc123');
 ## Types
 
 ```ts
-type BrowserStorageOptions = LocalStorageOptions | CookieOptions;
+type BrowserStorageOptions = (LocalStorageOptions | CookieOptions) & {
+  /** Prefix prepended to every key. */
+  prefix?: string;
+};
 
 interface LocalStorageOptions {
   type: 'localStorage';
@@ -46,9 +54,14 @@ interface LocalStorageOptions {
 interface CookieOptions {
   type: 'cookie';
   path?: string;
-  domain?: string;
-  maxAge?: number;
+  domain?: string | null;
+  /** Expiry as ms since epoch (`DOMHighResTimeStamp`). Omit for a session cookie. */
+  expires?: DOMHighResTimeStamp | null;
   sameSite?: 'strict' | 'lax' | 'none';
-  secure?: boolean;
+  /** Partitioned cookie (CHIPS) — isolates the cookie per top-level site in a third-party context. */
+  partitioned?: boolean;
 }
 ```
+
+Only `'localStorage'` and `'cookie'` are valid `type` values — there is no `'sessionStorage'`
+storage backend.

package/skills/iyulab-components/references/utilities/theme.md

@@ -16,7 +16,7 @@ await Theme.init({
   useBuiltIn: true,       // inject bundled CSS variables (default: true)
   store: {                // persist to storage (optional)
     type: 'localStorage',
-    key: 'theme'
+    prefix: 'myapp-'
   },
   debug: false
 });