clearkrypt 0.12.0

package/docs/LANGUAGE_SPEC.md

@@ -0,0 +1,102 @@
+# ClearKrypt Language Specification v0.1
+
+## Design Guarantees
+
+1. Deterministic compilation.
+2. No AI translation required.
+3. Stable AST for all targets.
+4. Strong typing with progressive inference.
+5. Built-in UI, cloud, auth, database, jobs, notifications, and policy abstractions.
+6. Target-specific adapters only at the final emission layer.
+
+## Syntax Families
+
+### App declaration
+
+```ck
+app "FixIt QC"
+```
+
+### Imports
+
+```ck
+use ui
+use cloud
+use auth
+```
+
+### Types
+
+```ck
+type User {
+  id: Text
+  role: Text
+  active: Bool
+}
+```
+
+### Screens
+
+```ck
+screen Home {
+  title "Home"
+  card {
+    text "Welcome"
+  }
+}
+```
+
+### Tasks
+
+```ck
+task add(a: Number, b: Number) -> Number {
+  return a + b
+}
+```
+
+### Intents
+
+Intent blocks describe durable app behavior such as triggers, automations, and workflows.
+
+```ck
+intent "notify when equipment returns to service" {
+  watch equipment
+  when status changes to "green" {
+    notify all users
+  }
+}
+```
+
+## Standard Types
+
+- Text
+- Number
+- Bool
+- Date
+- Time
+- DateTime
+- Decimal
+- Money
+- List<T>
+- Map<K,V>
+- Result<T,E>
+- Option<T>
+- Json
+- Blob
+- File
+- Image
+- Stream<T>
+
+## Advanced Planned Features
+
+- Pattern matching
+- Algebraic data types
+- Effects system
+- Sandboxed capabilities
+- Isolates/concurrency
+- Reactive state
+- Offline-first sync
+- UI render trees
+- Native bridge ABI
+- Package signing
+- Reproducible builds

package/docs/LAYOUT_AND_STYLING.md

@@ -0,0 +1,101 @@
+# ClearKrypt Layout and Styling
+
+ClearKrypt does not require dragging to make a usable app. Dragging is optional visual refinement.
+
+## Important rule
+
+`@pos(x, y)` is metadata for the visual editor. The web compiler now ignores `@pos` unless a screen explicitly says:
+
+```clearkrypt
+layout Freeform
+```
+
+That prevents accidental overlap. Normal apps should start with `layout Stack` or `layout Dashboard`.
+
+## Layout modes
+
+```clearkrypt
+screen Home {
+  layout Stack
+}
+```
+
+`Stack` places components vertically with consistent spacing and mobile-safe sizing.
+
+```clearkrypt
+screen Admin {
+  layout Dashboard
+}
+```
+
+`Dashboard` uses a responsive grid. Titles and text span the full width; cards and lists flow into columns.
+
+```clearkrypt
+screen Canvas {
+  layout Freeform
+  title "Move me" @pos(40, 40)
+}
+```
+
+`Freeform` honors `@pos`. Use it for diagrams, dashboards that need absolute placement, kiosks, maps, and highly custom layouts.
+
+## Modules
+
+`use ui` means: import the standard UI vocabulary into the file. It gives meaning to words like `screen`, `title`, `text`, `button`, `card`, `row`, `column`, `section`, `list`, `input`, and `toggle`.
+
+Other modules include:
+
+```clearkrypt
+use data      // typed records, stores, lists, add/update/delete flows
+use storage   // local/cloud persistence
+use auth      // users, roles, login-gated screens
+use network   // API calls and fetch tasks
+use platform  // phone/PC/web environment access
+use worker    // Cloudflare-style request handlers
+use crypto    // IDs, hashes, secure tokens
+use ai        // AI-friendly templates and future assistant hooks
+use test      // test blocks and assertions
+use deploy    // deployment metadata
+```
+
+## Basic styled app
+
+```clearkrypt
+app "Tasks"
+
+use ui
+use data
+use storage
+
+type Task {
+  id: Text
+  title: Text
+  done: Boolean
+}
+
+store local tasks as List<Task> default []
+
+screen Home {
+  layout Stack
+  title "Tasks"
+  text "This screen auto-aligns without dragging."
+  button "Add Task" {
+    add Task { id: newId(), title: "New task", done: false } to tasks
+  }
+  list tasks as task {
+    card {
+      text task.title
+      toggle task.done
+    }
+  }
+}
+```
+
+## Keep-out behavior
+
+ClearKrypt’s safe layout modes prevent overlap by default:
+
+- `Stack`: every element gets its own vertical slot.
+- `Dashboard`: elements flow into responsive grid slots.
+- `Freeform`: you are responsible for exact placement, but the visual editor can drag and update `@pos`.
+

package/docs/ONLINE_SANDBOX_EXPORTS.md

