@iyulab/components 1.35.1 → 1.35.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.35.1",
+  "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
 });