@llmnative/react 0.1.0

package/dist/types/src/providers/storage/StorageProviderContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { StorageProviderAdapter } from './StorageProvider';
+type StorageProviderContextValue = {
+    registry: Record<string, StorageProviderAdapter>;
+    defaultKey: string;
+};
+declare const StorageProviderContext: React.Context<StorageProviderContextValue | null>;
+export declare const StorageProvider: ({ registry, defaultKey, children, }: StorageProviderContextValue & {
+    children: React.ReactNode;
+}) => React.JSX.Element;
+export declare const useStorageProvider: (name?: string) => StorageProviderAdapter | null;
+export default StorageProviderContext;

package/dist/types/src/providers/storage/dropbox.d.ts

@@ -0,0 +1,48 @@
+import React from "react";
+import type { IButton } from "../../components/ui/Buttons";
+interface ListFoldersParams {
+    path?: string;
+    recursive?: boolean;
+}
+type PathEntry = {
+    from: string;
+    to: string;
+};
+type ThumbnailEntry = {
+    path: string;
+    [key: string]: any;
+};
+type ThumbnailRequestOptions = {
+    thumbnailsRequest: ThumbnailEntry[];
+    size?: 'w32h32' | 'w64h64' | 'w128h128' | 'w256h256' | 'w480h320' | 'w640h480' | 'w960h640' | 'w1024h768' | 'w2048h1536';
+    format?: 'jpg' | 'jpeg' | 'png' | 'tiff' | 'tif' | 'gif' | 'webp' | 'ppm' | 'bmp';
+    mode?: 'strict' | 'bestfit' | 'fitone_bestfit' | 'original';
+};
+type ThumbnailResult = {
+    [path: string]: {
+        path: string;
+        thumbnail: string;
+        mimetype: string;
+        width: number;
+        height: number;
+        [key: string]: any;
+    };
+};
+export declare const resolvePath: (path: string, includeHost?: boolean) => string;
+export declare const listFolders: ({ path, recursive }?: ListFoldersParams) => Promise<any[]>;
+export declare const useDropBoxConnect: (renew?: boolean) => boolean;
+export declare const DropBoxConnectButton: (options?: IButton) => React.ReactElement;
+export declare const dropBox: {
+    setRootPath: (path: string) => void;
+    resolvePath: (path: string, includeHost?: boolean) => string;
+    createFolders: (paths: string[], basePath?: string) => Promise<any>;
+    deleteBulk: (paths: string[], basePath?: string) => Promise<any>;
+    addTags: (paths: Record<string, string[]>, basePath?: string) => Promise<void>;
+    listFolders: ({ path, recursive }?: ListFoldersParams) => Promise<any[]>;
+    getThumbnails: ({ thumbnailsRequest, size, format, mode, }: ThumbnailRequestOptions, setThumbnails?: (thumbs: ThumbnailResult) => void) => Promise<ThumbnailResult>;
+    search: (jobPath: string, startPath?: string, removeExtension?: boolean) => Promise<Record<string, string>>;
+    upload: (path: string, fileBase64: string) => Promise<void>;
+    copy: (paths: PathEntry[]) => Promise<any[]>;
+    move: (paths: PathEntry[]) => Promise<void>;
+};
+export {};

package/dist/types/src/providers/storage/firebase.d.ts

@@ -0,0 +1,13 @@
+import "firebase/compat/storage";
+import { StorageProviderAdapter } from "./StorageProvider";
+import type { ProviderConfigurationState } from "../ProviderConfiguration";
+export declare class FirebaseStorageProvider implements StorageProviderAdapter {
+    getConfigurationState(): ProviderConfigurationState;
+    isConfigured(): boolean;
+    upload: (file: string, path: string) => Promise<string | undefined>;
+    getURL: (path: string) => Promise<string | undefined>;
+    download: (path: string) => Promise<Blob | undefined>;
+    delete: (path: string) => Promise<boolean>;
+}
+declare const _default: FirebaseStorageProvider;
+export default _default;

package/dist/types/src/providers/storage/supabase.d.ts

@@ -0,0 +1,19 @@
+import { StorageProviderAdapter } from "./StorageProvider";
+import { type ProviderConfigurationState } from "../ProviderConfiguration";
+interface SupabaseStorageConfig {
+    url: string;
+    anonKey: string;
+    bucket?: string;
+}
+export declare class SupabaseStorageProvider implements StorageProviderAdapter {
+    private config;
+    constructor(config: SupabaseStorageConfig);
+    getConfigurationState(): ProviderConfigurationState;
+    isConfigured(): boolean;
+    private get bucket();
+    upload: (file: string, path: string) => Promise<string | undefined>;
+    getURL: (path: string) => Promise<string | undefined>;
+    download: (path: string) => Promise<Blob | undefined>;
+    delete: (path: string) => Promise<boolean>;
+}
+export {};

package/dist/types/src/types/Block.d.ts

@@ -0,0 +1,4 @@
+export interface ComponentBlockMap {
+}
+declare const componentBlock: ComponentBlockMap;
+export default componentBlock;

