initial commit

Author: gunta

.gitignore

@@ -0,0 +1,43 @@
+# Node.js dependencies & logs
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Bun
+bun.lockb
+
+# Next.js build output
+.next/
+out/
+.turbo/
+
+# Testing & coverage
+coverage/
+.nyc_output/
+
+# TypeScript
+*.tsbuildinfo
+
+# IDE/editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Env files
+.env
+.env.local
+.env.*.local
+
+# Misc
+dist/
+tmp/
+temp/
+
+/lib/
+.bsb.lock

.source/index.ts

@@ -0,0 +1,6 @@
+// @ts-nocheck -- skip type checking
+import * as docs_1 from "../content/docs/test.mdx?collection=docs&hash=1760316941584"
+import * as docs_0 from "../content/docs/index.mdx?collection=docs&hash=1760316941584"
+import { _runtime } from "fumadocs-mdx/runtime/next"
+import * as _source from "../source.config"
+export const docs = _runtime.docs<typeof _source.docs>([{ info: {"path":"index.mdx","fullPath":"content/docs/index.mdx"}, data: docs_0 }, { info: {"path":"test.mdx","fullPath":"content/docs/test.mdx"}, data: docs_1 }], [])

.source/source.config.mjs

@@ -0,0 +1,27 @@
+// source.config.ts
+import {
+  defineConfig,
+  defineDocs,
+  frontmatterSchema,
+  metaSchema
+} from "fumadocs-mdx/config";
+var docs = defineDocs({
+  docs: {
+    schema: frontmatterSchema,
+    postprocess: {
+      includeProcessedMarkdown: true
+    }
+  },
+  meta: {
+    schema: metaSchema
+  }
+});
+var source_config_default = defineConfig({
+  mdxOptions: {
+    // MDX options
+  }
+});
+export {
+  source_config_default as default,
+  docs
+};

README.md

@@ -0,0 +1,45 @@
+# betterscript-docs
+
+This is a Next.js application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```
+
+Open http://localhost:3000 with your browser to see the result.
+
+## Explore
+
+In the project, you can see:
+
+- `lib/source.ts`: Code for content source adapter, [`loader()`](https://fumadocs.dev/docs/headless/source-api) provides the interface to access your content.
+- `lib/layout.shared.tsx`: Shared options for layouts, optional but preferred to keep.
+
+| Route                     | Description                                            |
+| ------------------------- | ------------------------------------------------------ |
+| `app/(home)`              | The route group for your landing page and other pages. |
+| `app/docs`                | The documentation layout and pages.                    |
+| `app/api/search/route.ts` | The Route Handler for search.                          |
+
+### Fumadocs MDX
+
+A `source.config.ts` config file has been included, you can customise different options like frontmatter schema.
+
+Read the [Introduction](https://fumadocs.dev/docs/mdx) for further details.
+
+## Learn More
+
+To learn more about Next.js and Fumadocs, take a look at the following
+resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+  features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+- [Fumadocs](https://fumadocs.dev) - learn about Fumadocs

bun.lock

@@ -0,0 +1,39 @@
+# BetterScript
+
+A new programming language that is native for LLMs.
+This repository contains a proof-of-concept reference and examples of the language.
+
+## Goal
+1. MUST Include as much as best practices from the CS field as possible.
+2. SHALL Be easy to learn and use for LLMs. Don't optimize for humans, optimize for LLMs.
+3. CAN optimize for token usage, but determinism and quality has priority, so verbosity is ok if needed.
+4. MUST be able to run on any platform, so compiling to JavaScript and/or TypeScript is a must.
+5. CAN use ReScript as starting point and even use/modify its compiler, so we can include all its features.
+6. SHALL be able to use along React and Svelte too.
+7. MUST include a standard library that includes concepts from the best practices and libraries (Think of Effect, Immer, etc)
+8. SHALL include all the tooling, linting, pre-commit hooks.
+9. CAN use Biome as starting point for linting, or just the ReScript.
+10. SHALL embrace parallel programming and concurrency at any level, including agents.
+11. CAN use all the best recent modern practices: 
+12. EXAMPLE: Use Jujutsu workspaces for developing features in parallel, and assing feature flags for each part of the code.
+13. MUST have all the features shall be native to this language, lets use as most concise, terse and beautiful syntax as we can.
+14. CAN have the flow: Idea -> Design -> Generate signatures -> Create workspace -> Create granular feature flags -> Implement in parallel -> Test in parallel -> Deploy in parallel
+
+
+## Some features to expect
+Intents based programming
+Signatures like DSPy
+Verbosity
+Contracts
+Purity
+Proof
+Test-Driven Development
+Spec-Driven Development
+Dependency Injection
+State Machines
+Determinism
+Pre-Commit Hooks
+100% Code Coverage
+Build Speed
+Errors with Suggestions
+Embeded Open Telemetry

content/concept.mdx

@@ -0,0 +1,13 @@
+---
+title: Hello World
+description: Your first document
+---
+
+Welcome to the docs! You can start writing documents in `/content/docs`.
+
+## What is Next?
+
+<Cards>
+  <Card title="Learn more about Next.js" href="https://nextjs.org/docs" />
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.dev" />
+</Cards>

content/docs/index.mdx

@@ -0,0 +1,17 @@
+---
+title: Components
+description: Components
+---
+
+## Code Block
+
+```js
+console.log('Hello World');
+```
+
+## Cards
+
+<Cards>
+  <Card title="Learn more about Next.js" href="https://nextjs.org/docs" />
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.dev" />
+</Cards>