@vielzeug/ore 3.0.1 → 26.10.1

package/dist/utils/emit.js

@@ -1,2 +1,2 @@
-import{getHost as e}from"../runtime.js";var t={bubbles:!0,cancelable:!0,composed:!1},n=()=>{let n=e();return((e,...r)=>{let i=r.length>0?{...t,detail:r[0]}:t;return n.dispatchEvent(new CustomEvent(String(e),i))})};export{n as useEmit};
+import{getHost as e}from"../runtime.js";var t={bubbles:!0,cancelable:!0,composed:!0},n=()=>{let n=e();return((e,...r)=>{let i=r.length>0?{...t,detail:r[0]}:t;return n.dispatchEvent(new CustomEvent(String(e),i))})};export{n as useEmit};
 //# sourceMappingURL=emit.js.map

package/dist/utils/emit.js.map

@@ -1 +1 @@
-{"version":3,"file":"emit.js","names":[],"sources":["../../src/utils/emit.ts"],"sourcesContent":["/**\n * Type-safe custom event emission for components.\n */\n\nimport { getHost } from '../runtime';\n\ntype NoDetail = undefined | undefined | never;\ntype KeysWithoutDetail<T extends Record<string, unknown>> = {\n  [P in keyof T]: [T[P]] extends [NoDetail] ? P : never;\n}[keyof T];\n\n/**\n * Typed emit function: only declared event names type-check, and `detail` is\n * required exactly when its payload type is non-void. Dynamic event names must\n * be cast at the call site — an intentional speed bump, not a silent escape.\n */\nexport type EmitFn<T extends Record<string, unknown>> = {\n  <K extends KeysWithoutDetail<T>>(event: K): boolean;\n  <K extends Exclude<keyof T, KeysWithoutDetail<T>>>(event: K, detail: T[K]): boolean;\n};\n\nconst DEFAULT_FIRE_OPTIONS = { bubbles: true, cancelable: true, composed: false };\n\n/**\n * Returns a typed `emit()` function bound to the current component's host element.\n * Call once during `setup()` — the `Emits` type parameter maps event names to\n * their `detail` payload type.\n *\n * Every event is dispatched `cancelable: true`, and `emit()` returns `dispatchEvent`'s\n * own boolean result — `false` when a listener called `preventDefault()`. Components\n * that need to know whether a listener cancelled an event (e.g. to skip a default\n * action) read this return value directly instead of hand-rolling `dispatchEvent`.\n *\n * Events do **not** cross the shadow boundary by default (`composed: false`) — a\n * listener outside the component's shadow root will not observe them. Dispatch a\n * `CustomEvent` with `composed: true` by hand if an event must escape the shadow root.\n *\n * @example\n * ```ts\n * type Events = { close: undefined; change: { value: string } };\n *\n * setup(props) {\n *   const emit = useEmit<Events>();\n *   emit('close');\n *\n *   const notCancelled = emit('change', { value: 'ok' });\n *   if (notCancelled) props.value.value = 'ok';\n * }\n * ```\n */\nexport const useEmit = <T extends Record<string, unknown> = Record<string, never>>(): EmitFn<T> => {\n  const host = getHost();\n\n  return ((event: keyof T, ...rest: unknown[]) => {\n    const customEventInit = rest.length > 0 ? { ...DEFAULT_FIRE_OPTIONS, detail: rest[0] } : DEFAULT_FIRE_OPTIONS;\n\n    return host.dispatchEvent(new CustomEvent<unknown>(String(event), customEventInit));\n  }) as EmitFn<T>;\n};\n"],"mappings":"wCAqBA,IAAM,EAAuB,CAAE,QAAS,GAAM,WAAY,GAAM,SAAU,EAAM,EA6BnE,MAAsF,CACjG,IAAM,EAAO,EAAQ,EAErB,QAAS,EAAgB,GAAG,IAAoB,CAC9C,IAAM,EAAkB,EAAK,OAAS,EAAI,CAAE,GAAG,EAAsB,OAAQ,EAAK,EAAG,EAAI,EAEzF,OAAO,EAAK,cAAc,IAAI,YAAqB,OAAO,CAAK,EAAG,CAAe,CAAC,CACpF,EACF"}
+{"version":3,"file":"emit.js","names":[],"sources":["../../src/utils/emit.ts"],"sourcesContent":["/**\n * Type-safe custom event emission for components.\n */\n\nimport { getHost } from '../runtime';\n\ntype NoDetail = undefined | undefined | never;\ntype KeysWithoutDetail<T extends Record<string, unknown>> = {\n  [P in keyof T]: [T[P]] extends [NoDetail] ? P : never;\n}[keyof T];\n\n/**\n * Typed emit function: only declared event names type-check, and `detail` is\n * required exactly when its payload type is non-void. Dynamic event names must\n * be cast at the call site: an intentional speed bump, not a silent escape.\n */\nexport type EmitFn<T extends Record<string, unknown>> = {\n  <K extends KeysWithoutDetail<T>>(event: K): boolean;\n  <K extends Exclude<keyof T, KeysWithoutDetail<T>>>(event: K, detail: T[K]): boolean;\n};\n\nconst DEFAULT_FIRE_OPTIONS = { bubbles: true, cancelable: true, composed: true };\n\n/**\n * Returns a typed `emit()` function bound to the current component's host element.\n * Call once during `setup()`: the `Emits` type parameter maps event names to\n * their `detail` payload type.\n *\n * Every event is dispatched `cancelable: true`, and `emit()` returns `dispatchEvent`'s\n * own boolean result: `false` when a listener called `preventDefault()`. Components\n * that need to know whether a listener cancelled an event (e.g. to skip a default\n * action) read this return value directly instead of hand-rolling `dispatchEvent`.\n *\n * Events are dispatched `bubbles: true, composed: true`: the same convention as\n * `ore:error` and native form-control re-dispatches. A listener on the host, an\n * ancestor, or `document` observes the event even when the component is nested\n * inside another component's shadow root, so composed events integrate with\n * document-level and framework (e.g. React synthetic) listeners without an\n * escape hatch.\n *\n * @example\n * ```ts\n * type Events = { close: undefined; change: { value: string } };\n *\n * setup(props) {\n *   const emit = useEmit<Events>();\n *   emit('close');\n *\n *   const notCancelled = emit('change', { value: 'ok' });\n *   if (notCancelled) props.value.value = 'ok';\n * }\n * ```\n */\nexport const useEmit = <T extends Record<string, unknown> = Record<string, never>>(): EmitFn<T> => {\n  const host = getHost();\n\n  return ((event: keyof T, ...rest: unknown[]) => {\n    const customEventInit = rest.length > 0 ? { ...DEFAULT_FIRE_OPTIONS, detail: rest[0] } : DEFAULT_FIRE_OPTIONS;\n\n    return host.dispatchEvent(new CustomEvent<unknown>(String(event), customEventInit));\n  }) as EmitFn<T>;\n};\n"],"mappings":"wCAqBA,IAAM,EAAuB,CAAE,QAAS,GAAM,WAAY,GAAM,SAAU,EAAK,EAgClE,MAAsF,CACjG,IAAM,EAAO,EAAQ,EAErB,QAAS,EAAgB,GAAG,IAAoB,CAC9C,IAAM,EAAkB,EAAK,OAAS,EAAI,CAAE,GAAG,EAAsB,OAAQ,EAAK,EAAG,EAAI,EAEzF,OAAO,EAAK,cAAc,IAAI,YAAqB,OAAO,CAAK,EAAG,CAAe,CAAC,CACpF,EACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/ore",
-  "version": "3.0.1",
+  "version": "26.10.1",
   "description": "Functional web-component authoring on top of ripple",
   "repository": {
     "type": "git",
@@ -53,8 +53,8 @@
     "test:types": "tsc -p tsconfig.json --noEmit"
   },
   "peerDependencies": {
-    "@vielzeug/assay": "^3.0.0",
-    "@vielzeug/ripple": "^3.0.0"
+    "@vielzeug/assay": "^26.10.1",
+    "@vielzeug/ripple": "^26.10.1"
   },
   "peerDependenciesMeta": {
     "@vielzeug/assay": {
@@ -62,13 +62,13 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
-    "@vielzeug/assay": "3.0.0",
-    "@vielzeug/ripple": "3.0.0",
+    "@types/node": "^26.6.2",
+    "@vielzeug/assay": "26.10.1",
+    "@vielzeug/ripple": "26.10.1",
     "axe-core": "^4.13.0",
-    "jsdom": "^30.0.1",
+    "jsdom": "^30.1.1",
     "typescript": "^6.0.3",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1"
   }
 }