nativecorejs 0.1.0

package/dist/components/nc-div.js

@@ -0,0 +1,270 @@
+/**
+ * NcDiv Component - Responsive Container
+ *
+ * A flexible container component with built-in responsive grid/flex layouts
+ *
+ * Attributes:
+ *   - layout: 'grid' | 'flex' | 'grid-auto' | 'block' (default: 'grid-auto')
+ *   - cols: '1' | '2' | '3' | '4' (for grid layout)
+ *   - direction: 'row' | 'column' (for flex layout)
+ *   - gap: 'sm' | 'md' | 'lg' | 'xl' (default: 'md')
+ *   - width: 'full' | 'three-quarters' | 'half' | 'quarter' (default: 'full')
+ *   - justify: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly' (for flex/grid)
+ *   - align: 'start' | 'center' | 'end' | 'stretch' | 'baseline' (for flex/grid)
+ *
+ * Usage:
+ *   <nc-div layout="grid-auto">
+ *     Card 1</nc-card>
+ *     Card 2</nc-card>
+ *   </nc-div>
+ *
+ *   <nc-div layout="grid" cols="3">
+ *     Card 1</nc-card>
+ *     Card 2</nc-card>
+ *     Card 3</nc-card>
+ *   </nc-div>
+ *
+ *   <nc-div layout="flex" direction="row" gap="lg" justify="center" align="center">
+ *     Flexbox Item 1</nc-card>
+ *     Flexbox Item 2</nc-card>
+ *   </nc-div>
+ */
+import { Component, defineComponent } from '../core/component.js';
+export class NcDiv extends Component {
+    static useShadowDOM = true;
+    // ═══ Define dropdown options for dev tools ═══
+    static attributeOptions = {
+        layout: ['grid-auto', 'grid', 'flex', 'block'],
+        cols: ['1', '2', '3', '4'],
+        direction: ['row', 'column'],
+        gap: ['sm', 'md', 'lg', 'xl'],
+        width: ['full', 'three-quarters', 'half', 'quarter'],
+        justify: ['start', 'center', 'end', 'between', 'around', 'evenly'],
+        align: ['start', 'center', 'end', 'stretch', 'baseline']
+    };
+    // ═══ Conditional visibility for attributes based on layout ═══
+    static attributeConditions = {
+        cols: (element) => {
+            const layout = element.getAttribute('layout') || 'grid-auto';
+            return layout === 'grid';
+        },
+        direction: (element) => {
+            const layout = element.getAttribute('layout') || 'grid-auto';
+            return layout === 'flex';
+        }
+    };
+    // ═══ Attributes become editable in dev tools sidebar ═══
+    static get observedAttributes() {
+        return ['layout', 'cols', 'direction', 'gap', 'width', 'justify', 'align'];
+    }
+    constructor() {
+        super();
+    }
+    template() {
+        return `
+            <style>
+                :host {
+                    display: block;
+                    width: 100%;
+                    box-sizing: border-box;
+                    margin: var(--nc-spacing-lg) 0 !important;
+                }
+                
+                /* Layout: Auto-fit Grid (Recommended) */
+                :host([layout="grid-auto"]) {
+                    display: grid;
+                    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+                }
+                
+                /* Layout: Fixed Grid */
+                :host([layout="grid"]) {
+                    display: grid;
+                }
+                
+                :host([layout="grid"][cols="1"]) {
+                    grid-template-columns: repeat(1, minmax(0, 1fr));
+                }
+                
+                :host([layout="grid"][cols="2"]) {
+                    grid-template-columns: repeat(2, minmax(0, 1fr));
+                }
+                
+                :host([layout="grid"][cols="3"]) {
+                    grid-template-columns: repeat(3, minmax(0, 1fr));
+                }
+                
+                :host([layout="grid"][cols="4"]) {
+                    grid-template-columns: repeat(4, minmax(0, 1fr));
+                }
+                
+                /* Layout: Flexbox */
+                :host([layout="flex"]) {
+                    display: flex;
+                    flex-wrap: wrap;
+                    flex-direction: column; /* Default to column (vertical stack) */
+                }
+                
+                /* Flex Direction */
+                :host([layout="flex"][direction="row"]) {
+                    flex-direction: row;
+                }
+                
+                :host([layout="flex"][direction="column"]) {
+                    flex-direction: column;
+                }
+                
+                /* Row layout: children can grow with 300px basis */
+                :host([layout="flex"][direction="row"]) ::slotted(*) {
+                    flex: 1 1 300px;
+                    min-width: 0;
+                }
+                
+                /* Column layout (default): children size to content */
+                :host([layout="flex"]) ::slotted(*),
+                :host([layout="flex"][direction="column"]) ::slotted(*) {
+                    flex: 0 1 auto;
+                    min-width: 0;
+                }
+                
+                /* Layout: Block */
+                :host([layout="block"]) {
+                    display: block;
+                }
+                
+                /* Gap Sizes */
+                :host([gap="sm"]) {
+                    gap: var(--nc-spacing-sm);
+                }
+                
+                :host([gap="md"]) {
+                    gap: var(--nc-spacing-md);
+                }
+                
+                :host([gap="lg"]) {
+                    gap: var(--nc-spacing-lg);
+                }
+                
+                :host([gap="xl"]) {
+                    gap: var(--nc-spacing-xl);
+                }
+                
+                /* Justify Content - Works for both Flex & Grid */
+                :host([justify="start"]) {
+                    justify-content: flex-start;
+                    justify-items: start;
+                }
+                
+                :host([justify="center"]) {
+                    justify-content: center;
+                    justify-items: center;
+                }
+                
+                :host([justify="end"]) {
+                    justify-content: flex-end;
+                    justify-items: end;
+                }
+                
+                :host([justify="between"]) {
+                    justify-content: space-between;
+                }
+                
+                :host([justify="around"]) {
+                    justify-content: space-around;
+                }
+                
+                :host([justify="evenly"]) {
+                    justify-content: space-evenly;
+                }
+                
+                /* Align Items - Works for both Flex & Grid */
+                :host([align="start"]) {
+                    align-items: flex-start;
+                    align-content: flex-start;
+                }
+                
+                :host([align="center"]) {
+                    align-items: center;
+                    align-content: center;
+                }
+                
+                :host([align="end"]) {
+                    align-items: flex-end;
+                    align-content: flex-end;
+                }
+                
+                :host([align="stretch"]) {
+                    align-items: stretch;
+                    align-content: stretch;
+                }
+                
+                :host([align="baseline"]) {
+                    align-items: baseline;
+                    align-content: baseline;
+                }
+                
+                /* Width Options */
+                :host([width="full"]) {
+                    width: 100%;
+                }
+                
+                :host([width="three-quarters"]) {
+                    width: 75%;
+                    margin-left: auto;
+                    margin-right: auto;
+                }
+                
+                :host([width="half"]) {
+                    width: 50%;
+                    margin-left: auto;
+                    margin-right: auto;
+                }
+                
+                :host([width="quarter"]) {
+                    width: 25%;
+                    margin-left: auto;
+                    margin-right: auto;
+                }
+                
+                /* Responsive: Mobile */
+                @media (max-width: 768px) {
+                    :host([layout="grid"][cols="2"]),
+                    :host([layout="grid"][cols="3"]),
+                    :host([layout="grid"][cols="4"]) {
+                        grid-template-columns: repeat(1, minmax(0, 1fr));
+                    }
+                    
+                    :host([layout="grid-auto"]) {
+                        grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+                    }
+                    
+                    /* Full width on mobile for better UX */
+                    :host([width="three-quarters"]),
+                    :host([width="half"]),
+                    :host([width="quarter"]) {
+                        width: 100% !important;
+                    }
+                }
+                
+                /* Responsive: Tablet */
+                @media (min-width: 769px) and (max-width: 1024px) {
+                    :host([layout="grid"][cols="3"]),
+                    :host([layout="grid"][cols="4"]) {
+                        grid-template-columns: repeat(2, minmax(0, 1fr));
+                    }
+                }
+            </style>
+            
+            <slot></slot>
+        `;
+    }
+    onMount() {
+        // Component logic here
+    }
+    // ═══ Makes changes instant in dev tools preview ═══
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue !== newValue && this._mounted) {
+            this.render();
+        }
+    }
+}
+defineComponent('nc-div', NcDiv);

