Skip to content

forcedotcom/sf-skills / plugins/builder/experience-lwc/skills/experience-lwc-generate

experience-lwc-generate

Unverified

Lightning Web Components with PICKLES methodology and 165-point scoring. Use this skill when the user creates or edits LWC components, builds wire service patterns, or writes Jest tests for LWC. TRIGGER when: user creates/edits LWC components, touches lwc/**/*.js, .html, .css, .js-meta.xml files, or asks about wire service, SLDS, or Jest LWC tests. DO NOT TRIGGER when: Apex classes (use platform-apex-generate), Aura components, or Visualforce.

FileKindSize
README.mdmarkdown4.1 KB
SKILL.mdskill md9.6 KB
assets/apex-controller/LwcController.clsother12.0 KB
assets/basic-component/basicComponent.cssother1.5 KB
assets/basic-component/basicComponent.htmlother4.5 KB
assets/basic-component/basicComponent.jsscript7.3 KB
assets/basic-component/basicComponent.js-meta.xmlconfig4.5 KB
assets/datatable-component/datatableComponent.htmlother4.1 KB
assets/datatable-component/datatableComponent.jsscript13.1 KB
assets/flow-screen-component/flowScreenComponent.cssother1.7 KB
assets/flow-screen-component/flowScreenComponent.htmlother7.1 KB
assets/flow-screen-component/flowScreenComponent.jsscript13.9 KB
assets/flow-screen-component/flowScreenComponent.js-meta.xmlconfig3.9 KB
assets/form-component/formComponent.htmlother6.4 KB
assets/form-component/formComponent.jsscript11.3 KB
assets/graphql-component/graphqlComponent.htmlother4.8 KB
assets/graphql-component/graphqlComponent.jsscript10.7 KB
assets/jest-test/componentName.test.js.exampleother15.6 KB
assets/message-channel/RecordSelected.messageChannel-meta.xmlconfig2.4 KB
assets/message-channel/lmsPublisher.jsscript3.8 KB
assets/message-channel/lmsSubscriber.jsscript7.0 KB
assets/modal-component/modalComponent.htmlother3.2 KB
assets/modal-component/modalComponent.jsscript5.5 KB
assets/record-picker/recordPicker.htmlother2.0 KB
assets/record-picker/recordPicker.jsscript5.4 KB
assets/state-store/store.jsscript9.1 KB
assets/typescript-component/typescriptComponent.cssother1.3 KB
assets/typescript-component/typescriptComponent.htmlother4.3 KB
assets/typescript-component/typescriptComponent.js-meta.xmlconfig2.4 KB
assets/typescript-component/typescriptComponent.test.ts.exampleother13.6 KB
assets/typescript-component/typescriptComponent.tsscript11.7 KB
assets/workspace-api/workspaceComponent.htmlother3.4 KB
assets/workspace-api/workspaceComponent.jsscript8.0 KB
references/accessibility-guide.mdmarkdown22.3 KB
references/advanced-features.mdmarkdown2.8 KB
references/async-notification-patterns.mdmarkdown19.7 KB
references/cli-commands.mdmarkdown12.6 KB
references/component-patterns.mdmarkdown44.5 KB
references/flow-integration-guide.mdmarkdown19.0 KB
references/jest-testing.mdmarkdown25.3 KB
references/lms-guide.mdmarkdown21.9 KB
references/lwc-best-practices.mdmarkdown36.3 KB
references/performance-guide.mdmarkdown20.3 KB
references/scoring-and-testing.mdmarkdown3.8 KB
references/slds-blueprints.jsonconfig781.3 KB
references/slds-design-guide.mdmarkdown10.7 KB
references/state-management.mdmarkdown19.9 KB
references/template-anti-patterns.mdmarkdown20.1 KB
references/triangle-pattern.mdmarkdown12.5 KB
scripts/local-dev-preview.shscript1.1 KB
scripts/lwc-lsp-validate.pyscript8.6 KB
scripts/post-tool-validate.pyscript14.7 KB
scripts/slds_data/deprecated_patterns.jsonconfig3.4 KB
scripts/slds_data/styling_hooks.jsonconfig2.9 KB
scripts/slds_data/valid_slds_classes.jsonconfig7.4 KB
scripts/slds_linter_wrapper.pyscript8.9 KB
scripts/slds_rules/__init__.pyscript593 B
scripts/template_validator.pyscript13.5 KB
scripts/validate_slds.pyscript26.5 KB