@@ -0,0 +1,28 @@
+# Online Sandbox Export Targets
+
+The ClearKrypt sandbox supports deterministic export previews for HTML, CSS, JavaScript, inline HTML, C#, and Swift.
+
+These outputs are generated from the parsed ClearKrypt source tree, not by AI translation.
+
+## Why this exists
+
+A brand-new language needs a way for users to see what the compiler means. The export tabs let users compare ClearKrypt code with familiar platform languages.
+
+## Targets
+
+- HTML: semantic document structure.
+- CSS: style tokens, spacing, radius, layout, and theme output.
+- JavaScript: browser event/action binding.
+- Inline HTML: single-file prototype.
+- C#: .NET MAUI/Blazor style sketch.
+- Swift: SwiftUI style sketch.
+
+## HTML means a complete web package
+
+In the online sandbox, selecting **HTML Package** does not mean “show only the HTML fragment.” It emits:
+
+- `index.html`
+- `style.css`
+- `main.js` when behavior is applicable
+
+This is intentional because a normal web app needs structure, styling, and behavior together. The separate CSS and JS tabs are inspection tabs for users who want only one generated file.

package/docs/PLATFORM_TARGETS.md

@@ -0,0 +1,35 @@
+# ClearKrypt Platform Targets
+
+ClearKrypt is designed like Dart in spirit: one language, deterministic compilers, multiple platform outputs.
+
+## Targets
+
+| Target | Command | Output |
+|---|---|---|
+| VM | `ck build app.ck --target vm` | ClearKrypt bytecode JSON |
+| JS | `ck build app.ck --target js` | JavaScript module |
+| Web | `ck build app.ck --target web` | Static HTML/CSS/JS |
+| Phone | `ck build app.ck --target phone` | Capacitor mobile shell |
+| PC | `ck build app.ck --target pc` | Electron desktop shell |
+| Worker | `ck build app.ck --target worker` | Cloudflare Worker |
+| Project | `ck build-all app.ck --out build` | Web + phone + PC + worker folders |
+
+## Phone environment
+
+The phone target emits a Capacitor-compatible project. It can preview in browser and then sync to Android Studio or Xcode.
+
+## PC environment
+
+The PC target emits an Electron-compatible project for Windows/macOS/Linux preview and packaging.
+
+## Web environment
+
+The web target emits static files suitable for Cloudflare Pages, Firebase Hosting, Netlify, Vercel, or any static server.
+
+## No AI translation
+
+ClearKrypt compilation is 1:1 and deterministic:
+
+`.ck source -> lexer -> parser -> semantic checker -> AST -> target emitter`
+
+AI can help write ClearKrypt source, but AI is not part of the compiler pipeline.

package/docs/README.md

@@ -0,0 +1,79 @@
+# ClearKrypt Language
+
+ClearKrypt is a cross-platform application language designed to compile one source tree into web apps, Cloudflare Workers, Node services, Firebase-style functions, and VM bytecode.
+
+This package includes:
+
+- CLI: `ck` / `clearkrypt`
+- Lexer, parser, semantic checker
+- VM bytecode target
+- JavaScript target
+- Web target
+- Cloudflare Worker target
+- Standard library design
+- Examples
+- A Duolingo-style course
+
+## Quick Start
+
+```bash
+npm install -g clearkrypt
+ck init my-app
+cd my-app
+ck run src/main.ck
+ck build src/main.ck --target web --out dist
+```
+
+## Philosophy
+
+ClearKrypt is declarative where apps should be declarative and imperative where logic needs control. It is designed around stable 1-to-1 compilation, not AI translation.
+
+## File extension
+
+`.ck`
+
+## Core Concepts
+
+```ck
+app "My App"
+use ui
+use cloud
+
+type WorkOrder {
+  id: Text
+  status: Text
+  createdAt: Date
+}
+
+screen Home {
+  title "Dashboard"
+  text "Welcome"
+}
+
+task closeOrder(id: Text) -> Bool {
+  require user.role is "admin"
+  say "Closing order"
+  return true
+}
+```
+
+## Targets
+
+| Target | Output |
+|---|---|
+| `vm` | ClearKrypt bytecode JSON |
+| `js` | JavaScript module |
+| `web` | HTML/CSS/JS app |
+| `worker` | Cloudflare Worker |
+
+## Launch Roadmap
+
+1. Stabilize grammar and AST.
+2. Add full type inference.
+3. Add package registry.
+4. Add Dart/Flutter and Swift/Kotlin emitters.
+5. Add native renderer bridge.
+6. Add WASM VM.
+7. Add LSP extension for VS Code.
+
+- [Layout and Styling](./LAYOUT_AND_STYLING.md)

package/docs/STDLIB.md