package/dist/components/nc-divider.d.ts

@@ -0,0 +1,7 @@
+import { Component } from '../core/component.js';
+export declare class NcDivider extends Component {
+    static useShadowDOM: boolean;
+    static get observedAttributes(): string[];
+    template(): string;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+}

package/dist/components/nc-divider.js

@@ -0,0 +1,57 @@
+import { Component, defineComponent } from '../core/component.js';
+export class NcDivider extends Component {
+    static useShadowDOM = true;
+    static get observedAttributes() {
+        return ['orientation', 'variant', 'label', 'thickness', 'color', 'spacing'];
+    }
+    template() {
+        const orientation = this.getAttribute('orientation') || 'horizontal';
+        const variant = this.getAttribute('variant') || 'solid';
+        const label = this.getAttribute('label') || '';
+        const thickness = this.getAttribute('thickness') || '1px';
+        const color = this.getAttribute('color') || 'var(--nc-border, #e5e7eb)';
+        const spacing = this.getAttribute('spacing') || (orientation === 'horizontal' ? 'var(--nc-spacing-md, 1rem) 0' : '0 var(--nc-spacing-md, 1rem)');
+        const isHorizontal = orientation === 'horizontal';
+        return `
+            <style>
+                :host {
+                    display: ${isHorizontal ? 'block' : 'inline-flex'};
+                    align-self: ${isHorizontal ? 'auto' : 'stretch'};
+                }
+
+                .divider {
+                    display: flex;
+                    align-items: center;
+                    margin: ${spacing};
+                    ${isHorizontal ? 'width: 100%;' : 'flex-direction: column; height: 100%;'}
+                    font-family: var(--nc-font-family);
+                }
+
+                .line {
+                    ${isHorizontal ? 'flex: 1; height: 0;' : 'flex: 1; width: 0;'}
+                    border: none;
+                    border-${isHorizontal ? 'top' : 'left'}: ${thickness} ${variant} ${color};
+                }
+
+                .label {
+                    padding: ${isHorizontal ? '0 var(--nc-spacing-sm, 0.5rem)' : 'var(--nc-spacing-sm, 0.5rem) 0'};
+                    font-size: var(--nc-font-size-xs, 0.75rem);
+                    color: var(--nc-text-muted, #6b7280);
+                    white-space: nowrap;
+                    font-weight: var(--nc-font-weight-medium, 500);
+                    text-transform: uppercase;
+                    letter-spacing: 0.05em;
+                }
+            </style>
+            <div class="divider" role="separator" aria-orientation="${orientation}">
+                <span class="line"></span>
+                ${label ? `<span class="label">${label}</span><span class="line"></span>` : ''}
+            </div>
+        `;
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue !== newValue && this._mounted)
+            this.render();
+    }
+}
+defineComponent('nc-divider', NcDivider);