assets/state-store/store.js

View on GitHub
/**
 * STATE STORE TEMPLATE
 *
 * Singleton store for cross-component state management in LWC.
 * Provides reactive state with subscription-based updates.
 *
 * Features:
 * - Cross-component state sharing
 * - Subscription-based reactivity
 * - Automatic cleanup utilities
 * - Debug mode for development
 *
 * Usage:
 * import store from 'c/store';
 *
 * // In connectedCallback:
 * this.cart = store.initState('cart', { items: [], total: 0 });
 * this._unsubscribe = store.subscribe('cart', (cart) => { this.cart = cart; });
 *
 * // In disconnectedCallback:
 * if (this._unsubscribe) this._unsubscribe();
 *
 * // Update state anywhere:
 * store.setState('cart', { ...store.getState('cart'), items: [...items, newItem] });
 */

// ═══════════════════════════════════════════════════════════════════════════
// CONFIGURATION
// ═══════════════════════════════════════════════════════════════════════════

/**
 * Enable debug mode for state change logging.
 * Set to false in production.
 */
const DEBUG_MODE = false;

// ═══════════════════════════════════════════════════════════════════════════
// PRIVATE STATE
// ═══════════════════════════════════════════════════════════════════════════

/** @type {Map<string, any>} State container */
const state = new Map();

/** @type {Map<string, Array<Function>>} Subscribers by key */
const subscribers = new Map();

/** @type {Map<string, any>} Initial values for reset */
const initialValues = new Map();

// ═══════════════════════════════════════════════════════════════════════════
// CORE API
// ═══════════════════════════════════════════════════════════════════════════

/**
 * Get current state for a key.
 *
 * @param {string} key - State key
 * @returns {any} Current state value, or undefined if not set
 *
 * @example
 * const cart = store.getState('cart');
 */
function getState(key) {
    return state.get(key);
}

/**
 * Set state and notify all subscribers.
 *
 * @param {string} key - State key
 * @param {any} value - New state value
 *
 * @example
 * store.setState('cart', { items: [...cart.items, newItem], total: newTotal });
 */
function setState(key, value) {
    const oldValue = state.get(key);
    state.set(key, value);

    if (DEBUG_MODE) {
        console.log(`[Store] ${key} updated:`, { old: oldValue, new: value });
    }

    // Notify all subscribers for this key
    const keySubscribers = subscribers.get(key) || [];
    keySubscribers.forEach(callback => {
        try {
            callback(value, oldValue);
        } catch (e) {
            console.error(`[Store] Subscriber error for "${key}":`, e);
        }
    });
}

/**
 * Subscribe to state changes for a key.
 *
 * @param {string} key - State key to watch
 * @param {Function} callback - Called with (newValue, oldValue) on change
 * @returns {Function} Unsubscribe function - MUST be called in disconnectedCallback
 *
 * @example
 * // In connectedCallback:
 * this._unsubscribe = store.subscribe('cart', (cart) => {
 *     this.cart = cart;
 * });
 *
 * // In disconnectedCallback:
 * if (this._unsubscribe) this._unsubscribe();
 */