@@ -0,0 +1,74 @@
+# ClearKrypt Standard Library
+
+## `ui`
+
+Visual primitives:
+
+- `screen`
+- `title`
+- `text`
+- `button`
+- `card`
+- `glassCard`
+- `grid`
+- `stack`
+- `tabs`
+- `drawer`
+- `modal`
+- `form`
+- `input`
+- `table`
+- `chart`
+- `map`
+- `camera`
+- `scanner`
+- `animation`
+- `theme`
+
+## `cloud`
+
+Cloud abstractions:
+
+- `collection`
+- `document`
+- `query`
+- `save`
+- `delete`
+- `schedule`
+- `queue`
+- `secret`
+- `storage`
+- `email`
+- `sms`
+- `push`
+- `webhook`
+
+## `auth`
+
+- `user`
+- `role`
+- `permission`
+- `session`
+- `policy`
+- `require`
+
+## `device`
+
+- `camera`
+- `gps`
+- `nfc`
+- `bluetooth`
+- `accelerometer`
+- `secureStore`
+- `biometric`
+
+## `ops`
+
+Aviation/operations-oriented primitives can be added as packages:
+
+- `inspection`
+- `equipment`
+- `workOrder`
+- `shift`
+- `station`
+- `auditLog`

package/docs/VISUAL_STUDIO.md

@@ -0,0 +1,36 @@
+# ClearKrypt Visual Studio
+
+ClearKrypt includes a visual source editor for UI layout refinement.
+
+## Goal
+
+A developer can write normal ClearKrypt code, open the visual studio, drag visible UI nodes, and get deterministic code changes back in the `.ck` file.
+
+## How it works
+
+ClearKrypt UI lines may include layout metadata:
+
+```ck
+title "Dashboard" @pos(40, 80)
+text "Open work orders" @pos(40, 150)
+button "Create" @pos(40, 230) { go CreateReport }
+```
+
+The metadata is not a separate design file. It lives in source, so Git diffs, code review, and deterministic builds remain clean.
+
+## Commands
+
+```bash
+ck studio examples/fixit-dashboard/main.ck --out studio-preview
+```
+
+Open `studio-preview/index.html`.
+
+Drag a node. The source updates with a new `@pos(x, y)` value.
+
+## Design rules
+
+- Dragging never rewrites business logic.
+- Dragging only changes layout metadata.
+- The generated app and the visual editor both read from the same AST/source mapping.
+- This is crawler-friendly because the source remains text, not a binary design file.

package/docs-site/app.css

