@kubuild/components 0.0.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kustora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @kubuild/components
+
+[![npm version](https://img.shields.io/npm/v/@kubuild/components.svg)](https://www.npmjs.com/package/@kubuild/components)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+
+Component registry, schema definitions, traits, prop types, and starter form/layout block templates for **KUBUILD**.
+
+---
+
+## 📦 Installation
+
+```bash
+# Using pnpm (recommended)
+pnpm add @kubuild/components @kubuild/core @kubuild/schema
+
+# Using npm
+npm install @kubuild/components @kubuild/core @kubuild/schema
+
+# Using yarn
+yarn add @kubuild/components @kubuild/core @kubuild/schema
+```
+
+---
+
+## ✨ Features
+
+- **Component Registry**: Unified registry (`componentRegistry`) of built-in components:
+  - Layout: `container`, `section`, `grid`, `flex`
+  - Typography: `heading`, `text`, `paragraph`, `link`
+  - Media: `image`, `video`, `icon`
+  - Interactive & Forms: `form`, `input`, `textarea`, `select`, `checkbox`, `radio`, `button`, `button-submit`
+  - Data & Modals: `table`, `table-row`, `table-cell`, `modal`
+- **Component Traits**: Declarative configuration for traits (properties, labels, input types, default values, validation rules).
+- **Starter Block Templates**: Production-ready blocks in `STARTER_BLOCKS`:
+  - **Contact Us Form**: Form block with validation, inputs (Name, Email, Message), and submit action.
+  - **Newsletter Subscription**: Inline form with email input and submit handler.
+  - **Lead Generation**: Multi-field lead capture form.
+  - **Hero & Content Sections**: Responsive hero banners and feature grids.
+- **Structural Integrity Rules**: Enforces parent-child constraints (e.g. table cells must be inside table rows, form inputs must be inside form nodes, submit buttons cannot be nested inside another button).
+
+---
+
+## 🚀 Quick Usage
+
+### Accessing the Component Registry
+
+```typescript
+import { componentRegistry } from '@kubuild/components';
+
+// Retrieve definition for a specific component
+const buttonDef = componentRegistry.get('button');
+
+console.log('Button default props:', buttonDef?.defaultProps);
+console.log('Button traits:', buttonDef?.traits);
+
+// Check all registered components
+const allComponents = componentRegistry.getAll();
+```
+
+### Using Starter Form Templates
+
+```typescript
+import { STARTER_BLOCKS } from '@kubuild/components';
+
+// Find the Contact Us starter block
+const contactFormBlock = STARTER_BLOCKS.find(b => b.id === 'contact-us-form');
+
+if (contactFormBlock) {
+  console.log('Template name:', contactFormBlock.name);
+  console.log('Preconfigured node tree:', contactFormBlock.node);
+}
+```
+
+### Registering Custom Components
+
+```typescript
+import { componentRegistry, type ComponentDefinition } from '@kubuild/components';
+
+const customCardDef: ComponentDefinition = {
+  type: 'custom-card',
+  name: 'Custom Card',
+  category: 'Custom',
+  icon: 'credit-card',
+  defaultProps: {
+    title: 'Card Title',
+    body: 'Card description content.'
+  },
+  traits: [
+    {
+      name: 'title',
+      label: 'Title',
+      type: 'text'
+    },
+    {
+      name: 'body',
+      label: 'Body Text',
+      type: 'textarea'
+    }
+  ]
+};
+
+componentRegistry.register(customCardDef);
+```
+
+---
+
+## 📄 License
+
+MIT © [KUBUILD](https://github.com/kustora/kubuild)

package/dist/blocks.d.ts

@@ -0,0 +1,16 @@
+import { Node } from '@kubuild/schema';
+export interface BlockDefinition {
+    id: string;
+    name: string;
+    category: 'layout' | 'sections' | 'ui' | 'pricing' | 'cta' | 'forms' | string;
+    categoryLabel?: string;
+    description?: string;
+    icon?: string;
+    thumbnailSvg?: string;
+    createNodeTree: (generateId?: (prefix?: string) => string) => Node;
+}
+/**
+ * Predefined Starter Layout Blocks (STORA-241) and Pre-composed UI Blocks (STORA-242).
+ */
+export declare const STARTER_BLOCKS: BlockDefinition[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,IAAI,CAAC;CACpE;AAOD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAAe,EA+uC3C,CAAC"}

package/dist/definitions.d.ts

@@ -26,7 +26,12 @@ export declare const inputDefinition: ComponentDefinition;
 export declare const textareaDefinition: ComponentDefinition;
 export declare const selectDefinition: ComponentDefinition;
 export declare const checkboxDefinition: ComponentDefinition;
+export declare const switchDefinition: ComponentDefinition;
+export declare const radioGroupDefinition: ComponentDefinition;
 export declare const radioDefinition: ComponentDefinition;
+export declare const radioItemDefinition: ComponentDefinition;
+export declare const fileUploadDefinition: ComponentDefinition;
+export declare const buttonSubmitDefinition: ComponentDefinition;
 export declare const coreComponentDefinitions: ComponentDefinition[];
 export declare function createDefaultComponentRegistry(): ComponentRegistry;
 //# sourceMappingURL=definitions.d.ts.map

package/dist/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqEpE,eAAO,MAAM,cAAc,EAAE,mBAc5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBA8B/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBA0BjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBA0B/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBAwC/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBA4B5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAgD7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBAsF9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAkBlC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmE5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAqDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBA0CjC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmE5B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBA8DlC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBA6D7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAqDjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAoG7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmD5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAkCjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAyD7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAmBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAiFjC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBA4G5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAuG7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBA6EhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBAgF9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAiEhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAiE7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,EA6BzD,CAAC;AAEF,wBAAgB,8BAA8B,IAAI,iBAAiB,CAMlE"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAmGpE,eAAO,MAAM,cAAc,EAAE,mBAc5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBA8B/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBA0BjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBA0B/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBAwC/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBA4B5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAgD7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBAsF9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAkBlC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmE5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAqDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBA0CjC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmE5B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBA8DlC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBA6D7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAqDjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAoG7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBAmD5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAkCjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAyD7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAmBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAiFjC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,mBA8H5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBA+I7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAqHhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBAuF9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBA8EhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,mBA2F9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAgFlC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAwE7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAIjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAoFlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,mBA8GpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,EAkCzD,CAAC;AAEF,wBAAgB,8BAA8B,IAAI,iBAAiB,CAMlE"}