npm - mi-intl - Versions diffs - 0.6.3 - Mend

mi-intl 0.6.3

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.

Files changed (24) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2024-present, commenthol and contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,134 @@
+[![npm-badge][npm-badge]][npm]
+![types-badge][types-badge]
+# mi-intl
+Formats strings using [ICU Message Syntax][icu-syntax] for [mi-element][].
+**Table of contents**
+<!-- !toc (minlevel=2) -->
+- [Usage](#usage)
+<!-- toc! -->
+## Usage
+In your project:
+```
+npm i mi-intl mi-element
+```
+/app.js
+```js
+import { define, MiElement } from 'mi-element'
+import { MiIntlProvider, MiIntlMessage, IntlConsumer } from 'mi-intl'
+// define tag for intl-provider
+define('mi-intl-provider', MiIntlProvider)
+// connects to MiIntlProvider using IntlConsumer
+define(
+  'mi-message',
+  class extends MiIntlMessage {
+    static get attributes() {
+      return { label: String, value: String }
+    }
+    update() {
+      // this.t() is provided by MiIntlMessage
+      this.renderRoot.textContent = this.t(this.label, { value: this.value })
+    }
+  }
+)
+// define lang selector
+define(
+  'mi-language-selector',
+  class extends MiElement {
+    #context
+    static template = `<slot></slot>`
+    render() {
+      // connect to intl-provider
+      this.#context = new IntlConsumer(this)
+      this.ref = this.renderRoot.querySelector('select')
+      this.ref.addEventListener('change', (ev) => {
+        this.#context.get().changeLanguage(ev.target.value).catch(console.error)
+      })
+    }
+    update() {
+      this.ref.value = this.#context.get().lng
+    }
+  }
+)
+```
+/index.html
+```html
+<html>
+  <body>
+    <mi-intl-provider
+      version="1.0.0"
+      supportedLngs="en,en-US,es"
+      localesPath="/locales/{lng}/{ns}.json?version={version}"
+    >
+      <mi-language-selector>
+        <select>
+          <option value="en">🇬🇧</option>
+          <option value="en-US">🇺🇸</option>
+          <option value="es">🇪🇸</option>
+        </select>
+      </mi-language-selector>
+      <mi-message label="Hello {value}!" value="world">
+      <mi-message label="lift">
+    </mi-intl-provider>
+    <script type="module" src="/app.js"></script>
+  </body>
+</html>
+```
+/locales/en/translations.json
+```json
+{
+  "lift": "lift",
+  "Hello {value}!": "Hello {value}!"
+}
+```
+/locales/en-US/translations.json
+```json
+{
+  "lift": "elevator",
+  "Hello {value}!": "Hello {value}!"
+}
+```
+/locales/es/translations.json
+```json
+{
+  "lift": "ascensor",
+  "Hello {value}!": "¡Hola {value}!"
+}
+```
+Check folder ./example for a more advanced example.
+Run with `npm run example`
+# License
+MIT licensed
+[icu-syntax]: https://formatjs.github.io/docs/core-concepts/icu-syntax
+[mi-element]: https://github.com/commenthol/mi-element/tree/main/packages/mi-element
+[npm-badge]: https://badgen.net/npm/v/mi-intl
+[npm]: https://www.npmjs.com/package/mi-intl
+[types-badge]: https://badgen.net/npm/types/mi-intl

package/dist/cookie.js ADDED Viewed

@@ -0,0 +1,26 @@
+function cookieParse(cookieStr = "") {
+  const parts = cookieStr.split(/\s*;\s*/), cookies = {};
+  for (const part of parts) {
+    const [key, val] = part.split('=');
+    if (key) {
+      const value = decodeURIComponent(val);
+      cookies[key] = value;
+    }
+  }
+  return cookies;
+}
+const fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
+function cookieSerialize(name, value, options) {
+  const {maxAge: maxAge, domain: domain, path: path, expires: expires, httpOnly: httpOnly = !1, secure: secure = !1, sameSite: sameSite = "Strict"} = options || {};
+  if (!name || !fieldContentRegExp.test(name)) throw TypeError('invalid name');
+  const parts = [ `${name}=${encodeURIComponent(value)}` ];
+  return !isNaN(maxAge - 0) && isFinite(maxAge) && parts.push(`Max-Age=${maxAge}`),
+  domain && fieldContentRegExp.test(domain) && parts.push(`Domain=${domain}`), path && fieldContentRegExp.test(path) && parts.push(`Path=${path}`),
+  isNaN(new Date(expires).getTime()) || parts.push(`Expires=${new Date(expires).toUTCString()}`),
+  httpOnly && parts.push('HttpOnly'), secure && parts.push('Secure'), sameSite && parts.push(`SameSite=${sameSite}`),
+  parts.join('; ');
+}
+export { cookieParse, cookieSerialize };

package/dist/i18n.js ADDED Viewed

@@ -0,0 +1,138 @@
+import { cached } from 'intl-messageformat-tiny';
+import { cookieSerialize, cookieParse } from './cookie.js';
+const format = cached(), isBrowser = globalThis?.navigator?.language && globalThis?.document, defaultOptions = {
+  supportedLngs: [],
+  version: '',
+  ns: [ "translations" ],
+  defaultNs: "translations",
+  localesPath: '/locales/{lng}/{ns}.json?v={version}',
+  useLabel: !1,
+  debug: !1,
+  cookie: {
+    name: 'lc',
+    path: '/'
+  }
+};
+let log = {
+  debug: (..._args) => {},
+  error: (..._args) => {}
+};
+const uniq = arr => [ ...new Set(arr.filter(Boolean)) ], mainLng = lng => (lng || '').split('-', 1)[0], reduceSupportedLangs = (lng, supportedLngs, browserLngs = []) => uniq([ lng, ...browserLngs ].filter(Boolean).reduce((curr, nextLng) => (curr.push(nextLng, mainLng(nextLng)),
+curr), [])).reduce((curr, nextLng) => (supportedLngs.includes(nextLng) && curr.push(nextLng),
+curr), []);
+class I18n {
+  constructor(options) {
+    const {supportedLngs: supportedLngs, lng: lng, defaultNs: defaultNs, fallbackLng: fallbackLng = supportedLngs[0], resources: resources = {}, debug: debug, ...opts} = {
+      ...defaultOptions,
+      ...options
+    };
+    if (!supportedLngs?.length) throw new Error('no supportedLngs');
+    this.options = opts, this.defaultNs = defaultNs, this.fallbackLng = fallbackLng,
+    this.lng = lng || this.fallbackLng, this.supportedLngs = supportedLngs, this.userLng = lng,
+    this.resources = resources, debug && (log = opts.log || console), this.t = this.t.bind(this),
+    this.getLanguages = this.getLanguages.bind(this), this._setLanguage();
+  }
+  t(label, values = {}) {
+    const {lng: language, fallbackLng: fallbackLng, defaultNs: defaultNs} = this, {lng: lng = language, ns: ns = defaultNs, ...msgValues} = values, message = this.resources[lng]?.[ns]?.[label] || this.resources[fallbackLng]?.[ns]?.[label] || (this.options.useLabel ? label : '');
+    return format(message, msgValues, lng);
+  }
+  getUserLanguage() {
+    if (!isBrowser) return this.fallbackLng;
+    const [cookieLng, browserLng] = this._getSettings();
+    return log.debug('getUserLanguage: cookieLng:%s browserLng:%s', cookieLng, browserLng),
+    cookieLng || browserLng;
+  }
+  resetUserLanguage() {
+    if (!isBrowser) return;
+    const {name: name, ...opts} = this.options.cookie;
+    log.debug('reset cookie'), document.cookie = cookieSerialize(name, '', {
+      ...opts,
+      expires: 0
+    }), this._setLanguage();
+  }
+  _getSettings() {
+    const {name: name} = this.options.cookie, cookieLng = cookieParse(document.cookie)[name], browserLng = globalThis?.navigator?.language;
+    return console.log(document.cookie, cookieLng, browserLng), [ cookieLng, browserLng ];
+  }
+  _setCookie() {
+    if (!isBrowser) return;
+    const [cookieLng, browserLng] = this._getSettings(), {userLng: language = ""} = this;
+    if (cookieLng === language) return;
+    let expires, value = language;
+    [ browserLng, mainLng(browserLng) ].includes(language) && (expires = 0, value = '');
+    const {name: name, ...opts} = this.options.cookie;
+    log.debug('_setCookie: %s:%s', 0 === expires ? 'reset' : 'set', language), document.cookie = cookieSerialize(name, value, {
+      ...opts,
+      expires: expires
+    });
+  }
+  _setLanguage(lng) {
+    const _lng = lng || this.getUserLanguage(), {supportedLngs: supportedLngs} = this, browserLngs = globalThis?.navigator?.languages || [], variants = reduceSupportedLangs(_lng, supportedLngs, browserLngs);
+    if (variants.length) this.userLng = _lng, this.lng = variants[0]; else {
+      this.userLng = this.lng = this.fallbackLng;
+      const [main] = this.lng.split('-');
+      variants.push(...uniq([ this.lng, main ]));
+    }
+    return this._setCookie(), variants;
+  }
+  getLanguages() {
+    return this.supportedLngs;
+  }
+  async changeLanguage(lng) {
+    const variants = this._setLanguage(lng);
+    log.debug('changeLanguage: lng:%s variants:%s', lng, variants), await this.loadLanguages(variants);
+    let loadedLng = this.fallbackLng;
+    for (const variant of variants) if (this.resources[variant]?.[this.defaultNs]) {
+      loadedLng = variant;
+      break;
+    }
+    log.debug('changeLanguage: loadedLng:%s', loadedLng);
+    const mainLoadedLng = mainLng(loadedLng);
+    if (mainLng(lng || variants[0]) !== mainLoadedLng) {
+      const matchLng = variants.find(variant => mainLng(variant) === mainLoadedLng);
+      this._setLanguage(matchLng || loadedLng);
+    }
+    this._setCookie();
+  }
+  async changeNamespace(ns) {
+    this.defaultNs = ns, await this.loadLanguages([ this.lng, this.fallbackLng ]);
+  }
+  async loadLanguages(lngs = [], ns = []) {
+    const _lngs = uniq(lngs), _ns = uniq([ ...ns, this.defaultNs ]);
+    if (!_lngs.length || !_ns.length) return log.error("can't load without languages or namespaces"),
+    [];
+    const loaders = [];
+    for (const lng of _lngs) for (const ns of _ns) this.resources[lng]?.[ns] || loaders.push(this._load({
+      lng: lng,
+      ns: ns
+    }).catch(err => log.error(err)));
+    return await Promise.all(loaders);
+  }
+  async _load({lng: lng, ns: ns}) {
+    const {version: version} = this.options, url = format(this.options.localesPath, {
+      lng: lng,
+      ns: ns,
+      version: version
+    }), res = await fetch(url).catch(err => log.error(err));
+    this.resources[lng] = this.resources[lng] || {};
+    const {ok: ok = !1, status: status = -1} = res || {};
+    if (ok && res) {
+      log.debug('_load: lng=%s ns=%s', lng, ns);
+      const labels = await res.json();
+      this.resources[lng][ns] = labels;
+    } else log.error('_load: error loading url=%s', url);
+    return {
+      ok: ok,
+      status: status,
+      lng: lng,
+      ns: ns
+    };
+  }
+}
+export { I18n, reduceSupportedLangs };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,9 @@
+export { I18n } from './i18n.js';
+export { cookieParse, cookieSerialize } from './cookie.js';
+export { INTL_CONTEXT, MiIntlProvider } from './intl-provider.js';
+export { MiIntlMessage } from './intl-message.js';
+export { IntlConsumer } from './intl-consumer.js';

package/dist/index.min.js ADDED Viewed

@@ -0,0 +1 @@

+ import{cached as s}from"intl-messageformat-tiny";import{MiElement as t,ContextProvider as e,ContextConsumer as n}from"mi-element";function o(s=""){const t=s.split(/\s*;\s*/),e={};for(const s of t){const[t,n]=s.split("=");if(t){const s=decodeURIComponent(n);e[t]=s}}return e}const a=/^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;function i(s,t,e){const{maxAge:n,domain:o,path:i,expires:g,httpOnly:r=!1,secure:l=!1,sameSite:u="Strict"}=e||{};if(!s||!a.test(s))throw TypeError("invalid name");const c=[`${s}=${encodeURIComponent(t)}`];return!isNaN(n-0)&&isFinite(n)&&c.push(`Max-Age=${n}`),o&&a.test(o)&&c.push(`Domain=${o}`),i&&a.test(i)&&c.push(`Path=${i}`),isNaN(new Date(g).getTime())||c.push(`Expires=${new Date(g).toUTCString()}`),r&&c.push("HttpOnly"),l&&c.push("Secure"),u&&c.push(`SameSite=${u}`),c.join("; ")}const g=s(),r=globalThis?.navigator?.language&&globalThis?.document,l="translations",u={supportedLngs:[],version:"",ns:[l],defaultNs:l,localesPath:"/locales/{lng}/{ns}.json?v={version}",useLabel:!1,debug:!1,cookie:{name:"lc",path:"/"}};let c={debug:(...s)=>{},error:(...s)=>{}};const h=s=>[...new Set(s.filter(Boolean))],d=s=>(s||"").split("-",1)[0];class p{constructor(s){const{supportedLngs:t,lng:e,defaultNs:n,fallbackLng:o=t[0],resources:a={},debug:i,...g}={...u,...s};if(!t?.length)throw new Error("no supportedLngs");this.options=g,this.defaultNs=n,this.fallbackLng=o,this.lng=e||this.fallbackLng,this.supportedLngs=t,this.userLng=e,this.resources=a,i&&(c=g.log||console),this.t=this.t.bind(this),this.getLanguages=this.getLanguages.bind(this),this._setLanguage()}t(s,t={}){const{lng:e,fallbackLng:n,defaultNs:o}=this,{lng:a=e,ns:i=o,...r}=t,l=this.resources[a]?.[i]?.[s]||this.resources[n]?.[i]?.[s]||(this.options.useLabel?s:"");return g(l,r,a)}getUserLanguage(){if(!r)return this.fallbackLng;const[s,t]=this._getSettings();return c.debug("getUserLanguage: cookieLng:%s browserLng:%s",s,t),s||t}resetUserLanguage(){if(!r)return;const{name:s,...t}=this.options.cookie;c.debug("reset cookie"),document.cookie=i(s,"",{...t,expires:0}),this._setLanguage()}_getSettings(){const{name:s}=this.options.cookie,t=o(document.cookie)[s],e=globalThis?.navigator?.language;return console.log(document.cookie,t,e),[t,e]}_setCookie(){if(!r)return;const[s,t]=this._getSettings(),{userLng:e=""}=this;if(s===e)return;let n,o=e;[t,d(t)].includes(e)&&(n=0,o="");const{name:a,...g}=this.options.cookie;c.debug("_setCookie: %s:%s",0===n?"reset":"set",e),document.cookie=i(a,o,{...g,expires:n})}_setLanguage(s){const t=s||this.getUserLanguage(),{supportedLngs:e}=this,n=((s,t,e=[])=>h([s,...e].filter(Boolean).reduce((s,t)=>(s.push(t,d(t)),s),[])).reduce((s,e)=>(t.includes(e)&&s.push(e),s),[]))(t,e,globalThis?.navigator?.languages||[]);if(n.length)this.userLng=t,this.lng=n[0];else{this.userLng=this.lng=this.fallbackLng;const[s]=this.lng.split("-");n.push(...h([this.lng,s]))}return this._setCookie(),n}getLanguages(){return this.supportedLngs}async changeLanguage(s){const t=this._setLanguage(s);c.debug("changeLanguage: lng:%s variants:%s",s,t),await this.loadLanguages(t);let e=this.fallbackLng;for(const s of t)if(this.resources[s]?.[this.defaultNs]){e=s;break}c.debug("changeLanguage: loadedLng:%s",e);const n=d(e);if(d(s||t[0])!==n){const s=t.find(s=>d(s)===n);this._setLanguage(s||e)}this._setCookie()}async changeNamespace(s){this.defaultNs=s,await this.loadLanguages([this.lng,this.fallbackLng])}async loadLanguages(s=[],t=[]){const e=h(s),n=h([...t,this.defaultNs]);if(!e.length||!n.length)return c.error("can't load without languages or namespaces"),[];const o=[];for(const s of e)for(const t of n)this.resources[s]?.[t]||o.push(this._load({lng:s,ns:t}).catch(s=>c.error(s)));return await Promise.all(o)}async _load({lng:s,ns:t}){const{version:e}=this.options,n=g(this.options.localesPath,{lng:s,ns:t,version:e}),o=await fetch(n).catch(s=>c.error(s));this.resources[s]=this.resources[s]||{};const{ok:a=!1,status:i=-1}=o||{};if(a&&o){c.debug("_load: lng=%s ns=%s",s,t);const e=await o.json();this.resources[s][t]=e}else c.error("_load: error loading url=%s",n);return{ok:a,status:i,lng:s,ns:t}}}const L="mi-intl",f=()=>new Promise(s=>requestAnimationFrame(s));class m extends t{static get attributes(){return{version:"",lng:String,defaultNs:"translations",ns:"translations",supportedLngs:"",localesPath:"/locales/{lng}/{ns}.json?v={version}",useLabel:Boolean,debug:!1}}static get properties(){return{loading:!1}}static template="<slot></slot>";set options(s){this.i18n=new p(s),this.changeLanguage(s?.lng).catch(console.error)}_contextValue(){const{t:s,lng:t,getLanguages:e}=this.i18n??{t:()=>"",lng:"",getLanguages:()=>[]};return{t:s,lng:t,getLanguages:e,changeLanguage:this.changeLanguage.bind(this),loading:this.loading??!1}}async changeLanguage(s){this.loading=!0,await(this.i18n?.changeLanguage(s).finally(()=>{this.requestUpdate()})),await f(),await f(),this.loading=!1}render(){const s=this.supportedLngs.split(","),t=this.ns.split(",");this.i18n=new p({...this,supportedLngs:s,ns:t}),this.provider=new e(this,L,this._contextValue()),this.changeLanguage(this.lng).catch(console.error)}update(){this.provider?.set(this._contextValue())}}class b extends n{constructor(s,t=!0){super(s,L,{subscribe:t})}}class k extends t{#s;constructor(){super(),this.#s=new b(this)}t(s,t){return this.#s.value.t(s,t)}}export{p as I18n,L as INTL_CONTEXT,b as IntlConsumer,k as MiIntlMessage,m as MiIntlProvider,o as cookieParse,i as cookieSerialize};

package/dist/intl-consumer.js ADDED Viewed

@@ -0,0 +1,13 @@
+import { ContextConsumer } from 'mi-element';
+import { INTL_CONTEXT } from './intl-provider.js';
+class IntlConsumer extends ContextConsumer {
+  constructor(miElement, subscribe = !0) {
+    super(miElement, INTL_CONTEXT, {
+      subscribe: subscribe
+    });
+  }
+}
+export { IntlConsumer };

package/dist/intl-message.js ADDED Viewed

@@ -0,0 +1,15 @@
+import { MiElement } from 'mi-element';
+import { IntlConsumer } from './intl-consumer.js';
+class MiIntlMessage extends MiElement {
+  #context;
+  constructor() {
+    super(), this.#context = new IntlConsumer(this);
+  }
+  t(label, value) {
+    return this.#context.value.t(label, value);
+  }
+}
+export { MiIntlMessage };

package/dist/intl-provider.js ADDED Viewed

@@ -0,0 +1,62 @@
+import { MiElement, ContextProvider } from 'mi-element';
+import { I18n } from './i18n.js';
+const INTL_CONTEXT = 'mi-intl', requestAnimationFrameP = () => new Promise(resolve => requestAnimationFrame(resolve));
+class MiIntlProvider extends MiElement {
+  static get attributes() {
+    return {
+      version: '',
+      lng: String,
+      defaultNs: 'translations',
+      ns: 'translations',
+      supportedLngs: '',
+      localesPath: '/locales/{lng}/{ns}.json?v={version}',
+      useLabel: Boolean,
+      debug: !1
+    };
+  }
+  static get properties() {
+    return {
+      loading: !1
+    };
+  }
+  static template='<slot></slot>';
+  set options(options) {
+    this.i18n = new I18n(options), this.changeLanguage(options?.lng).catch(console.error);
+  }
+  _contextValue() {
+    const {t: t, lng: lng, getLanguages: getLanguages} = this.i18n ?? {
+      t: () => '',
+      lng: '',
+      getLanguages: () => []
+    };
+    return {
+      t: t,
+      lng: lng,
+      getLanguages: getLanguages,
+      changeLanguage: this.changeLanguage.bind(this),
+      loading: this.loading ?? !1
+    };
+  }
+  async changeLanguage(lng) {
+    this.loading = !0, await (this.i18n?.changeLanguage(lng).finally(() => {
+      this.requestUpdate();
+    })), await requestAnimationFrameP(), await requestAnimationFrameP(), this.loading = !1;
+  }
+  render() {
+    const supportedLngs = this.supportedLngs.split(','), ns = this.ns.split(',');
+    this.i18n = new I18n({
+      ...this,
+      supportedLngs: supportedLngs,
+      ns: ns
+    }), this.provider = new ContextProvider(this, "mi-intl", this._contextValue()),
+    this.changeLanguage(this.lng).catch(console.error);
+  }
+  update() {
+    this.provider?.set(this._contextValue());
+  }
+}
+export { INTL_CONTEXT, MiIntlProvider };

package/package.json ADDED Viewed

@@ -0,0 +1,78 @@
+{
+  "name": "mi-intl",
+  "version": "0.6.3",
+  "description": "Translations",
+  "keywords": [
+    "i18n",
+    "translations"
+  ],
+  "homepage": "https://github.com/commenthol/mi-element/tree/main/packages/mi-intl",
+  "bugs": {
+    "url": "https://github.com/commenthol/mi-element/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/commenthol/mi-element.git",
+    "directory": "packages/mi-intl"
+  },
+  "license": "MIT",
+  "author": "commenthol <commenthol@gmail.com>",
+  "maintainers": [
+    "commenthol <commenthol@gmail.com>"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "development": "./src/index.js",
+      "types": "./types/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./min": {
+      "types": "./types/index.d.ts",
+      "default": "./dist/index.min.js"
+    }
+  },
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "dist",
+    "types"
+  ],
+  "dependencies": {
+    "intl-messageformat-tiny": "^1.1.0",
+    "mi-element": "0.6.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.34.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@testing-library/dom": "^10.4.1",
+    "@types/node": "^24.3.0",
+    "@vitest/browser": "^3.2.4",
+    "@vitest/coverage-istanbul": "^3.2.4",
+    "eslint": "^9.34.0",
+    "globals": "^16.3.0",
+    "npm-run-all2": "^8.0.4",
+    "playwright": "^1.55.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.48.1",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.3",
+    "vitest": "^3.2.4",
+    "mi-html": "0.6.3"
+  },
+  "scripts": {
+    "all": "npm-run-all pretty lint test build types",
+    "build": "rimraf dist && rollup -c && gzip -k dist/index.min.js && ls -al dist && rimraf dist/index.min.js.gz",
+    "dev": "npm run test:browser",
+    "docs": "cd docs; for f in *.md; do markedpp -s -i $f; done",
+    "example": "vite --force --open /example/",
+    "lint": "eslint",
+    "pretty": "prettier -w **/*.js",
+    "setup": "pnpm exec playwright install",
+    "test": "vitest run --coverage",
+    "test:browser": "vitest --coverage",
+    "types": "rimraf types; tsc"
+  }
+}

package/src/cookie.js ADDED Viewed

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: Unlicense
+// from https://github.com/commenthol/snippets
+/**
+ * parses a cookie string
+ * @param {string} cookieStr
+ * @returns {{[cookieName: string]: string}|{}}
+ */
+export function cookieParse(cookieStr = '') {
+  const parts = cookieStr.split(/\s*;\s*/)
+  const cookies = {}
+  for (const part of parts) {
+    const [key, val] = part.split('=')
+    if (key) {
+      const value = decodeURIComponent(val)
+      cookies[key] = value
+    }
+  }
+  return cookies
+}
+/**
+ * RegExp to match field-content in RFC 7230 sec 3.2
+ *
+ * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ]
+ * field-vchar   = VCHAR / obs-text
+ * obs-text      = %x80-FF
+ */
+// eslint-disable-next-line no-control-regex
+const fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/
+const isDate = (d) => !isNaN(new Date(d).getTime())
+/**
+ * serializes a cookie
+ * @param {string} name
+ * @param {any} value
+ * @param {object} options
+ * @param {number} [options.maxAge]
+ * @param {string} [options.domain]
+ * @param {string} [options.path]
+ * @param {number|string|Date} [options.expires]
+ * @param {boolean} [options.httpOnly=true]
+ * @param {boolean} [options.secure=false]
+ * @param {string|'Strict'|'Lax'|'None'|''|false} [options.sameSite='Strict']
+ * @returns {string}
+ */
+export function cookieSerialize(name, value, options) {
+  const {
+    maxAge,
+    domain,
+    path,
+    expires,
+    httpOnly = false,
+    secure = false,
+    sameSite = 'Strict'
+  } = options || {}
+  if (!name || !fieldContentRegExp.test(name)) {
+    throw TypeError('invalid name')
+  }
+  const parts = [`${name}=${encodeURIComponent(value)}`]
+  // @ts-expect-error
+  if (!isNaN(maxAge - 0) && isFinite(maxAge)) {
+    parts.push(`Max-Age=${maxAge}`)
+  }
+  if (domain && fieldContentRegExp.test(domain)) {
+    parts.push(`Domain=${domain}`)
+  }
+  if (path && fieldContentRegExp.test(path)) {
+    parts.push(`Path=${path}`)
+  }
+  if (isDate(expires)) {
+    // @ts-expect-error
+    parts.push(`Expires=${new Date(expires).toUTCString()}`)
+  }
+  if (httpOnly) {
+    parts.push('HttpOnly')
+  }
+  /* istanbul ignore next 3 */
+  if (secure) {
+    parts.push('Secure')
+  }
+  if (sameSite) {
+    parts.push(`SameSite=${sameSite}`)
+  }
+  return parts.join('; ')
+}