@gnggln/ng-ui-system 1.0.0-alpha.0

package/lib/core/types/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared types for ng-ui-system components.
+ * These types are used across multiple components to ensure consistency.
+ */
+/** Standard size variants used across components. */
+export type UiSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Visual style variants for components. */
+export type UiVariant = 'primary' | 'accent' | 'warn' | 'neutral' | 'ghost' | 'outline';
+/** Semantic color palette tokens. */
+export type UiColor = 'primary' | 'accent' | 'warn' | 'success' | 'info' | 'neutral';
+/** Layout direction. */
+export type UiDirection = 'horizontal' | 'vertical';
+/** Horizontal alignment. */
+export type UiAlign = 'start' | 'center' | 'end' | 'stretch';
+/** Component density options for compact or spacious layouts. */
+export type UiDensity = 'compact' | 'default' | 'comfortable';
+/**
+ * Common Lucide icon names with autocomplete support.
+ * Accepts any valid Lucide icon name as a string.
+ *
+ * Provides IntelliSense for the most frequently used enterprise icons.
+ * For the full icon catalogue, visit https://lucide.dev/icons
+ *
+ * @example
+ * ```typescript
+ * const myIcon: UiIconName = 'arrow-right';  // autocomplete ✓
+ * const custom: UiIconName = 'my-custom-icon'; // still valid
+ * ```
+ */
+export type UiIconName = 'arrow-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'chevron-right' | 'chevron-left' | 'chevron-up' | 'chevron-down' | 'external-link' | 'corner-down-left' | 'corner-down-right' | 'check' | 'x' | 'plus' | 'minus' | 'search' | 'refresh-cw' | 'download' | 'upload' | 'save' | 'trash-2' | 'pencil' | 'copy' | 'clipboard' | 'share-2' | 'send' | 'log-in' | 'log-out' | 'mail' | 'message-circle' | 'phone' | 'bell' | 'user' | 'users' | 'lock' | 'unlock' | 'key' | 'shield' | 'file' | 'file-text' | 'file-spreadsheet' | 'file-archive' | 'folder' | 'image' | 'camera' | 'paperclip' | 'info' | 'alert-triangle' | 'alert-circle' | 'check-circle' | 'x-circle' | 'help-circle' | 'loader-2' | 'menu' | 'more-horizontal' | 'more-vertical' | 'grid' | 'list' | 'filter' | 'sliders' | 'columns' | 'maximize-2' | 'minimize-2' | 'home' | 'settings' | 'star' | 'heart' | 'bookmark' | 'calendar' | 'clock' | 'map-pin' | 'eye' | 'eye-off' | 'sun' | 'moon' | 'monitor' | (string & Record<never, never>);
+/** Status values used for feedback components (badges, alerts, indicators). */
+export type UiStatus = 'idle' | 'loading' | 'success' | 'error' | 'warning' | 'info';
+/**
+ * Generic key-value pair used in select options, dropdowns, etc.
+ * @template T - The type of the value.
+ */
+export interface UiOption<T = string> {
+    /** The display label. */
+    label: string;
+    /** The underlying value. */
+    value: T;
+    /** Whether this option is disabled. */
+    disabled?: boolean;
+    /** Optional icon name (Lucide icon). */
+    icon?: UiIconName;
+    /** Optional grouping key for grouped selects. */
+    group?: string;
+}
+/**
+ * Result wrapper for async operations.
+ * @template T - The type of the data payload.
+ */
+export interface UiAsyncState<T = unknown> {
+    status: UiStatus;
+    data: T | null;
+    error: string | null;
+}

package/lib/core/utils/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared utility functions for ng-ui-system components.
+ */
+/**
+ * Generates a unique ID with an optional prefix.
+ * Uses crypto.randomUUID() when available for better randomness, falls back to crypto.getRandomValues().
+ * Useful for linking labels to form controls, ARIA attributes, etc.
+ *
+ * @param prefix - Optional prefix for the generated ID.
+ * @returns A unique string ID.
+ */
+export declare function uiUniqueId(prefix?: string): string;
+/**
+ * Coerces a value to a boolean.
+ * Useful for handling string boolean attributes in templates.
+ *
+ * @param value - The value to coerce.
+ * @returns The boolean representation.
+ */
+export declare function uiCoerceBoolean(value: unknown): boolean;
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param value - The value to clamp.
+ * @param min - The minimum allowed value.
+ * @param max - The maximum allowed value.
+ * @returns The clamped value.
+ */
+export declare function uiClamp(value: number, min: number, max: number): number;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@gnggln/ng-ui-system",
+  "version": "1.0.0-alpha.0",
+  "description": "Enterprise-grade Angular standalone component library with design tokens, a11y, and full TypeScript support.",
+  "keywords": [
+    "angular",
+    "components",
+    "ui",
+    "library",
+    "standalone",
+    "material",
+    "enterprise",
+    "design-tokens",
+    "a11y"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/animations": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/cdk": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/common": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/forms": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/material": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "lucide-angular": ">=0.300.0",
+    "date-fns": ">=3.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.6.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/gnggln-ng-ui-system.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/gnggln-ng-ui-system.mjs",
+      "esm": "./esm2022/gnggln-ng-ui-system.mjs",
+      "default": "./fesm2022/gnggln-ng-ui-system.mjs"
+    }
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ng-ui-system - Public API Surface
+ *
+ * Main entry point that re-exports all secondary entry points.
+ * For optimal tree-shaking, prefer importing from specific entry points:
+ *   import { UiButtonComponent } from 'ng-ui-system/button';
+ *
+ * For convenience, you can also import from the main entry point:
+ *   import { UiButtonComponent } from 'ng-ui-system';
+ */
+export * from './lib/core/types/index';
+export * from './lib/core/utils/index';
+export * from './lib/components/button/index';
+export * from './lib/components/accordion/index';
+export * from './lib/components/modal/index';
+export * from './lib/components/table/index';
+export * from './lib/components/crud-table/index';
+export * from './lib/components/form-builder/index';
+export * from './lib/components/page-header/index';
+export * from './lib/components/base-layout/index';
+export * from './lib/components/form-builder-editor/index';
+export * from './lib/components/layout-builder/index';