veryfront 0.0.75 → 0.0.78

package/README.md

@@ -1,176 +1,59 @@
 # Veryfront
 
+[![npm version](https://img.shields.io/npm/v/veryfront.svg)](https://www.npmjs.com/package/veryfront)
 [![CI/CD](https://github.com/veryfront/veryfront-renderer/actions/workflows/ci.yml/badge.svg)](https://github.com/veryfront/veryfront-renderer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-Veryfront is a **zero-config React framework** for building **agentic applications**. Automatically discovers agents, tools, and routes through file-based conventions.
+The all-in-one React framework for building AI-powered applications and agents.
 
+## Features
 
-## Project Structure
-
-```
-my-ai-app/
-├── .env
-├── app/
-│   ├── chat/page.tsx
-│   └── api/chat/route.ts
-└── ai/
-    ├── agents/assistant.ts         # Auto-registered
-    ├── tools/calculator.ts         # Auto-discovered
-    └── resources/users/profile.ts  # MCP resources
-```
-
-The `ai/` directory auto-enables AI features. No config required.
-
----
+- **Zero config** — Auto-discovery from file structure
+- **Multi-runtime** — Deno, Node.js, Bun, Cloudflare Workers
+- **Full-stack React** — SSR, SSG, ISR, streaming
+- **MCP built-in** — Model Context Protocol server
+- **Production-ready** — Rate limiting, caching, observability
 
 ## Quick Start
 
-**1. Install**
-```bash
-deno add npm:veryfront npm:ai npm:zod
-```
-
-**2. Create an agent**
-
-`ai/agents/assistant.ts`:
-```typescript
-import { agent } from 'veryfront/ai';
-
-export default agent({
-  model: 'openai/gpt-4',
-  system: 'You are a helpful assistant.',
-  tools: { calculator: true },
-});
-```
-
-**3. Add a tool**
-
-`ai/tools/calculator.ts`:
-```typescript
-import { tool } from 'veryfront/ai';
-import { z } from 'zod';
-
-export default tool({
-  description: 'Perform calculations',
-  inputSchema: z.object({ expression: z.string() }),
-  execute: async ({ expression }) => ({ result: eval(expression) }),
-});
-```
-
-**4. Create the API endpoint**
-
-`app/api/chat/route.ts`:
-```typescript
-import { agents } from '../../../ai/agents';
-
-export async function POST(req: Request) {
-  return agents.assistant.respond(req);
-}
-```
-
-**5. Add the UI**
-
-`app/chat/page.tsx`:
-```tsx
-'use client';
-import { Chat } from 'veryfront/ai/components';
-import { useChat } from 'veryfront/ai/react';
-
-export default function ChatPage() {
-  return <Chat {...useChat({ api: '/api/chat' })} />;
-}
-```
-
-**6. Run**
 ```bash
-echo "OPENAI_API_KEY=sk-..." > .env
-deno task dev
-```
-
-Visit `localhost:3000/chat` - your agent can now use the calculator tool.
-
----
-
-## UI Customization
-
-**Styled components** (production-ready):
-```tsx
-import { Chat } from 'veryfront/ai/components';
-```
-
-**Primitives** (bring your own styles):
-```tsx
-import { ChatContainer, MessageList, MessageItem } from 'veryfront/ai/primitives';
-```
-
-**Headless hooks** (total control):
-```tsx
-import { useChat } from 'veryfront/ai/react';
+npx veryfront demo
 ```
 
----
-
-## Model Context Protocol
-
-MCP exposes your tools and resources to external AI applications. Enabled by default when `ai/` directory exists.
-
-**Add a resource:**
-
-`ai/resources/users/profile.ts`:
-```typescript
-import { resource } from 'veryfront/ai';
-import { z } from 'zod';
+## Project Structure
 
-export default resource({
-  description: 'Get user profile',
-  paramsSchema: z.object({ userId: z.string() }),
-  async load({ userId }) {
-    return await db.users.findUnique({ where: { id: userId } });
-  },
-});
 ```
-
-**Run MCP server:**
-```bash
-deno task dev --mcp  # Port 3001 by default
+my-app/
+├── app/                     # App Router (pages & APIs)
+│   ├── chat/page.tsx
+│   └── api/chat/route.ts
+├── agents/                  # AI agents
+├── tools/                   # MCP tools
+├── workflows/               # Durable workflows
+├── prompts/                 # Prompt templates
+└── resources/               # MCP resources
 ```
 
----
-
-## Features
-
-- **Zero config** - Auto-discovery from file structure
-- **Multi-runtime** - Deno, Node.js, Bun, Cloudflare Workers
-- **Full-stack React** - SSR, SSG, ISR, JIT rendering
-- **Remote imports** - Use `https://esm.sh/pkg` directly, no node_modules needed
-- **MCP built-in** - Model Context Protocol server
-- **Production-ready** - Rate limiting, caching, cost tracking, security
-
----
+All directories are auto-discovered.
 
 ## Documentation
 
-- [Quick Start Tutorial](./docs/learn/quickstart.md)
-- [AI Getting Started](./docs/ai/getting-started.md)
-- [Routing Guide](./docs/guides/routing/README.md)
-- [Deployment Guide](./docs/guides/deployment/README.md)
-- [API Reference](./docs/reference/ai/README.md)
-
-[Browse all docs →](./docs/README.md)
+- [Getting Started](https://veryfront.com/docs/framework)
+- [Agents](https://veryfront.com/docs/framework/agents)
+- [Tools](https://veryfront.com/docs/framework/tools)
+- [Workflows](https://veryfront.com/docs/framework/workflows)
+- [MCP Server](https://veryfront.com/docs/framework/mcp)
 
----
+## Community
 
-## Examples
-
-```bash
-cd examples/ai-basic
-deno run --allow-all demo.ts
-```
+- [Discord](https://discord.gg/veryfront)
+- [X](https://x.com/veryfrontdev)
+- [GitHub Discussions](https://github.com/veryfront/veryfront/discussions)
 
-See [examples/](./examples/) for more.
+## Contributing
 
----
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 ## License
 
-MIT - see [LICENSE](./LICENSE)
+MIT

package/bin/veryfront.js

@@ -1,7 +1,23 @@
 #!/usr/bin/env node
-// CLI entry point - calls main() from the bundled CLI
-import { main } from '../dist/cli.js';
-main().catch(err => {
-  console.error(err);
-  process.exit(1);
-});
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+await import('../esm/_dnt.polyfills.js');
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const nativeBinary = join(__dirname, process.platform === 'win32' ? 'veryfront.exe' : 'veryfront');
+
+async function runJsFallback() {
+  const { main } = await import('../esm/src/cli/index.js');
+  await main();
+}
+
+if (existsSync(nativeBinary)) {
+  const child = spawn(nativeBinary, process.argv.slice(2), { stdio: 'inherit' });
+  child.on('close', (code) => process.exit(code ?? 0));
+  child.on('error', () => runJsFallback().catch(err => { console.error(err); process.exit(1); }));
+} else {
+  runJsFallback().catch(err => { console.error(err); process.exit(1); });
+}

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,172 @@
+declare global {
+    interface ArrayConstructor {
+        fromAsync<T>(iterableOrArrayLike: AsyncIterable<T> | Iterable<T | Promise<T>> | ArrayLike<T | Promise<T>>): Promise<T[]>;
+        fromAsync<T, U>(iterableOrArrayLike: AsyncIterable<T> | Iterable<T> | ArrayLike<T>, mapFn: (value: Awaited<T>) => U, thisArg?: any): Promise<Awaited<U>[]>;
+    }
+}
+export {}; /**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
+declare global {
+    interface Array<T> {
+        /**
+         * Returns the value of the last element in the array where predicate is true, and undefined
+         * otherwise.
+         * @param predicate find calls predicate once for each element of the array, in ascending
+         * order, until it finds one where predicate returns true. If such an element is found, find
+         * immediately returns that element value. Otherwise, find returns undefined.
+         * @param thisArg If provided, it will be used as the this value for each invocation of
+         * predicate. If it is not provided, undefined is used instead.
+         */
+        findLast<S extends T>(predicate: (this: void, value: T, index: number, obj: T[]) => value is S, thisArg?: any): S | undefined;
+        findLast(predicate: (value: T, index: number, obj: T[]) => unknown, thisArg?: any): T | undefined;
+        /**
+         * Returns the index of the last element in the array where predicate is true, and -1
+         * otherwise.
+         * @param predicate find calls predicate once for each element of the array, in ascending
+         * order, until it finds one where predicate returns true. If such an element is found,
+         * findIndex immediately returns that element index. Otherwise, findIndex returns -1.
+         * @param thisArg If provided, it will be used as the this value for each invocation of
+         * predicate. If it is not provided, undefined is used instead.
+         */
+        findLastIndex(predicate: (value: T, index: number, obj: T[]) => unknown, thisArg?: any): number;
+    }
+    interface Uint8Array {
+        /**
+         * Returns the value of the last element in the array where predicate is true, and undefined
+         * otherwise.
+         * @param predicate findLast calls predicate once for each element of the array, in descending
+         * order, until it finds one where predicate returns true. If such an element is found, findLast
+         * immediately returns that element value. Otherwise, findLast returns undefined.
+         * @param thisArg If provided, it will be used as the this value for each invocation of
+         * predicate. If it is not provided, undefined is used instead.
+         */
+        findLast<S extends number>(predicate: (value: number, index: number, array: Uint8Array) => value is S, thisArg?: any): S | undefined;
+        findLast(predicate: (value: number, index: number, array: Uint8Array) => unknown, thisArg?: any): number | undefined;
+        /**
+         * Returns the index of the last element in the array where predicate is true, and -1
+         * otherwise.
+         * @param predicate findLastIndex calls predicate once for each element of the array, in descending
+         * order, until it finds one where predicate returns true. If such an element is found,
+         * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
+         * @param thisArg If provided, it will be used as the this value for each invocation of
+         * predicate. If it is not provided, undefined is used instead.
+         */
+        findLastIndex(predicate: (value: number, index: number, array: Uint8Array) => unknown, thisArg?: any): number;
+    }
+}
+export {};
+declare global {
+    interface Error {
+        cause?: unknown;
+    }
+}
+export {};
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"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"}