package/dist/components/nc-drawer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * NcDrawer Component
+ *
+ * Attributes:
+ *   - open: boolean - visible state
+ *   - placement: 'left'|'right'|'top'|'bottom' (default: 'right')
+ *   - size: string - CSS width/height of the panel (default: '320px')
+ *   - overlay: boolean - show backdrop overlay (default: true)
+ *   - close-on-overlay: boolean - click overlay to close (default: true)
+ *   - no-close-btn: boolean - hide the built-in close button
+ *
+ * Slots:
+ *   - header - drawer header area
+ *   - (default) - drawer body content
+ *   - footer - drawer footer area
+ *
+ * Events:
+ *   - open:  CustomEvent - after drawer opens
+ *   - close: CustomEvent - after drawer closes
+ *
+ * Usage:
+ *   <nc-drawer id="nav-drawer" placement="left">
+ *     <span slot="header">Navigation</span>
+ *     <p>Links go here</p>
+ *   </nc-drawer>
+ *
+ *   document.getElementById('nav-drawer').setAttribute('open', '');
+ */
+import { Component } from '../core/component.js';
+export declare class NcDrawer extends Component {
+    static useShadowDOM: boolean;
+    static get observedAttributes(): string[];
+    template(): string;
+    onMount(): void;
+    private _bindEvents;
+    private _onKeydown;
+    private _close;
+    onUnmount(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+}

package/dist/components/nc-drawer.js

@@ -0,0 +1,217 @@
+/**
+ * NcDrawer Component
+ *
+ * Attributes:
+ *   - open: boolean - visible state
+ *   - placement: 'left'|'right'|'top'|'bottom' (default: 'right')
+ *   - size: string - CSS width/height of the panel (default: '320px')
+ *   - overlay: boolean - show backdrop overlay (default: true)
+ *   - close-on-overlay: boolean - click overlay to close (default: true)
+ *   - no-close-btn: boolean - hide the built-in close button
+ *
+ * Slots:
+ *   - header - drawer header area
+ *   - (default) - drawer body content
+ *   - footer - drawer footer area
+ *
+ * Events:
+ *   - open:  CustomEvent - after drawer opens
+ *   - close: CustomEvent - after drawer closes
+ *
+ * Usage:
+ *   <nc-drawer id="nav-drawer" placement="left">
+ *     <span slot="header">Navigation</span>
+ *     <p>Links go here</p>
+ *   </nc-drawer>
+ *
+ *   document.getElementById('nav-drawer').setAttribute('open', '');
+ */
+import { Component, defineComponent } from '../core/component.js';
+export class NcDrawer extends Component {
+    static useShadowDOM = true;
+    static get observedAttributes() {
+        return ['open', 'placement', 'size', 'overlay', 'close-on-overlay', 'no-close-btn'];
+    }
+    template() {
+        const open = this.hasAttribute('open');
+        const placement = this.getAttribute('placement') || 'right';
+        const size = this.getAttribute('size') || '320px';
+        const showOverlay = !this.hasAttribute('overlay') || this.getAttribute('overlay') !== 'false';
+        const noCloseBtn = this.hasAttribute('no-close-btn');
+        const isHorizontal = placement === 'left' || placement === 'right';
+        const panelSize = isHorizontal
+            ? `width: ${size}; height: 100%;`
+            : `height: ${size}; width: 100%;`;
+        const translateClosed = {
+            left: 'translateX(-100%)',
+            right: 'translateX(100%)',
+            top: 'translateY(-100%)',
+            bottom: 'translateY(100%)',
+        }[placement];
+        return `
+            <style>
+                :host { display: contents; }
+
+                .overlay {
+                    position: fixed;
+                    inset: 0;
+                    background: rgba(0,0,0,.45);
+                    z-index: 900;
+                    opacity: ${open ? '1' : '0'};
+                    pointer-events: ${open && showOverlay ? 'auto' : 'none'};
+                    transition: opacity var(--nc-transition-base);
+                    display: ${showOverlay ? 'block' : 'none'};
+                }
+
+                .panel {
+                    position: fixed;
+                    ${placement}: 0;
+                    ${placement === 'left' || placement === 'right' ? 'top: 0;' : 'left: 0;'}
+                    ${panelSize}
+                    background: var(--nc-bg);
+                    box-shadow: var(--nc-shadow-xl, 0 20px 60px rgba(0,0,0,.3));
+                    z-index: 901;
+                    display: flex;
+                    flex-direction: column;
+                    transform: ${open ? 'none' : translateClosed};
+                    transition: transform var(--nc-transition-base);
+                    overflow: hidden;
+                }
+
+                .panel__header {
+                    display: flex;
+                    align-items: center;
+                    justify-content: space-between;
+                    padding: var(--nc-spacing-md) var(--nc-spacing-lg);
+                    border-bottom: 1px solid var(--nc-border);
+                    font-family: var(--nc-font-family);
+                    font-weight: var(--nc-font-weight-semibold);
+                    font-size: var(--nc-font-size-lg);
+                    color: var(--nc-text);
+                    flex-shrink: 0;
+                }
+
+                .panel__body {
+                    flex: 1;
+                    overflow-y: auto;
+                    padding: var(--nc-spacing-lg);
+                }
+
+                .panel__footer {
+                    padding: var(--nc-spacing-md) var(--nc-spacing-lg);
+                    border-top: 1px solid var(--nc-border);
+                    flex-shrink: 0;
+                }
+
+                .panel__footer:empty { display: none; }
+
+                .close-btn {
+                    background: none;
+                    border: none;
+                    cursor: pointer;
+                    padding: 4px;
+                    color: var(--nc-text-muted);
+                    border-radius: var(--nc-radius-sm, 4px);
+                    display: flex;
+                    transition: color var(--nc-transition-fast), background var(--nc-transition-fast);
+                }
+                .close-btn:hover { color: var(--nc-text); background: var(--nc-bg-secondary); }
+            </style>
+
+            ${showOverlay ? `<div class="overlay" aria-hidden="true"></div>` : ''}
+
+            <div
+                class="panel"
+                role="dialog"
+                aria-modal="true"
+                aria-hidden="${!open}"
+                tabindex="-1"
+            >
+                <div class="panel__header">
+                    <slot name="header"></slot>
+                    ${!noCloseBtn ? `
+                    <button class="close-btn" type="button" aria-label="Close drawer">
+                        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="none" width="18" height="18">
+                            <path d="M3 3l10 10M13 3L3 13" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/>
+                        </svg>
+                    </button>` : ''}
+                </div>
+                <div class="panel__body">
+                    <slot></slot>
+                </div>
+                <div class="panel__footer">
+                    <slot name="footer"></slot>
+                </div>
+            </div>
+        `;
+    }
+    onMount() {
+        this._bindEvents();
+    }
+    _bindEvents() {
+        const closeBtn = this.$('.close-btn');
+        if (closeBtn) {
+            closeBtn.addEventListener('click', () => this._close());
+        }
+        const overlay = this.$('.overlay');
+        if (overlay) {
+            overlay.addEventListener('click', () => {
+                if (!this.hasAttribute('close-on-overlay') || this.getAttribute('close-on-overlay') !== 'false') {
+                    this._close();
+                }
+            });
+        }
+        // Close on Escape
+        this._onKeydown = (e) => {
+            if (e.key === 'Escape' && this.hasAttribute('open'))
+                this._close();
+        };
+        document.addEventListener('keydown', this._onKeydown);
+    }
+    _onKeydown = null;
+    _close() {
+        this.removeAttribute('open');
+        this.dispatchEvent(new CustomEvent('close', { bubbles: true, composed: true }));
+    }
+    onUnmount() {
+        if (this._onKeydown)
+            document.removeEventListener('keydown', this._onKeydown);
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue === newValue)
+            return;
+        if (name === 'open' && this._mounted) {
+            const open = this.hasAttribute('open');
+            const panel = this.$('.panel');
+            const overlay = this.$('.overlay');
+            const placement = this.getAttribute('placement') || 'right';
+            const translateClosed = {
+                left: 'translateX(-100%)',
+                right: 'translateX(100%)',
+                top: 'translateY(-100%)',
+                bottom: 'translateY(100%)',
+            }[placement];
+            if (panel) {
+                panel.style.transform = open ? 'none' : (translateClosed ?? 'translateX(100%)');
+                panel.setAttribute('aria-hidden', String(!open));
+                if (open)
+                    panel.focus();
+            }
+            if (overlay) {
+                overlay.style.opacity = open ? '1' : '0';
+                overlay.style.pointerEvents = open ? 'auto' : 'none';
+            }
+            // Lock body scroll while open
+            document.body.style.overflow = open ? 'hidden' : '';
+            this.dispatchEvent(new CustomEvent(open ? 'open' : 'close', {
+                bubbles: true, composed: true
+            }));
+            return;
+        }
+        if (this._mounted) {
+            this.render();
+            this._bindEvents();
+        }
+    }
+}
+defineComponent('nc-drawer', NcDrawer);

