@pineui/react 0.1.0

package/LICENSE

@@ -0,0 +1,168 @@
+Apache License 2.0 with Commons Clause
+
+License Agreement
+
+PineUI - Server-Driven UI for AI-Native Applications
+Copyright (c) 2026 Luma Ventures Ltda (CNPJ: 21.951.820/0001-39)
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License. You may obtain a copy
+of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.
+
+---
+
+"Commons Clause" License Condition v1.0
+
+The Software is provided to you by the Licensor under the License, as defined
+below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights under the
+License will not include, and the License does not grant to you, the right to
+Sell the Software.
+
+For purposes of the foregoing, "Sell" means practicing any or all of the rights
+granted to you under the License to provide to third parties, for a fee or
+other consideration (including without limitation fees for hosting or
+consulting/support services related to the Software), a product or service
+whose value derives, entirely or substantially, from the functionality of the
+Software. Any license notice or attribution required by the License must also
+include this Commons Clause License Condition notice.
+
+Software: PineUI
+
+License: Apache 2.0
+
+Licensor: Luma Ventures Ltda
+CNPJ: 21.951.820/0001-39
+
+---
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction, and
+   distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by the
+   copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all other
+   entities that control, are controlled by, or are under common control with
+   that entity. For the purposes of this definition, "control" means (i) the
+   power, direct or indirect, to cause the direction or management of such
+   entity, whether by contract or otherwise, or (ii) ownership of fifty
+   percent (50%) or more of the outstanding shares, or (iii) beneficial
+   ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity exercising
+   permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation source,
+   and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical transformation
+   or translation of a Source form, including but not limited to compiled
+   object code, generated documentation, and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or Object form,
+   made available under the License, as indicated by a copyright notice that
+   is included in or attached to the work.
+
+   "Derivative Works" shall mean any work, whether in Source or Object form,
+   that is based on (or derived from) the Work and for which the editorial
+   revisions, annotations, elaborations, or other modifications represent, as
+   a whole, an original work of authorship. For the purposes of this License,
+   Derivative Works shall not include works that remain separable from, or
+   merely link (or bind by name) to the interfaces of, the Work and Derivative
+   Works thereof.
+
+   "Contribution" shall mean any work of authorship, including the original
+   version of the Work and any modifications or additions to that Work or
+   Derivative Works thereof, that is intentionally submitted to Licensor for
+   inclusion in the Work by the copyright owner or by an individual or Legal
+   Entity authorized to submit on behalf of the copyright owner.
+
+2. Grant of Copyright License.
+
+   Subject to the terms and conditions of this License, each Contributor hereby
+   grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+   irrevocable copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the Work and
+   such Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+   Subject to the terms and conditions of this License, each Contributor hereby
+   grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+   irrevocable patent license to make, have made, use, offer to sell, sell,
+   import, and otherwise transfer the Work.
+
+4. Redistribution.
+
+   You may reproduce and distribute copies of the Work or Derivative Works
+   thereof in any medium, with or without modifications, and in Source or
+   Object form, provided that You meet the following conditions:
+
+   (a) You must give any other recipients of the Work or Derivative Works a
+       copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices stating
+       that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works that You
+       distribute, all copyright, patent, trademark, and attribution notices
+       from the Source form of the Work; and
+
+   (d) You must include a copy of this License and the Commons Clause restriction.
+
+5. Submission of Contributions.
+
+   Unless You explicitly state otherwise, any Contribution intentionally
+   submitted for inclusion in the Work by You to the Licensor shall be under
+   the terms and conditions of this License, without any additional terms or
+   conditions.
+
+6. Trademarks.
+
+   This License does not grant permission to use the trade names, trademarks,
+   service marks, or product names of the Licensor, except as required for
+   reasonable and customary use in describing the origin of the Work.
+
+7. Disclaimer of Warranty.
+
+   Unless required by applicable law or agreed to in writing, Licensor provides
+   the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+   either express or implied, including, without limitation, any warranties or
+   conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE.
+
+8. Limitation of Liability.
+
+   In no event and under no legal theory shall any Contributor be liable to You
+   for damages, including any direct, indirect, special, incidental, or
+   consequential damages of any character arising as a result of this License or
+   out of the use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability.
+
+   While redistributing the Work or Derivative Works thereof, You may choose to
+   offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+   other liability obligations and/or rights consistent with this License.
+   However, in accepting such obligations, You may act only on Your own behalf
+   and on Your sole responsibility.
+
+---
+
+For commercial licensing inquiries, please contact:
+Luma Ventures Ltda
+CNPJ: 21.951.820/0001-39
+Email: wupsbr@gmail.com

