@pechynho/stimulus-typescript 0.0.9 → 0.0.11

package/dist/utils.d.ts

@@ -1,6 +1,8 @@
 import { ActionEvent, Application, Controller } from "@hotwired/stimulus";
 export declare const camelCase: (value: string) => string;
 export declare const capitalize: (value: string) => string;
+export declare function addStimulusAction(element: HTMLElement, identifier: string, method: string, event?: string, params?: Record<string, object | string | number | boolean>): void;
+export declare function removeStimulusAction(element: HTMLElement, identifier: string, method: string, event?: string, removeParams?: boolean): void;
 export declare const isActionEvent: (value: any) => value is ActionEvent;
 export declare const getController: <T extends Controller>(app: Application, element: HTMLElement, identifier: string) => T | null;
 export declare const getControllerAsync: <T extends Controller>(app: Application, element: HTMLElement, identifier: string, timeout?: number, poll?: number) => Promise<T | null>;

package/dist/utils.js

@@ -6,8 +6,52 @@ export const camelCase = (value) => {
 export const capitalize = (value) => {
     return value.charAt(0).toUpperCase() + value.slice(1);
 };
+export function addStimulusAction(element, identifier, method, event, params) {
+    const existing = element.dataset.action;
+    const actions = existing !== undefined && existing.trim() !== ''
+        ? existing.trim().split(/\s+/)
+        : [];
+    const target = `${identifier}#${method}`;
+    const descriptor = event !== undefined ? `${event}->${target}` : target;
+    if (!actions.includes(descriptor)) {
+        actions.push(descriptor);
+    }
+    element.dataset.action = actions.join(' ');
+    if (params !== undefined) {
+        for (const [key, value] of Object.entries(params)) {
+            const serialized = typeof value === 'object'
+                ? JSON.stringify(value)
+                : String(value);
+            element.dataset[`${camelCase(identifier)}${capitalize(camelCase(key))}Param`] = String(serialized);
+        }
+    }
+}
+export function removeStimulusAction(element, identifier, method, event, removeParams = false) {
+    const existing = element.dataset.action;
+    if (existing === undefined || existing.trim() === '') {
+        return;
+    }
+    const target = `${identifier}#${method}`;
+    const descriptor = event !== undefined ? `${event}->${target}` : target;
+    const actions = existing.trim().split(/\s+/).filter((a) => a !== descriptor);
+    if (actions.length > 0) {
+        element.dataset.action = actions.join(' ');
+    }
+    else {
+        delete element.dataset.action;
+    }
+    if (removeParams) {
+        const prefix = `${camelCase(identifier)}`;
+        const suffix = 'Param';
+        for (const key of Object.keys(element.dataset)) {
+            if (key.startsWith(prefix) && key.endsWith(suffix)) {
+                delete element.dataset[key];
+            }
+        }
+    }
+}
 export const isActionEvent = (value) => {
-    return value instanceof Event && 'params' in value && typeof value.params !== 'object';
+    return value instanceof Event && 'params' in value && typeof value.params === 'object';
 };
 export const getController = (app, element, identifier) => {
     return app.getControllerForElementAndIdentifier(element, identifier);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pechynho/stimulus-typescript",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Set of TypeScript utilities for Stimulus controllers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/utils.ts

@@ -10,8 +10,69 @@ export const capitalize = (value: string): string => {
     return value.charAt(0).toUpperCase() + value.slice(1);
 };
 
+export function addStimulusAction(
+    element: HTMLElement,
+    identifier: string,
+    method: string,
+    event?: string,
+    params?: Record<string, object | string | number | boolean>,
+): void {
+    const existing = element.dataset.action;
+    const actions = existing !== undefined && existing.trim() !== ''
+        ? existing.trim().split(/\s+/)
+        : [];
+    const target = `${identifier}#${method}`;
+    const descriptor = event !== undefined ? `${event}->${target}` : target;
+    if (!actions.includes(descriptor)) {
+        actions.push(descriptor);
+    }
+    element.dataset.action = actions.join(' ');
+    if (params !== undefined) {
+        for (const [key, value] of Object.entries(params)) {
+            const serialized = typeof value === 'object'
+                ? JSON.stringify(value)
+                : String(value);
+            element.dataset[`${camelCase(identifier)}${capitalize(camelCase(key))}Param`] = String(serialized);
+        }
+    }
+}
+
+export function removeStimulusAction(
+    element: HTMLElement,
+    identifier: string,
+    method: string,
+    event?: string,
+    removeParams: boolean = false,
+): void {
+    const existing = element.dataset.action;
+    if (existing === undefined || existing.trim() === '') {
+        return;
+    }
+
+    const target = `${identifier}#${method}`;
+    const descriptor = event !== undefined ? `${event}->${target}` : target;
+    const actions = existing.trim().split(/\s+/).filter((a) => a !== descriptor);
+
+    if (actions.length > 0) {
+        element.dataset.action = actions.join(' ');
+    } else {
+        delete element.dataset.action;
+    }
+
+    if (removeParams) {
+        const prefix = `${camelCase(identifier)}`;
+        const suffix = 'Param';
+
+        for (const key of Object.keys(element.dataset)) {
+            if (key.startsWith(prefix) && key.endsWith(suffix)) {
+                delete element.dataset[key];
+            }
+        }
+    }
+}
+
 export const isActionEvent = (value: any): value is ActionEvent => {
-    return value instanceof Event && 'params' in value && typeof value.params !== 'object';
+    return value instanceof Event && 'params' in value && typeof value.params === 'object';
 }
 
 export const getController = <T extends Controller>(app: Application, element: HTMLElement, identifier: string): T | null => {