package/dist/components/nc-dropdown.d.ts

@@ -0,0 +1,41 @@
+/**
+ * NcDropdown Component
+ *
+ * A generic trigger + floating-panel component. The trigger is whatever
+ * is in slot[name="trigger"]; the content panel is the default slot.
+ *
+ * Attributes:
+ *   - open: boolean - visible state
+ *   - placement: 'bottom-start'|'bottom-end'|'bottom'|'top-start'|'top-end'|'top' (default: 'bottom-start')
+ *   - close-on-select: boolean - close when a [data-value] child is clicked (default: true)
+ *   - disabled: boolean
+ *   - offset: number - gap in px between trigger and panel (default: 6)
+ *   - width: string - CSS width of panel (default: 'auto'; use 'trigger' to match trigger width)
+ *
+ * Events:
+ *   - open:   CustomEvent
+ *   - close:  CustomEvent
+ *   - select: CustomEvent<{ value: string; label: string }> - when a [data-value] child is clicked
+ *
+ * Usage:
+ *   <nc-dropdown>
+ *     <nc-button slot="trigger">Options</nc-button>
+ *     <nc-menu>
+ *       <nc-menu-item data-value="edit">Edit</nc-menu-item>
+ *       <nc-menu-item data-value="delete">Delete</nc-menu-item>
+ *     </nc-menu>
+ *   </nc-dropdown>
+ */
+import { Component } from '../core/component.js';
+export declare class NcDropdown extends Component {
+    static useShadowDOM: boolean;
+    static get observedAttributes(): string[];
+    private _outsideClick;
+    template(): string;
+    onMount(): void;
+    private _bindEvents;
+    private _hookTrigger;
+    private _setOpen;
+    onUnmount(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+}