package/README.md

@@ -0,0 +1,144 @@
+# @pineui/react
+
+Server-Driven UI framework for AI-native applications. Build dynamic, multi-platform interfaces from JSON schemas.
+
+🍍 **PineUI** helps you peel through the tough challenges of building dynamic, cross-platform UIs.
+
+## Installation
+
+```bash
+npm install @pineui/react react react-dom
+```
+
+## Quick Start
+
+```tsx
+import { PineUI } from '@pineui/react';
+
+function App() {
+  return (
+    <PineUI
+      schema={{
+        schemaVersion: "1.0.0",
+        screen: {
+          type: "layout.column",
+          padding: 16,
+          spacing: 16,
+          children: [
+            {
+              type: "text",
+              content: "Hello PineUI!",
+              style: "titleLarge"
+            },
+            {
+              type: "button.filled",
+              label: "Click Me",
+              onPress: {
+                type: "action.snackbar.show",
+                message: "Button clicked!"
+              }
+            }
+          ]
+        }
+      }}
+    />
+  );
+}
+```
+
+## Standalone Usage (CDN)
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <link rel="stylesheet" href="https://unpkg.com/@pineui/react@latest/dist/style.css">
+</head>
+<body>
+  <div id="app"></div>
+
+  <script src="https://unpkg.com/@pineui/react@latest/dist/pineui.standalone.js"></script>
+  <script>
+    PineUI.render({
+      target: '#app',
+      schema: {
+        schemaVersion: "1.0.0",
+        screen: {
+          type: "text",
+          content: "Hello from PineUI!",
+          style: "titleLarge"
+        }
+      }
+    });
+  </script>
+</body>
+</html>
+```
+
+## Features
+
+- 🚀 **Fast** - 60 FPS guaranteed, ~52KB gzipped
+- 🌍 **Cross-Platform** - Same JSON schema works on Web and Mobile (Flutter coming soon)
+- 🤖 **AI-Friendly** - LLMs can generate valid UIs without specific training
+- 🎨 **Material Design 3** - Beautiful components out of the box
+- 🔄 **Reactive** - Built-in state management with automatic UI updates
+- 📱 **Responsive** - Mobile-first with automatic breakpoints
+
+## Documentation
+
+📖 [Complete Documentation](https://pineui.github.io/PineUI/documentation.html)
+
+🚀 [Live Demos](https://pineui.github.io/PineUI/)
+
+## Example: LLM-Generated UI
+
+```javascript
+// Just describe what you want to an LLM:
+// "Create a course gallery with category filters using PineUI"
+
+const schema = {
+  schemaVersion: "1.0.0",
+  state: { selectedCategory: "All" },
+  screen: {
+    type: "layout.column",
+    children: [
+      // ... LLM generates complete UI ...
+    ]
+  }
+};
+
+PineUI.render({ target: '#app', schema });
+```
+
+## License
+
+Apache 2.0 with Commons Clause
+
+**You CAN:**
+- ✅ Use PineUI for free in your projects (commercial or non-commercial)
+- ✅ Modify the source code
+- ✅ Distribute copies of PineUI
+- ✅ Use it in proprietary software
+
+**You CANNOT:**
+- ❌ Sell PineUI itself as a product or service
+- ❌ Offer hosting or consulting services where the primary value comes from PineUI
+
+For commercial licensing: wupsbr@gmail.com
+
+## Creator
+
+Created by **David Ruiz (wupsbr)** - CPTO at Ingresse, former Director of Engineering at iFood (R$70B+ GMV), CTO at Paraná Banco, and co-founder of ONOVOLAB.
+
+Developed by Luma Ventures Ltda (CNPJ: 21.951.820/0001-39)
+
+## Links
+
+- [GitHub Repository](https://github.com/PineUI/PineUI)
+- [Documentation](https://pineui.github.io/PineUI/documentation.html)
+- [Live Demos](https://pineui.github.io/PineUI/)
+- [Issues](https://github.com/PineUI/PineUI/issues)
+
+---
+
+🍍 **Peel through tough UI challenges with PineUI**

package/dist/PineUI.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { PineUISchema } from './types';
+
+interface PineUIProps {
+    schema?: PineUISchema;
+    schemaUrl?: string;
+    baseUrl?: string;
+}
+export declare const PineUI: React.FC<PineUIProps>;
+export {};

package/dist/components/AppBar.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext } from '../types';
+
+interface AppBarProps {
+    title?: ComponentNode;
+    leading?: ComponentNode;
+    actions?: ComponentNode[];
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const AppBar: React.FC<AppBarProps>;
+export {};

package/dist/components/Avatar.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { RenderContext, ActionNode } from '../types';
+
+interface AvatarProps {
+    src: string;
+    size?: number;
+    onTap?: ActionNode;
+    context?: RenderContext;
+}
+export declare const Avatar: React.FC<AvatarProps>;
+export {};

package/dist/components/Badge.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+
+interface BadgeProps {
+    label: string;
+    variant?: 'default' | 'success' | 'warning' | 'error' | 'info';
+    size?: 'small' | 'medium' | 'large';
+}
+export declare const Badge: React.FC<BadgeProps>;
+export {};

package/dist/components/BottomNav.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { RenderContext, ActionNode } from '../types';
+
+interface BottomNavItem {
+    icon: string;
+    label: string;
+    destination: string;
+    badge?: number;
+}
+interface BottomNavProps {
+    items: BottomNavItem[];
+    currentIndex: number;
+    onItemTap: ActionNode;
+    context?: RenderContext;
+}
+export declare const BottomNav: React.FC<BottomNavProps>;
+export {};

package/dist/components/Button.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { RenderContext, ActionNode } from '../types';
+
+interface ButtonProps {
+    type: 'button.filled' | 'button.text' | 'button.icon' | 'button.fab';
+    label?: string;
+    icon?: string;
+    enabled?: boolean;
+    loading?: boolean;
+    onPress?: ActionNode;
+    context?: RenderContext;
+    size?: 'small' | 'medium' | 'large';
+    color?: string;
+}
+export declare const Button: React.FC<ButtonProps>;
+export {};

package/dist/components/Card.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext, ActionNode } from '../types';
+
+interface CardProps {
+    child: ComponentNode;
+    elevation?: number;
+    padding?: number;
+    onTap?: ActionNode;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Card: React.FC<CardProps>;
+export {};

package/dist/components/Chip.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { ActionNode, RenderContext } from '../types';
+
+interface ChipProps {
+    label: string;
+    icon?: string;
+    selected?: boolean;
+    onPress?: ActionNode;
+    context?: RenderContext;
+}
+export declare const Chip: React.FC<ChipProps>;
+export {};

package/dist/components/Collection.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext, ActionNode } from '../types';
+
+interface CollectionProps {
+    id: string;
+    layout?: 'list' | 'grid' | 'table';
+    columns?: number;
+    spacing?: number;
+    data: ActionNode;
+    itemTemplate: ComponentNode;
+    loadingState?: ComponentNode;
+    emptyState?: ComponentNode;
+    errorState?: ComponentNode;
+    virtualized?: boolean;
+    refreshable?: boolean;
+    onRefresh?: ActionNode;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Collection: React.FC<CollectionProps>;
+export {};

package/dist/components/ConditionalRender.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext } from '../types';
+
+interface Condition {
+    when: string | boolean;
+    render: ComponentNode;
+}
+interface ConditionalRenderProps {
+    conditions: Condition[];
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const ConditionalRender: React.FC<ConditionalRenderProps>;
+export {};

package/dist/components/Divider.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+
+interface DividerProps {
+    thickness?: number;
+    color?: string;
+}
+export declare const Divider: React.FC<DividerProps>;
+export {};

package/dist/components/ErrorBoundary.d.ts

@@ -0,0 +1,17 @@
+import { Component, ErrorInfo, ReactNode } from 'react';
+
+interface Props {
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+interface State {
+    hasError: boolean;
+    error: Error | null;
+}
+export declare class ErrorBoundary extends Component<Props, State> {
+    constructor(props: Props);
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | null | undefined;
+}
+export {};

package/dist/components/Grid.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext } from '../types';
+
+interface GridProps {
+    children: ComponentNode[];
+    columns?: number;
+    spacing?: number;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Grid: React.FC<GridProps>;
+export {};

package/dist/components/Icon.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { RenderContext } from '../types';
+
+interface IconProps {
+    name: string;
+    size?: number;
+    color?: string;
+    visible?: boolean;
+    context?: RenderContext;
+}
+export declare const Icon: React.FC<IconProps>;
+export {};

package/dist/components/Image.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { RenderContext, ActionNode } from '../types';
+
+interface ImageProps {
+    src: string;
+    thumbnail?: string;
+    alt?: string;
+    aspectRatio?: number | string;
+    borderRadius?: number;
+    loading?: 'eager' | 'lazy';
+    onTap?: ActionNode;
+    context?: RenderContext;
+}
+export declare const Image: React.FC<ImageProps>;
+export {};

package/dist/components/Input.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { RenderContext, ActionNode } from '../types';
+
+interface InputProps {
+    type: 'input.text';
+    id?: string;
+    placeholder?: string;
+    value?: string;
+    multiline?: boolean;
+    maxLines?: number;
+    maxLength?: number;
+    autofocus?: boolean;
+    onChanged?: ActionNode;
+    context?: RenderContext;
+}
+export declare const Input: React.FC<InputProps>;
+export {};

package/dist/components/Layout.d.ts

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext, ActionNode } from '../types';
+
+interface LayoutProps {
+    type: 'layout.column' | 'layout.row';
+    children?: ComponentNode[];
+    spacing?: number;
+    padding?: number;
+    mainAxisAlignment?: 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround';
+    crossAxisAlignment?: 'start' | 'center' | 'end' | 'stretch';
+    flex?: number;
+    width?: number | string;
+    height?: number | string;
+    maxWidth?: number | string;
+    overflow?: 'visible' | 'hidden' | 'scroll' | 'auto';
+    backgroundColor?: string;
+    border?: string;
+    borderRadius?: number;
+    elevation?: number;
+    borderRight?: string;
+    borderLeft?: string;
+    borderTop?: string;
+    borderBottom?: string;
+    onPress?: ActionNode;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Layout: React.FC<LayoutProps>;
+export {};

package/dist/components/Modal.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext } from '../types';
+
+interface ModalProps {
+    id: string;
+    presentation?: 'modal' | 'bottomSheet' | 'dialog';
+    dismissible?: boolean;
+    child: ComponentNode;
+    onClose: () => void;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Modal: React.FC<ModalProps>;
+interface ModalContainerProps {
+    overlays: Record<string, {
+        visible: boolean;
+        config: any;
+    }>;
+    onClose: (id: string) => void;
+    context: RenderContext;
+    renderer: React.ComponentType<any>;
+}
+export declare const ModalContainer: React.FC<ModalContainerProps>;
+export {};

package/dist/components/Progress.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+
+interface ProgressProps {
+    value: number;
+    label?: string;
+    showPercentage?: boolean;
+    color?: string;
+}
+export declare const Progress: React.FC<ProgressProps>;
+export {};

package/dist/components/Scaffold.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ComponentNode, RenderContext } from '../types';
+
+interface ScaffoldProps {
+    appBar?: ComponentNode;
+    body: ComponentNode;
+    floatingActionButton?: ComponentNode;
+    bottomNavigationBar?: ComponentNode;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Scaffold: React.FC<ScaffoldProps>;
+export {};

package/dist/components/Snackbar.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+
+export interface SnackbarMessage {
+    id: string;
+    message: string;
+    duration?: number;
+    action?: {
+        label: string;
+        onPress: any;
+    };
+}
+interface SnackbarProps {
+    messages: SnackbarMessage[];
+    onDismiss: (id: string) => void;
+}
+export declare const SnackbarContainer: React.FC<SnackbarProps>;
+export {};

package/dist/components/Table.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { RenderContext, ComponentNode, ActionNode } from '../types';
+
+interface TableColumn {
+    key: string;
+    label: string;
+    width?: string;
+    template?: ComponentNode;
+}
+interface TableProps {
+    columns: TableColumn[];
+    data: any[] | ActionNode;
+    context?: RenderContext;
+    renderer?: React.ComponentType<any>;
+}
+export declare const Table: React.FC<TableProps>;
+export {};