package/dist/types/src/types/FormFields.d.ts

@@ -0,0 +1,33 @@
+import { FieldFactory } from "../components/Component";
+import { InputProps, TextAreaProps, CheckboxProps } from "../components/ui/fields/Input";
+import { SelectProps } from "../components/ui/fields/Select";
+import { ImageUrlProps } from "../components/ui/fields/ImageUrl";
+import { UploadDocumentProps, UploadImageProps } from "../components/ui/fields/Upload";
+import { PromptProps } from "../components/widgets/Prompt";
+export interface ComponentFormFieldsMap {
+    string: FieldFactory<Partial<InputProps>>;
+    number: FieldFactory<Partial<InputProps>>;
+    email: FieldFactory<Partial<InputProps>>;
+    password: FieldFactory<Partial<InputProps>>;
+    color: FieldFactory<Partial<InputProps>>;
+    date: FieldFactory<Partial<InputProps>>;
+    time: FieldFactory<Partial<InputProps>>;
+    datetime: FieldFactory<Partial<InputProps>>;
+    week: FieldFactory<Partial<InputProps>>;
+    month: FieldFactory<Partial<InputProps>>;
+    textarea: FieldFactory<Partial<TextAreaProps>>;
+    checkbox: FieldFactory<Partial<CheckboxProps>>;
+    switch: FieldFactory<Partial<CheckboxProps>>;
+    select: FieldFactory<Partial<SelectProps>>;
+    autocomplete: FieldFactory<Partial<SelectProps>>;
+    checklist: FieldFactory<Partial<SelectProps>>;
+    uploadImage: FieldFactory<Partial<UploadImageProps>>;
+    uploadDocument: FieldFactory<Partial<UploadDocumentProps>>;
+    prompt: FieldFactory<Partial<PromptProps>>;
+    imageUrl: FieldFactory<Partial<ImageUrlProps>>;
+    menu: FieldFactory<{
+        defaultValue?: string;
+    }>;
+}
+declare const componentFormFields: ComponentFormFieldsMap;
+export default componentFormFields;

package/dist/types/src/types/Layout.d.ts

@@ -0,0 +1,9 @@
+import { Container, Wrapper, Row, Col } from "../components/ui/GridSystem";
+export interface ComponentLayoutMap {
+    container: typeof Container;
+    wrapper: typeof Wrapper;
+    row: typeof Row;
+    col: typeof Col;
+}
+declare const componentLayout: ComponentLayoutMap;
+export default componentLayout;

package/dist/types/src/types/Section.d.ts

@@ -0,0 +1,4 @@
+export interface ComponentSectionMap {
+}
+declare const componentSection: ComponentSectionMap;
+export default componentSection;

package/dist/types/themes/cyber.d.ts

@@ -0,0 +1,7 @@
+import type { Theme, ThemeDefinition, ThemePresetConfig } from '../src/Theme';
+import type { MotionRegistry } from '../src/motion';
+export declare const preset: ThemePresetConfig;
+export declare const motion: MotionRegistry;
+export declare const components: Theme;
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/types/themes/default.d.ts

@@ -0,0 +1,7 @@
+import type { Theme, ThemeDefinition, ThemePresetConfig } from '../src/Theme';
+import type { MotionRegistry } from '../src/motion';
+export declare const preset: ThemePresetConfig;
+export declare const motion: MotionRegistry;
+export declare const components: Theme;
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/types/themes/flat.d.ts

