feat: json optimized schemas (#9)

* feat: json optimized schemas

* docs: review update

* docs: review update, architecture breakdown

* docs: review update

Author: cdcabrera

README.md

@@ -43,9 +43,10 @@ This package is specifically designed for AI-assisted development tools and Mode
 - **Assist with component selection** based on requirements
 
 ### MCP Server Integration
+#### Individual Component Imports (Tree-Shakeable)
 ```javascript
 // MCP servers can load and query component schemas
-import { componentNames, getComponentSchema } from 'patternfly-component-schemas';
+import { componentNames, getComponentSchema } from '@patternfly/patternfly-component-schemas';
 
 // Discover available components
 const components = componentNames; // 462 PatternFly components
@@ -55,12 +56,63 @@ const buttonSchema = await getComponentSchema('Button');
 // Returns: { schema, componentName, propsCount, requiredProps }
 ```
 
+#### JSON-Optimized Integration
+```javascript
+// JSON-optimized interface with lazy loading:
+// - Single import of lightweight metadata for fast discovery of all components
+// - Bulk schema access lazy loaded on first query
+// - Fast subsequent queries after initial load
+
+import { componentNames, getComponentSchema } from '@patternfly/patternfly-component-schemas/json';
+
+// Discover all available components (no full schemas loaded yet)
+const components = componentNames; // 462 PatternFly components
+
+// Get detailed component information (lazy loads full schemas on first call)
+const buttonSchema = await getComponentSchema('Button');
+// Returns JSON Schema with properties, required props, etc.
+```
+
 ### AI Assistant Examples
 - **"What props does the Button component accept?"** → AI reads Button schema
 - **"Generate a PatternFly Alert component"** → AI uses Alert schema for validation
 - **"Show me all navigation components"** → AI filters components by name/description
 - **"Create a form with proper PatternFly components"** → AI selects appropriate form components
 
+## 📦 Package Architecture
+
+### Two Interfaces for Different Needs
+
+This package provides two interfaces optimized for different use cases:
+
+#### 🌳 Individual Component Imports (Tree-Shakeable)
+**Import**: `@patternfly/patternfly-component-schemas`
+
+**Characteristics**:
+- Optimized for selective access
+- Each component loads individually
+- Tree-shakeable (only import what you need)
+
+#### 🚀 JSON-Optimized Interface
+**Import**: `@patternfly/patternfly-component-schemas/json`
+
+**Characteristics**:
+- Optimized for bulk access patterns
+- Lightweight metadata for fast discovery
+- Lazy-loaded (full schemas on demand)
+
+### Quick Decision Guide
+
+**Use Tree-Shakeable if you**:
+- Need minimal application bundle size
+- Know which components you'll use at build time
+- Want per-component imports
+
+**Use JSON-Optimized if you**:
+- Need all component metadata quickly
+- Are building tools that need runtime discovery
+- Want fast discovery and bulk operations
+
 ## 🔧 Development
 
 ### Building from Source

index.json.js

@@ -0,0 +1,76 @@
+// PatternFly Component Schemas - JSON Optimized
+// Generated on: 2025-10-14T12:27:01.682Z
+
+// Load metadata
+const { default: index } = await import('./schemas/index.json', { with: { type: 'json' } });
+
+// Cache for loaded schemas
+let schemas = null;
+
+// Export lightweight data
+export { index };
+export const componentNames = Object.keys(index.components);
+export const componentCount = index.totalComponents;
+export const schemaVersion = index.version;
+
+// Get all schemas on-demand
+export async function getAllSchemas() {
+  if (!schemas) {
+    const { default: loadedSchemas } = await import('./schemas/schemas.json', { with: { type: 'json' } });
+    schemas = loadedSchemas;
+  }
+  return schemas;
+}
+
+// Lazy-loaded schema access
+export async function getComponentSchema(name) {
+  if (!index.components[name]) {
+    throw new Error(`Component '${name}' not found`);
+  }
+
+  const schemas = await getAllSchemas();
+  return schemas[name];
+}
+
+// Fast operations using in-memory metadata
+export function getComponentNames(filter = 'all') {
+  const allComponents = Object.keys(index.components);
+
+  switch (filter) {
+    case 'complex':
+      return allComponents.filter(name => index.components[name].isComplex);
+    case 'withRequiredProps':
+      return allComponents.filter(name => index.components[name].hasRequiredProps);
+    default:
+      return allComponents;
+  }
+}
+
+export function searchComponents(query) {
+  const lowerQuery = query.toLowerCase();
+  return Object.values(index.components).filter(c =>
+    c.name.toLowerCase().includes(lowerQuery) ||
+    c.description.toLowerCase().includes(lowerQuery)
+  );
+}
+
+export function getComponentsWithRequiredProps() {
+  return Object.values(index.components).filter(c => c.hasRequiredProps);
+}
+
+export function getComplexComponents() {
+  return Object.values(index.components).filter(c => c.isComplex);
+}
+
+export function getComponentStats() {
+  return {
+    totalComponents: index.totalComponents,
+    totalProps: index.totalProps,
+    averagePropsPerComponent: index.averagePropsPerComponent,
+    componentsWithRequiredProps: index.componentsWithRequiredProps,
+    complexComponents: index.complexComponents
+  };
+}
+
+// Default export
+export default index;

package.json

@@ -5,9 +5,11 @@
   "main": "index.js",
   "type": "module",
   "scripts": {
-    "build": "node scripts/generate-schemas.js component-metadata.json",
+    "build": "npm run build:components && npm run build:json",
+    "build:components": "node scripts/generate-schemas.js component-metadata.json",
+    "build:json": "node scripts/generate-json-schemas.js component-metadata.json",
     "dev": "node scripts/generate-schemas.js --watch",
-    "clean": "rm -rf components/*/",
+    "clean": "rm -rf components/*/ schemas/ index.json.js",
     "rebuild": "npm run clean && npm run build",
     "semantic-release": "semantic-release"
   },
@@ -26,12 +28,16 @@
   },
   "files": [
     "components/",
+    "schemas/",
     "index.js",
+    "index.json.js",
     "README.md"
   ],
   "exports": {
     ".": "./index.js",
-    "./components/*": "./components/*/index.js"
+    "./components/*": "./components/*/index.js",
+    "./json": "./index.json.js",
+    "./schemas": "./schemas/index.json"
   },
   "repository": {
     "type": "git",