@localess/client 3.3.0-dev.20260708093226 → 3.3.0-dev.20260708124505

package/README.md

@@ -222,18 +222,14 @@ When your application is loaded inside the Localess Visual Editor, you can subsc
 
 ```ts
 if (window.localess) {
-  // Subscribe to a single event
+  // Subscribe to a single event — `event` is typed to that event's variant, no narrowing needed
   window.localess.on('change', (event) => {
-    if (event.type === 'change') {
-      setPageData(event.data);
-    }
+    setPageData(event.data);
   });
 
-  // Subscribe to multiple events
+  // Subscribe to multiple events — `event` is narrowed to the union of those variants
   window.localess.on(['input', 'change'], (event) => {
-    if (event.type === 'input' || event.type === 'change') {
-      setPageData(event.data);
-    }
+    setPageData(event.data);
   });
 }
 ```

package/SKILL.md

@@ -204,14 +204,16 @@ import { localessEditable, localessEditableField } from "@localess/client";
 // Only available when app is loaded inside the Localess Visual Editor iframe
 if (window.localess) {
   window.localess.on(['input', 'change'], (event) => {
-    if (event.type === 'input' || event.type === 'change') {
-      setPageData(event.data); // Real-time preview update
-    }
+    setPageData(event.data); // Real-time preview update — event is narrowed to the 'input' | 'change' variant, no type check needed
   });
   // No .off() method — subscribe once on mount
 }
 ```
 
+> `on`'s callback type is inferred from the event(s) passed in — subscribing to `['input', 'change']` narrows `event` to the variant carrying `data`, so no manual `event.type === ...` check is needed inside the callback.
+
+`window.localess.onChange(callback)` is shorthand for `on(['input', 'change'], callback)` — it fires only for content-change events, with `callback` narrowed to that variant.
+
 **Event types:**
 
 | Event         | When                                  |
@@ -334,7 +336,7 @@ export type {
   ContentMetadata, ContentAsset, ContentLink,
   ContentRichText, ContentReference,
   Links, References, Translations,
-  LocalessSync, EventToApp, EventCallback, EventToAppType,
+  LocalessSync, EventToApp, EventToAppOf, EventCallback, EventToAppType,
   AssetTransformParams,
 }
 ```

package/dist/index.d.ts

@@ -17,9 +17,17 @@ export type EventToApp = {
     schema: string;
     field?: string;
 };
+/**
+ * Narrows {@link EventToApp} down to the variant(s) matching event type `T`.
+ * Used to type {@link LocalessSync.on}'s callback based on the subscribed event(s),
+ * e.g. subscribing to `'input' | 'change'` narrows the callback's `event` to the variant with `data`.
+ */
+export type EventToAppOf<T extends EventToAppType> = Extract<EventToApp, {
+    type: T;
+}>;
 export interface LocalessSync {
-    onChange: (callback: EventCallback) => void;
-    on: (event: EventToAppType | EventToAppType[], callback: EventCallback) => void;
+    onChange: (callback: (event: EventToAppOf<'change' | 'input'>) => void) => void;
+    on: <T extends EventToAppType>(event: T | T[], callback: (event: EventToAppOf<T>) => void) => void;
 }
 declare global {
     interface Window {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/client",
-  "version": "3.3.0-dev.20260708093226",
+  "version": "3.3.0-dev.20260708124505",
   "description": "Universal JavaScript/TypeScript SDK for Localess's API.",
   "keywords": [
     "localess",