function subscribe(key, callback) {
    if (!subscribers.has(key)) {
        subscribers.set(key, []);
    }
    subscribers.get(key).push(callback);

    if (DEBUG_MODE) {
        console.log(`[Store] Subscribed to "${key}", total: ${subscribers.get(key).length}`);
    }

    // Return unsubscribe function
    return () => {
        const keySubscribers = subscribers.get(key) || [];
        const index = keySubscribers.indexOf(callback);
        if (index > -1) {
            keySubscribers.splice(index, 1);
            if (DEBUG_MODE) {
                console.log(`[Store] Unsubscribed from "${key}", remaining: ${keySubscribers.length}`);
            }
        }
    };
}

/**
 * Initialize state with a default value if not already set.
 *
 * @param {string} key - State key
 * @param {any} defaultValue - Default value if key doesn't exist
 * @returns {any} Current state value (existing or newly set default)
 *
 * @example
 * // Safe initialization - won't overwrite existing state
 * const cart = store.initState('cart', { items: [], total: 0 });
 */
function initState(key, defaultValue) {
    if (!state.has(key)) {
        state.set(key, defaultValue);
        initialValues.set(key, JSON.parse(JSON.stringify(defaultValue)));
    }
    return state.get(key);
}

// ═══════════════════════════════════════════════════════════════════════════
// UTILITY METHODS
// ═══════════════════════════════════════════════════════════════════════════

/**
 * Reset a state key to its initial value.
 *
 * @param {string} key - State key to reset
 *
 * @example
 * store.resetState('cart'); // Resets to initial { items: [], total: 0 }
 */
function resetState(key) {
    if (initialValues.has(key)) {
        const initial = JSON.parse(JSON.stringify(initialValues.get(key)));
        setState(key, initial);
    }
}

/**
 * Clear all state (useful for testing or logout).
 */
function clearAll() {
    state.clear();
    subscribers.clear();
    initialValues.clear();

    if (DEBUG_MODE) {
        console.log('[Store] All state cleared');
    }
}

/**
 * Get all current state keys.
 *
 * @returns {Array<string>} Array of state keys
 */
function getKeys() {
    return Array.from(state.keys());
}

/**
 * Check if a state key exists.
 *
 * @param {string} key - State key
 * @returns {boolean} True if key exists
 */
function hasState(key) {
    return state.has(key);
}

/**
 * Get subscriber count for a key (useful for debugging).
 *
 * @param {string} key - State key
 * @returns {number} Number of active subscribers
 */
function getSubscriberCount(key) {
    return (subscribers.get(key) || []).length;
}

// ═══════════════════════════════════════════════════════════════════════════
// BATCH UPDATES
// ═══════════════════════════════════════════════════════════════════════════

let batchUpdates = [];
let isBatching = false;

/**
 * Batch multiple state updates to reduce re-renders.
 *
 * @param {Function} updateFn - Function containing multiple setState calls
 *
 * @example
 * store.batch(() => {
 *     store.setState('user', newUser);
 *     store.setState('preferences', newPrefs);
 *     store.setState('cart', newCart);
 * }); // Subscribers notified once after all updates
 */
function batch(updateFn) {
    isBatching = true;
    batchUpdates = [];

    try {
        updateFn();
    } finally {
        isBatching = false;

        // Notify subscribers for all changed keys
        const changedKeys = new Set(batchUpdates.map(u => u.key));
        changedKeys.forEach(key => {
            const lastUpdate = batchUpdates.filter(u => u.key === key).pop();
            if (lastUpdate) {
                const keySubscribers = subscribers.get(key) || [];
                keySubscribers.forEach(callback => {
                    try {
                        callback(lastUpdate.value, lastUpdate.oldValue);
                    } catch (e) {
                        console.error(`[Store] Batch subscriber error for "${key}":`, e);
                    }
                });
            }
        });

        batchUpdates = [];
    }
}

// ═══════════════════════════════════════════════════════════════════════════
// EXPORTS
// ═══════════════════════════════════════════════════════════════════════════

export default {
    // Core API
    getState,
    setState,
    subscribe,
    initState,

    // Utilities
    resetState,
    clearAll,
    getKeys,
    hasState,
    getSubscriberCount,

    // Batch operations
    batch
};
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall