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/modal-component/modalComponent.js

View on GitHub
/**
 * Composable Modal Component Template
 *
 * Based on James Simone's composable modal pattern with:
 * - Focus trap implementation
 * - ESC key to close
 * - Backdrop click to close
 * - Slot-based composition
 * - ARIA accessibility attributes
 * - Proper cleanup on disconnect
 *
 * @see https://www.jamessimone.net/blog/joys-of-apex/lwc-composable-modal/
 */
import { LightningElement, api } from 'lwc';

const OUTER_MODAL_CLASS = 'outerModalContent';
const ESCAPE_KEY = 'Escape';
const TAB_KEY = 'Tab';

export default class ModalComponent extends LightningElement {
    // Public API properties
    @api modalHeader;
    @api modalTagline;
    @api modalSaveHandler;
    @api hideFooter = false;
    @api size = 'medium'; // small, medium, large

    // Private state
    _isOpen = false;
    _focusableElements = [];
    _boundHandleKeyUp;

    constructor() {
        super();
        // Bind the handler once to ensure we can remove it later
        this._boundHandleKeyUp = this._handleKeyUp.bind(this);
    }

    /**
     * Public method to toggle modal visibility
     * Called by parent component to open/close the modal
     */
    @api
    toggleModal() {
        this._isOpen = !this._isOpen;

        if (this._isOpen) {
            this._onOpen();
        } else {
            this._onClose();
        }
    }

    /**
     * Public method to explicitly open the modal
     */
    @api
    open() {
        if (!this._isOpen) {
            this._isOpen = true;
            this._onOpen();
        }
    }

    /**
     * Public method to explicitly close the modal
     */
    @api
    close() {
        if (this._isOpen) {
            this._isOpen = false;
            this._onClose();
        }
    }

    // Computed properties for template
    get isOpen() {
        return this._isOpen;
    }

    get modalAriaHidden() {
        return String(!this._isOpen);
    }

    get modalContainerClass() {
        const sizeClass = this.size === 'large' ? 'slds-modal_large' :
                          this.size === 'small' ? 'slds-modal_small' : '';
        return this._isOpen
            ? `slds-modal slds-fade-in-open ${sizeClass}`
            : 'slds-modal slds-hidden';
    }

    get backdropClass() {
        return this._isOpen
            ? 'slds-backdrop slds-backdrop_open'
            : 'slds-backdrop';
    }

    get showHeader() {
        return this.modalHeader || this.modalTagline;
    }

    // Lifecycle hooks
    disconnectedCallback() {
        // Clean up window event listener to prevent memory leaks
        window.removeEventListener('keyup', this._boundHandleKeyUp);
    }

    // Private methods
    _onOpen() {
        // Collect all focusable elements within the modal
        // Elements must have the 'focusable' class
        this._focusableElements = [
            ...this.querySelectorAll('.focusable'),
            ...this.template.querySelectorAll(
                'lightning-button, lightning-button-icon, lightning-input, button, [tabindex="0"]'
            )
        ].filter(el => !el.disabled);

        // Focus the first focusable element
        this._focusFirstElement();

        // Add window-level keyboard listener for ESC and Tab
        window.addEventListener('keyup', this._boundHandleKeyUp);

        // Dispatch open event
        this.dispatchEvent(new CustomEvent('modalopen'));
    }

    _onClose() {
        // Remove keyboard listener
        window.removeEventListener('keyup', this._boundHandleKeyUp);

        // Dispatch close event
        this.dispatchEvent(new CustomEvent('modalclose'));
    }

    _handleKeyUp(event) {
        if (event.code === ESCAPE_KEY || event.key === ESCAPE_KEY) {
            this.close();
        } else if (event.code === TAB_KEY || event.key === TAB_KEY) {
            this._handleTabNavigation(event);
        }
    }

    _handleTabNavigation(event) {
        // Implement focus trap - keep focus within modal
        if (this._focusableElements.length === 0) return;

        const activeElement = this.template.activeElement || document.activeElement;
        const lastIndex = this._focusableElements.length - 1;
        const currentIndex = this._focusableElements.indexOf(activeElement);

        if (event.shiftKey && currentIndex <= 0) {
            // Shift+Tab on first element - wrap to last
            event.preventDefault();
            this._focusableElements[lastIndex]?.focus();
        } else if (!event.shiftKey && currentIndex >= lastIndex) {
            // Tab on last element - wrap to first
            event.preventDefault();
            this._focusFirstElement();
        }
    }

    _focusFirstElement() {
        // Small delay to ensure modal is fully rendered
        // eslint-disable-next-line @lwc/lwc/no-async-operation
        setTimeout(() => {
            if (this._focusableElements.length > 0) {
                this._focusableElements[0].focus();
            }
        }, 0);
    }

    // Event handlers
    handleBackdropClick(event) {
        // Close modal if clicking on the backdrop (outside modal content)
        if (event.target.classList.contains(OUTER_MODAL_CLASS)) {
            this.close();
        }
    }

    handleCancel() {
        this.close();
    }

    handleSave() {
        // If a save handler was provided, call it
        if (typeof this.modalSaveHandler === 'function') {
            this.modalSaveHandler();
        }

        // Dispatch save event for parent components
        this.dispatchEvent(new CustomEvent('modalsave'));

        // Close the modal
        this.close();
    }
}
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