@@ -0,0 +1,7 @@
+import type { Theme, ThemeDefinition, ThemePresetConfig } from '../src/Theme';
+import type { MotionRegistry } from '../src/motion';
+export declare const preset: ThemePresetConfig;
+export declare const motion: MotionRegistry;
+export declare const components: Theme;
+declare const definition: ThemeDefinition;
+export default definition;

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "@llmnative/react",
+  "version": "0.1.0",
+  "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/types/src/index.d.ts",
+  "style": "dist/index.css",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./dist/index.css": "./dist/index.css"
+  },
+  "scripts": {
+    "prebuild": "node scripts/dev/build-local.js --restore-only",
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "build:dev": "vite build --mode development && tsc --emitDeclarationOnly",
+    "watch:dev": "vite build --watch",
+    "build:local": "node scripts/dev/build-local.js",
+    "prepublishOnly": "npm run build",
+    "updateReadme": "node scripts/dev/updateReadme.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "bin": {
+    "llmnative": "./bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "dist/**/*.map",
+    "bin",
+    "scripts/cli",
+    "themes"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sherpadvisorylab/llmnative-react.git"
+  },
+  "keywords": [
+    "react",
+    "admin",
+    "dashboard",
+    "crud",
+    "schema-driven",
+    "admin-panel",
+    "backoffice",
+    "internal-tools",
+    "ai-first",
+    "ai-assisted",
+    "provider-agnostic",
+    "framework",
+    "typescript",
+    "tailwind",
+    "vite"
+  ],
+  "author": "wolfgan",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/sherpadvisorylab/llmnative-react/issues"
+  },
+  "homepage": "https://github.com/sherpadvisorylab/llmnative-react#readme",
+  "peerDependencies": {
+    "@phosphor-icons/react": "^2.0.0",
+    "firebase": "^10.14.0",
+    "lucide-react": "^0.400.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.22.0"
+  },
+  "peerDependenciesMeta": {
+    "@phosphor-icons/react": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.7",
+    "@babel/plugin-proposal-class-properties": "^7.18.6",
+    "@babel/plugin-proposal-object-rest-spread": "^7.20.7",
+    "@babel/preset-env": "^7.25.7",
+    "@babel/preset-react": "^7.25.7",
+    "@babel/preset-typescript": "^7.25.7",
+    "@phosphor-icons/react": "^2.1.10",
+    "@tailwindcss/postcss": "^4.2.4",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/papaparse": "^5.3.16",
+    "@types/prismjs": "^1.26.5",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitest/coverage-v8": "2.1",
+    "autoprefixer": "^10.5.0",
+    "googleapis": "^171.4.0",
+    "happy-dom": "^20.9.0",
+    "jsdom": "^29.1.1",
+    "lucide-react": "^1.14.0",
+    "postcss": "^8.5.14",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-router-dom": "^6.30.3",
+    "tailwindcss": "^4.2.4",
+    "typescript": "^5.6.2",
+    "vite": "^5.4.21",
+    "vitest": "2.1"
+  },
+  "dependencies": {
+    "buffer": "^6.0.3",
+    "clsx": "^2.1.1",
+    "papaparse": "^5.5.3",
+    "prismjs": "^ 1.30.0",
+    "react-markdown": "^10.1.0",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-sanitize": "^6.0.0",
+    "rehype-slug": "^6.0.0",
+    "remark-gfm": "^4.0.1",
+    "tailwind-merge": "^3.5.0",
+    "tui-image-editor": "^3.15.3"
+  }
+}

package/scripts/cli/create-section.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const sectionName = process.argv[2];
+
+if (!sectionName) {
+    console.error('❌  Devi specificare il nome della sezione. Esempio: node create-section.js Hero');
+    process.exit(1);
+}
+
+const sectionFileName = `${sectionName}.js`;
+const targetDir = path.join(__dirname, 'src', 'templates', 'sections');
+const targetPath = path.join(targetDir, sectionFileName);
+
+if (fs.existsSync(targetPath)) {
+    console.error(`❌  La sezione "${sectionName}" esiste già.`);
+    process.exit(1);
+}
+
+const content = `
+// ${sectionName}.js - generato con create-section
+
+const ${sectionName}Model = [
+  { name: 'title', type: 'text', label: 'Titolo' }
+];
+
+function ${sectionName}EditorLayout({ fields }) {
+  return (
+    <div className="${sectionName.toLowerCase()}-editor">
+      <FormFields fields={fields} />
+    </div>
+  );
+}
+
+function ${sectionName}HtmlLayout({ fields }) {
+  return (
+    <div className="${sectionName.toLowerCase()}-html">
+      <StaticFields fields={fields} />
+    </div>
+  );
+}
+
+export function ${sectionName}Editor() {
+  return (
+    <Form model={${sectionName}Model}>
+      {(fields) => <${sectionName}EditorLayout fields={fields} />}
+    </Form>
+  );
+}
+
+export function ${sectionName}Html() {
+  return (
+    <StaticRenderer model={${sectionName}Model}>
+      {(fields) => <${sectionName}HtmlLayout fields={fields} />}
+    </StaticRenderer>
+  );
+}
+`;
+
+fs.mkdirSync(targetDir, { recursive: true });
+fs.writeFileSync(targetPath, content.trimStart());
+
+console.log(`✅  Sezione "${sectionName}" creata in: ${targetPath}`);

package/scripts/cli/setup-devtools.js

@@ -0,0 +1,85 @@
+const fs = require('fs');
+const path = require('path');
+
+const root = process.cwd();
+
+function ensureFile(filePath, content) {
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, content.trimStart());
+        console.log(`Created file: ${filePath}`);
+    }
+}
+
+function setupDevTools() {
+    console.log('Setting up Vite + React + TypeScript');
+
+    ensureFile(path.join(root, 'tsconfig.json'), `
+{
+  "compilerOptions": {
+    "target": "ES2021",
+    "useDefineForClassFields": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2021"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}
+    `);
+
+    ensureFile(path.join(root, 'tsconfig.node.json'), `
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}
+    `);
+
+    ensureFile(path.join(root, 'vite.config.ts'), `
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig(({ mode }) => {
+  return {
+    plugins: [react()],
+    resolve: {
+      dedupe: ['react', 'react-dom', 'react-router-dom'],
+    },
+    build: {
+      cssMinify: false,
+      chunkSizeWarningLimit: 10000,
+    },
+    define: {
+      'process.env.NODE_ENV': JSON.stringify(mode === 'production' ? 'production' : 'development'),
+    },
+  };
+});
+    `);
+
+    ensureFile(path.join(root, 'postcss.config.js'), `
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+    autoprefixer: {},
+  },
+};
+    `);
+}
+
+module.exports = { setupDevTools };