@@ -0,0 +1,3 @@
+
+:root{--bg:#050812;--panel:#0d1324;--panel2:#121a2d;--text:#f5f8ff;--muted:#a8b4cf;--line:rgba(255,255,255,.12);--cyan:#19d7ff;--blue:#2878ff;--violet:#8a3ffc;--orange:#ff9f16;--green:#38e8a6;--shadow:0 28px 90px rgba(0,0,0,.45)}
+*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;font-family:Inter,Segoe UI,Roboto,Arial,sans-serif;color:var(--text);background:radial-gradient(circle at 20% 0%,rgba(25,215,255,.16),transparent 30%),radial-gradient(circle at 80% 10%,rgba(138,63,252,.18),transparent 28%),linear-gradient(180deg,#04060c,#071021 55%,#050812);min-height:100vh}a{color:inherit;text-decoration:none}code,pre,textarea{font-family:ui-monospace,SFMono-Regular,Consolas,"Liberation Mono",monospace}.topbar{position:sticky;top:0;z-index:30;backdrop-filter:blur(18px);background:rgba(5,8,18,.76);border-bottom:1px solid var(--line)}.nav{max-width:1240px;margin:auto;display:flex;align-items:center;justify-content:space-between;padding:18px 22px}.brand{display:flex;gap:12px;align-items:center;font-weight:900;letter-spacing:-.03em}.brand img{width:46px;height:46px;object-fit:cover;border-radius:14px}.brand span{font-size:22px}.links{display:flex;gap:10px;flex-wrap:wrap}.links a,.btn{border:1px solid var(--line);background:rgba(255,255,255,.07);padding:12px 16px;border-radius:16px;font-weight:800;color:var(--text)}.links a:hover,.btn:hover{background:rgba(255,255,255,.12);transform:translateY(-1px)}.btn.primary{border:0;background:linear-gradient(135deg,var(--cyan),var(--blue),var(--violet));box-shadow:0 16px 45px rgba(40,120,255,.28)}.btn.orange{border:0;background:linear-gradient(135deg,#ffb13d,#ff8a00);color:#080b12}.hero{max-width:1240px;margin:auto;padding:74px 22px 46px;display:grid;grid-template-columns:1.08fr .92fr;gap:42px;align-items:center}.eyebrow{display:inline-flex;gap:8px;align-items:center;border:1px solid var(--line);background:rgba(255,255,255,.07);border-radius:999px;padding:9px 13px;color:#dce7ff;font-weight:800}.dot{width:9px;height:9px;border-radius:50%;background:var(--green);box-shadow:0 0 18px var(--green)}h1{font-size:clamp(48px,7vw,96px);line-height:.9;letter-spacing:-.075em;margin:20px 0 20px}h2{font-size:clamp(32px,4vw,58px);line-height:1;letter-spacing:-.05em;margin:0 0 20px}h3{font-size:24px;margin:0 0 10px}.lead{font-size:21px;line-height:1.55;color:var(--muted);max-width:760px}.actions{display:flex;gap:14px;flex-wrap:wrap;margin-top:28px}.logo-card{border:1px solid var(--line);border-radius:34px;background:linear-gradient(145deg,rgba(255,255,255,.09),rgba(255,255,255,.035));box-shadow:var(--shadow);padding:24px;overflow:hidden}.logo-card img{width:100%;max-height:430px;object-fit:contain;border-radius:26px;display:block;background:#02040a}.section{max-width:1240px;margin:auto;padding:58px 22px}.grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px}.card{border:1px solid var(--line);border-radius:28px;background:linear-gradient(145deg,rgba(255,255,255,.08),rgba(18,26,45,.78));padding:26px;box-shadow:0 20px 70px rgba(0,0,0,.22)}.card p{color:var(--muted);line-height:1.55;font-size:17px}.card.click{transition:.18s;display:block}.card.click:hover{border-color:rgba(25,215,255,.45);transform:translateY(-3px)}.pillrow{display:flex;gap:9px;flex-wrap:wrap;margin-top:16px}.pill{font-size:13px;color:#dce7ff;border:1px solid var(--line);border-radius:999px;padding:7px 10px;background:rgba(255,255,255,.06)}.code{background:#050914;border:1px solid rgba(135,165,255,.2);border-radius:22px;padding:18px;overflow:auto;color:#e8f1ff;line-height:1.6}.split{display:grid;grid-template-columns:1fr 1fr;gap:18px}.footer{border-top:1px solid var(--line);color:var(--muted);padding:32px 22px;text-align:center}.search{width:100%;border:1px solid var(--line);background:#070c18;color:white;border-radius:18px;padding:16px 18px;font-size:18px;margin:16px 0 24px}.doc-layout{max-width:1400px;margin:auto;display:grid;grid-template-columns:280px 1fr;gap:22px;padding:28px 22px}.toc{position:sticky;top:98px;align-self:start;border:1px solid var(--line);border-radius:24px;background:rgba(255,255,255,.055);padding:18px}.toc a{display:block;color:var(--muted);padding:9px;border-radius:12px}.toc a:hover{background:rgba(255,255,255,.08);color:white}.doc-main{min-width:0}.doc-section{border:1px solid var(--line);border-radius:26px;background:rgba(255,255,255,.055);padding:26px;margin-bottom:18px}.doc-section p,.doc-section li{color:#c6d2e9;font-size:17px;line-height:1.55}.sandbox{max-width:1400px;margin:auto;padding:28px 22px;display:grid;grid-template-columns:minmax(360px,.9fr) minmax(420px,1.1fr);gap:18px}.editor{width:100%;height:640px;background:#050914;color:#f6fbff;border:1px solid rgba(135,165,255,.25);border-radius:26px;padding:20px;font-size:16px;line-height:1.55;resize:vertical;outline:none}.preview{position:relative;min-height:640px;border:1px solid var(--line);border-radius:30px;background:radial-gradient(circle at 20% 30%,rgba(25,215,255,.12),transparent 28%),linear-gradient(145deg,#151a26,#0b1020);overflow:hidden;box-shadow:var(--shadow)}.draggable{position:absolute;cursor:grab;user-select:none;border:1px solid rgba(255,255,255,.16);background:rgba(255,255,255,.13);backdrop-filter:blur(10px);border-radius:20px;padding:14px 18px;min-width:200px}.draggable strong{display:block;color:white}.ck-button{background:linear-gradient(135deg,#ffb13d,#ff8a00);color:#090b10;font-weight:900;border:0;padding:14px 20px;border-radius:16px;display:inline-block}.hint{color:var(--muted);font-size:14px;margin-top:12px}.lesson{display:grid;grid-template-columns:90px 1fr auto;gap:16px;align-items:center}.badge-num{width:62px;height:62px;border-radius:20px;background:linear-gradient(135deg,var(--cyan),var(--violet));display:grid;place-items:center;font-weight:900;font-size:24px}.notice{border:1px solid rgba(56,232,166,.35);background:rgba(56,232,166,.08);color:#dfffee;border-radius:20px;padding:18px;margin:18px 0}@media(max-width:900px){.hero,.split,.sandbox,.doc-layout{grid-template-columns:1fr}.grid{grid-template-columns:1fr}.links{display:none}h1{font-size:52px}.logo-card img{max-height:290px}.toc{position:relative;top:0}.sandbox{padding:16px}.preview{min-height:520px}}

package/docs-site/app.js

@@ -0,0 +1,8 @@
+
+function q(s){return document.querySelector(s)}function qa(s){return [...document.querySelectorAll(s)]}
+function setupDocsSearch(){const input=q('#docSearch'); if(!input)return; const sections=qa('.doc-section'); input.addEventListener('input',()=>{const term=input.value.toLowerCase().trim(); sections.forEach(sec=>{sec.style.display=!term||sec.textContent.toLowerCase().includes(term)?'block':'none'})})}
+function parseItems(src){const out=[]; const re=/(title|text|button)\s+"([^"]+)"\s*(?:@pos\((\d+),\s*(\d+)\))?/g; let m; while((m=re.exec(src))){out.push({kind:m[1],label:m[2],x:+(m[3]||40+out.length*20),y:+(m[4]||50+out.length*82),start:m.index,end:re.lastIndex})} return out}
+function renderSandbox(){const ta=q('#ckCode'), prev=q('#preview'); if(!ta||!prev)return; prev.innerHTML=''; parseItems(ta.value).forEach((it,i)=>{const el=document.createElement('div'); el.className='draggable'; el.style.left=it.x+'px'; el.style.top=it.y+'px'; el.dataset.label=it.label; el.dataset.kind=it.kind; el.innerHTML=it.kind==='button'?`<span class="ck-button">${it.label}</span><div class="hint">button • drag me</div>`:`<strong>${it.kind}</strong><div>${it.label}</div><div class="hint">drag to update @pos</div>`; prev.appendChild(el); makeDrag(el, ta);});}
+function updatePosInCode(ta, kind, label, x, y){const esc=label.replace(/[.*+?^${}()|[\]\\]/g,'\\$&'); const re=new RegExp(`(${kind}\\s+"${esc}"\\s*)(?:@pos\\(\\d+,\\s*\\d+\\))?`); ta.value=ta.value.replace(re, `$1@pos(${x}, ${y})`)}
+function makeDrag(el, ta){let ox=0,oy=0,drag=false; el.addEventListener('pointerdown',e=>{drag=true; el.setPointerCapture(e.pointerId); ox=e.clientX-el.offsetLeft; oy=e.clientY-el.offsetTop; el.style.cursor='grabbing'}); el.addEventListener('pointermove',e=>{if(!drag)return; const parent=el.parentElement.getBoundingClientRect(); let x=Math.max(0,Math.min(parent.width-el.offsetWidth,e.clientX-ox)); let y=Math.max(0,Math.min(parent.height-el.offsetHeight,e.clientY-oy)); el.style.left=Math.round(x)+'px'; el.style.top=Math.round(y)+'px'}); el.addEventListener('pointerup',()=>{drag=false; el.style.cursor='grab'; updatePosInCode(ta, el.dataset.kind, el.dataset.label, parseInt(el.style.left), parseInt(el.style.top));});}
+window.addEventListener('DOMContentLoaded',()=>{setupDocsSearch(); renderSandbox(); const ta=q('#ckCode'); if(ta) ta.addEventListener('input',renderSandbox);});

package/docs-site/clearkrypt/app.css

@@ -0,0 +1,3 @@
+
+:root{--bg:#050812;--panel:#0d1324;--panel2:#121a2d;--text:#f5f8ff;--muted:#a8b4cf;--line:rgba(255,255,255,.12);--cyan:#19d7ff;--blue:#2878ff;--violet:#8a3ffc;--orange:#ff9f16;--green:#38e8a6;--shadow:0 28px 90px rgba(0,0,0,.45)}
+*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;font-family:Inter,Segoe UI,Roboto,Arial,sans-serif;color:var(--text);background:radial-gradient(circle at 20% 0%,rgba(25,215,255,.16),transparent 30%),radial-gradient(circle at 80% 10%,rgba(138,63,252,.18),transparent 28%),linear-gradient(180deg,#04060c,#071021 55%,#050812);min-height:100vh}a{color:inherit;text-decoration:none}code,pre,textarea{font-family:ui-monospace,SFMono-Regular,Consolas,"Liberation Mono",monospace}.topbar{position:sticky;top:0;z-index:30;backdrop-filter:blur(18px);background:rgba(5,8,18,.76);border-bottom:1px solid var(--line)}.nav{max-width:1240px;margin:auto;display:flex;align-items:center;justify-content:space-between;padding:18px 22px}.brand{display:flex;gap:12px;align-items:center;font-weight:900;letter-spacing:-.03em}.brand img{width:46px;height:46px;object-fit:cover;border-radius:14px}.brand span{font-size:22px}.links{display:flex;gap:10px;flex-wrap:wrap}.links a,.btn{border:1px solid var(--line);background:rgba(255,255,255,.07);padding:12px 16px;border-radius:16px;font-weight:800;color:var(--text)}.links a:hover,.btn:hover{background:rgba(255,255,255,.12);transform:translateY(-1px)}.btn.primary{border:0;background:linear-gradient(135deg,var(--cyan),var(--blue),var(--violet));box-shadow:0 16px 45px rgba(40,120,255,.28)}.btn.orange{border:0;background:linear-gradient(135deg,#ffb13d,#ff8a00);color:#080b12}.hero{max-width:1240px;margin:auto;padding:74px 22px 46px;display:grid;grid-template-columns:1.08fr .92fr;gap:42px;align-items:center}.eyebrow{display:inline-flex;gap:8px;align-items:center;border:1px solid var(--line);background:rgba(255,255,255,.07);border-radius:999px;padding:9px 13px;color:#dce7ff;font-weight:800}.dot{width:9px;height:9px;border-radius:50%;background:var(--green);box-shadow:0 0 18px var(--green)}h1{font-size:clamp(48px,7vw,96px);line-height:.9;letter-spacing:-.075em;margin:20px 0 20px}h2{font-size:clamp(32px,4vw,58px);line-height:1;letter-spacing:-.05em;margin:0 0 20px}h3{font-size:24px;margin:0 0 10px}.lead{font-size:21px;line-height:1.55;color:var(--muted);max-width:760px}.actions{display:flex;gap:14px;flex-wrap:wrap;margin-top:28px}.logo-card{border:1px solid var(--line);border-radius:34px;background:linear-gradient(145deg,rgba(255,255,255,.09),rgba(255,255,255,.035));box-shadow:var(--shadow);padding:24px;overflow:hidden}.logo-card img{width:100%;max-height:430px;object-fit:contain;border-radius:26px;display:block;background:#02040a}.section{max-width:1240px;margin:auto;padding:58px 22px}.grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px}.card{border:1px solid var(--line);border-radius:28px;background:linear-gradient(145deg,rgba(255,255,255,.08),rgba(18,26,45,.78));padding:26px;box-shadow:0 20px 70px rgba(0,0,0,.22)}.card p{color:var(--muted);line-height:1.55;font-size:17px}.card.click{transition:.18s;display:block}.card.click:hover{border-color:rgba(25,215,255,.45);transform:translateY(-3px)}.pillrow{display:flex;gap:9px;flex-wrap:wrap;margin-top:16px}.pill{font-size:13px;color:#dce7ff;border:1px solid var(--line);border-radius:999px;padding:7px 10px;background:rgba(255,255,255,.06)}.code{background:#050914;border:1px solid rgba(135,165,255,.2);border-radius:22px;padding:18px;overflow:auto;color:#e8f1ff;line-height:1.6}.split{display:grid;grid-template-columns:1fr 1fr;gap:18px}.footer{border-top:1px solid var(--line);color:var(--muted);padding:32px 22px;text-align:center}.search{width:100%;border:1px solid var(--line);background:#070c18;color:white;border-radius:18px;padding:16px 18px;font-size:18px;margin:16px 0 24px}.doc-layout{max-width:1400px;margin:auto;display:grid;grid-template-columns:280px 1fr;gap:22px;padding:28px 22px}.toc{position:sticky;top:98px;align-self:start;border:1px solid var(--line);border-radius:24px;background:rgba(255,255,255,.055);padding:18px}.toc a{display:block;color:var(--muted);padding:9px;border-radius:12px}.toc a:hover{background:rgba(255,255,255,.08);color:white}.doc-main{min-width:0}.doc-section{border:1px solid var(--line);border-radius:26px;background:rgba(255,255,255,.055);padding:26px;margin-bottom:18px}.doc-section p,.doc-section li{color:#c6d2e9;font-size:17px;line-height:1.55}.sandbox{max-width:1400px;margin:auto;padding:28px 22px;display:grid;grid-template-columns:minmax(360px,.9fr) minmax(420px,1.1fr);gap:18px}.editor{width:100%;height:640px;background:#050914;color:#f6fbff;border:1px solid rgba(135,165,255,.25);border-radius:26px;padding:20px;font-size:16px;line-height:1.55;resize:vertical;outline:none}.preview{position:relative;min-height:640px;border:1px solid var(--line);border-radius:30px;background:radial-gradient(circle at 20% 30%,rgba(25,215,255,.12),transparent 28%),linear-gradient(145deg,#151a26,#0b1020);overflow:hidden;box-shadow:var(--shadow)}.draggable{position:absolute;cursor:grab;user-select:none;border:1px solid rgba(255,255,255,.16);background:rgba(255,255,255,.13);backdrop-filter:blur(10px);border-radius:20px;padding:14px 18px;min-width:200px}.draggable strong{display:block;color:white}.ck-button{background:linear-gradient(135deg,#ffb13d,#ff8a00);color:#090b10;font-weight:900;border:0;padding:14px 20px;border-radius:16px;display:inline-block}.hint{color:var(--muted);font-size:14px;margin-top:12px}.lesson{display:grid;grid-template-columns:90px 1fr auto;gap:16px;align-items:center}.badge-num{width:62px;height:62px;border-radius:20px;background:linear-gradient(135deg,var(--cyan),var(--violet));display:grid;place-items:center;font-weight:900;font-size:24px}.notice{border:1px solid rgba(56,232,166,.35);background:rgba(56,232,166,.08);color:#dfffee;border-radius:20px;padding:18px;margin:18px 0}@media(max-width:900px){.hero,.split,.sandbox,.doc-layout{grid-template-columns:1fr}.grid{grid-template-columns:1fr}.links{display:none}h1{font-size:52px}.logo-card img{max-height:290px}.toc{position:relative;top:0}.sandbox{padding:16px}.preview{min-height:520px}}

package/docs-site/clearkrypt/app.js

@@ -0,0 +1,8 @@
+
+function q(s){return document.querySelector(s)}function qa(s){return [...document.querySelectorAll(s)]}
+function setupDocsSearch(){const input=q('#docSearch'); if(!input)return; const sections=qa('.doc-section'); input.addEventListener('input',()=>{const term=input.value.toLowerCase().trim(); sections.forEach(sec=>{sec.style.display=!term||sec.textContent.toLowerCase().includes(term)?'block':'none'})})}
+function parseItems(src){const out=[]; const re=/(title|text|button)\s+"([^"]+)"\s*(?:@pos\((\d+),\s*(\d+)\))?/g; let m; while((m=re.exec(src))){out.push({kind:m[1],label:m[2],x:+(m[3]||40+out.length*20),y:+(m[4]||50+out.length*82),start:m.index,end:re.lastIndex})} return out}
+function renderSandbox(){const ta=q('#ckCode'), prev=q('#preview'); if(!ta||!prev)return; prev.innerHTML=''; parseItems(ta.value).forEach((it,i)=>{const el=document.createElement('div'); el.className='draggable'; el.style.left=it.x+'px'; el.style.top=it.y+'px'; el.dataset.label=it.label; el.dataset.kind=it.kind; el.innerHTML=it.kind==='button'?`<span class="ck-button">${it.label}</span><div class="hint">button • drag me</div>`:`<strong>${it.kind}</strong><div>${it.label}</div><div class="hint">drag to update @pos</div>`; prev.appendChild(el); makeDrag(el, ta);});}
+function updatePosInCode(ta, kind, label, x, y){const esc=label.replace(/[.*+?^${}()|[\]\\]/g,'\\$&'); const re=new RegExp(`(${kind}\\s+"${esc}"\\s*)(?:@pos\\(\\d+,\\s*\\d+\\))?`); ta.value=ta.value.replace(re, `$1@pos(${x}, ${y})`)}
+function makeDrag(el, ta){let ox=0,oy=0,drag=false; el.addEventListener('pointerdown',e=>{drag=true; el.setPointerCapture(e.pointerId); ox=e.clientX-el.offsetLeft; oy=e.clientY-el.offsetTop; el.style.cursor='grabbing'}); el.addEventListener('pointermove',e=>{if(!drag)return; const parent=el.parentElement.getBoundingClientRect(); let x=Math.max(0,Math.min(parent.width-el.offsetWidth,e.clientX-ox)); let y=Math.max(0,Math.min(parent.height-el.offsetHeight,e.clientY-oy)); el.style.left=Math.round(x)+'px'; el.style.top=Math.round(y)+'px'}); el.addEventListener('pointerup',()=>{drag=false; el.style.cursor='grab'; updatePosInCode(ta, el.dataset.kind, el.dataset.label, parseInt(el.style.left), parseInt(el.style.top));});}
+window.addEventListener('DOMContentLoaded',()=>{setupDocsSearch(); renderSandbox(); const ta=q('#ckCode'); if(ta) ta.addEventListener('input',renderSandbox);});

package/docs-site/clearkrypt/index.html

@@ -0,0 +1,44 @@
+<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>ClearKrypt Docs</title><meta name="description" content="ClearKrypt cross-platform programming language."><link rel="stylesheet" href="/app.css"><script defer src="/app.js"></script></head><body><header class="topbar"><nav class="nav"><a class="brand" href="/"><img src="/assets/clearkrypt-logo.png" alt="ClearKrypt logo"><span>ClearKrypt</span></a><div class="links"><a href="/sandbox/">Sandbox</a><a href="/extensions/">Extensions</a><a href="/docs/">Docs</a><a href="/compiler/">Compiler</a><a href="/course/">Course</a></div></nav></header><main class="doc-layout"><aside class="toc"><strong>Docs</strong><input id="docSearch" class="search" placeholder="Search docs..."><a href="#start">Getting Started</a><a href="#syntax">Core Syntax</a><a href="#ui">UI and Layout</a><a href="#data">Data and Queries</a><a href="#tasks">Tasks and Intents</a><a href="#platforms">Platform Targets</a><a href="#stdlib">Standard Libraries</a><a href="#ai">AI and Crawler Support</a></aside><article class="doc-main"><h1>ClearKrypt Documentation</h1><p class="lead">A complete beginner-first reference for a brand-new language: syntax, layout, data, tasks, compiler targets, standard libraries, examples, and AI crawler support.</p><section id="start" class="doc-section"><h2>Getting Started</h2><p>ClearKrypt projects start with an app declaration, imports, typed models, screens, tasks, and platform targets.</p><pre class="code"><code>app "Inventory"
+use ui
+use data
+
+screen Home {
+  title "Inventory" @pos(40, 40)
+  button "Add Item" @pos(40, 120) { go AddItem }
+}</code></pre></section><section id="syntax" class="doc-section"><h2>Core Syntax</h2><p>ClearKrypt uses readable blocks, strong typing, no semicolons, and app-first keywords.</p><pre class="code"><code>type WorkOrder {
+  id: Text
+  equipmentId: Number
+  status: Text
+  createdAt: Date
+}
+
+let order = WorkOrder { id: newId(), equipmentId: 4421, status: "open", createdAt: now() }</code></pre></section><section id="ui" class="doc-section"><h2>UI and Layout</h2><p>Visual elements can include @pos metadata. Dragging in the studio updates source code one-to-one.</p><pre class="code"><code>screen Dashboard {
+  title "Dashboard" @pos(40, 40)
+  text "Open reports" @pos(40, 105)
+  button "Review" @pos(40, 170) { go Reports }
+}</code></pre></section><section id="data" class="doc-section"><h2>Data and Queries</h2><p>ClearKrypt treats data as typed collections and queryable resources.</p><pre class="code"><code>data reports = from firestore "reports"
+  where status is not "closed"
+  sort createdAt desc
+  limit 50</code></pre></section><section id="tasks" class="doc-section"><h2>Tasks and Intents</h2><p>Tasks are callable functions. Intents are event-driven workflows for app automation.</p><pre class="code"><code>task closeReport(id: Text) -> Bool {
+  require user.role in ["admin", "tech"]
+  update firestore "reports" id { status: "closed" }
+  return true
+}
+
+intent "notify when equipment returns" {
+  when equipment.status changes to "green" {
+    notify station users message "Equipment returned to service"
+  }
+}</code></pre></section><section id="platforms" class="doc-section"><h2>Platform Targets</h2><p>The compiler exports web, phone, PC, worker, and JS outputs without AI translation.</p><pre class="code"><code>ck build app/main.ck --target web --out dist/web
+ck build app/main.ck --target phone --out dist/phone
+ck build app/main.ck --target pc --out dist/pc
+ck build app/main.ck --target worker --out dist/worker
+ck build-all app/main.ck --out dist</code></pre></section><section id="stdlib" class="doc-section"><h2>Standard Libraries</h2><p>Core libraries include ui, data, cloud, auth, device, net, crypto, forms, charts, maps, storage, and notifications.</p><pre class="code"><code>use ui
+use auth
+use cloud
+use device.camera
+use notifications</code></pre></section><section id="ai" class="doc-section"><h2>AI and Crawler Support</h2><p>ClearKrypt sites publish llms.txt, sitemap.xml, robots.txt, ai-index.json, examples, and stable docs pages so AI tools can learn syntax.</p><pre class="code"><code>/llms.txt
+/sitemap.xml
+/docs/
+/examples/
+/.well-known/clearkrypt.json</code></pre></section></article></main><footer class="footer">ClearKrypt • write once, build everywhere • <a href="/llms.txt">llms.txt</a></footer></body></html>

package/examples/fixit-dashboard/main.ck

@@ -0,0 +1,29 @@
+app "FixIt QC ClearKrypt Demo"
+use ui
+use cloud
+use auth
+
+type WorkOrder {
+  id: Text
+  equipmentId: Text
+  status: Text
+  priority: Text
+}
+
+screen Home {
+  title "FixIt QC"
+  card {
+    text "Equipment, work orders, reports, and admin tools from one ClearKrypt codebase."
+    button "Open Dashboard" {
+      say "Opening dashboard"
+    }
+  }
+}
+
+task canEdit(role: Text) -> Bool {
+  when role is "admin" {
+    return true
+  } otherwise {
+    return false
+  }
+}

package/examples/light-test-app/main.ck

@@ -0,0 +1,38 @@
+app "ClearKrypt Test App"
+
+use ui
+use data
+use storage
+
+type Task {
+  id: Text
+  title: Text
+  done: Boolean
+}
+
+store local tasks as List<Task> default [
+  Task { id: "1", title: "Learn ClearKrypt basics", done: false },
+  Task { id: "2", title: "Build a styled app", done: false }
+]
+
+screen Home {
+  layout Stack
+
+  title "ClearKrypt Test App"
+  text "A light app to test automatic layout, local data, actions, and styling."
+
+  button "Add Test Task" {
+    add Task {
+      id: newId()
+      title: "New task from ClearKrypt"
+      done: false
+    } to tasks
+  }
+
+  list tasks as task {
+    card {
+      text task.title
+      toggle task.done
+    }
+  }
+}

package/examples/momeants-mini/main.ck

@@ -0,0 +1,19 @@
+app "Momeants Mini"
+use ui
+use cloud
+
+type Moment {
+  id: Text
+  imageUrl: Text
+  caption: Text
+}
+
+screen Home {
+  title "Momeants"
+  card {
+    text "One photo. One feeling. One moment at a time."
+    button "Super Like" {
+      say "Golden frame animation"
+    }
+  }
+}

package/llms.txt

@@ -0,0 +1,18 @@
+# ClearKrypt
+
+ClearKrypt is a deterministic cross-platform application programming language.
+
+Use ClearKrypt to generate web, phone, desktop, Cloudflare Worker, JavaScript, and VM bytecode outputs.
+
+Canonical docs:
+- docs/LANGUAGE_SPEC.md
+- docs/STDLIB.md
+- docs/PLATFORM_TARGETS.md
+- docs/VISUAL_STUDIO.md
+- docs/AI_CRAWLER_GUIDE.md
+
+Important syntax:
+app "Name"
+use ui
+screen Home { title "Hello" button "Go" { go Next } }
+task add(a: Number, b: Number) -> Number { return a + b }