@iyulab/components 1.35.1 → 1.35.7

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.7",
   "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/dialog.md

@@ -17,7 +17,7 @@ const confirmed = await Dialog.confirm('Delete this item?');
 if (confirmed) deleteItem();
 
 // Prompt — returns entered string or null if cancelled
-const name = await Dialog.prompt('Enter your name:', { default: 'Alice' });
+const name = await Dialog.prompt('Enter your name:', { defaultValue: 'Alice' });
 
 // Custom dialog with action buttons
 const result = await Dialog.show({
@@ -44,26 +44,29 @@ const result = await Dialog.show({
 
 ```ts
 interface DialogOptions {
-  target?: HTMLElement;
+  target?: HTMLElement;      // shows contained instead of as an overlay when set
   title?: string;
-  closable?: boolean;
   placement?: DialogPlacement;
+  offset?: number;           // gap from the edge, px
+  modal?: boolean;           // default: true
+  buttonClose?: boolean;     // show an explicit close button — default: false
+  escapeClose?: boolean;     // close on Esc — default: true
+  backdropClose?: boolean;   // close on backdrop click — default: true
 }
 
 interface ConfirmDialogOptions extends DialogOptions {
-  confirmLabel?: string;
-  cancelLabel?: string;
+  confirmLabel?: string;     // default: 'Confirm'
+  cancelLabel?: string;      // default: 'Cancel'
 }
 
-interface PromptDialogOptions extends DialogOptions {
-  default?: string;
+interface PromptDialogOptions extends ConfirmDialogOptions {
+  type?: InputType;          // input field type — default: 'text'
+  defaultValue?: string;
   placeholder?: string;
-  confirmLabel?: string;
-  cancelLabel?: string;
 }
 
 interface CustomDialogOptions extends DialogOptions {
-  content?: string | HTMLElement | TemplateResult;
+  content: string | TemplateResult;
   actions?: DialogAction[];
 }
 

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
 });