kadence-lang 0.2.0 → 0.2.2

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/kadence-lang.svg?style=flat-square)](https://www.npmjs.com/package/kadence-lang)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Build Status](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square)](https://github.com/kadence-lang/kadence-lang)
+[![Build Status](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square)](https://github.com/Down2EarthGG/Kadence-lang)
 
 **A human-readable programming language that feels like poetry.**
 
@@ -135,22 +135,32 @@ Kadence ships with a comprehensive set of modules for common tasks.
 
 | Module | Core Functionality |
 | :--- | :--- |
-| `list` | `first`, `lastOf`, `shuffle`, `range`, `unique` |
-| `string` | `trimmed`, `repeated`, `toCamelCase`, `padStart`, `words` |
-| `math` | `clamp`, `randomFloat`, `toRadians`, `hypotenuse` |
-| `datetime` | `the time now`, `the date today`, `diffDays`, `toIso` |
-| `file` | `readFile`, `writeFile`, `copyDir`, `removeDir`, `stat` |
+| `array` | `flatten`, `zip`, `chunk`, `partition`, `take`, `drop`, `reverse`, `findIndex` |
+| `async` | `delay`, `timeout`, `retry`, `debounce`, `throttle`, `parallel`, `sequential`, `waterfall` |
+| `list` | `first`, `lastOf`, `shuffle`, `makeRange`, `unique`, `sort`, `sortBy` |
+| `string` | `trimmed`, `repeated`, `toCamelCase`, `padStart`, `words`, `lines`, `capitalized` |
+| `map` | `keys`, `values`, `entries`, `merge`, `pick`, `omit`, `mapValues`, `deepClone`, `fromPairs` |
+| `set` | `union`, `intersection`, `difference`, `isSubset`, `isSuperset`, `cartesianProduct` |
+| `format` | `currency`, `fileSize`, `ordinal`, `plural`, `titleCase`, `snakeCase`, `kebabCase` |
+| `validation` | `isEmail`, `isUrl`, `isNumeric`, `isAlpha`, `isInRange`, `isHexColor`, `isCreditCard` |
+| `math` | `clamp`, `randomFloat`, `hypotenuse`, `areaOfCircle`, `isEven`, `toRadians` |
+| `datetime` | `currentTime`, `today`, `year`, `month`, `day`, `toIso`, `addDays` |
+| `file` | `readFile`, `writeFile`, `copyDir`, `removeDir`, `stat`, `listDir`, `exists` |
 | `path` | `joinPaths`, `resolve`, `basename`, `dirname`, `extension` |
-| `env` | `getEnv`, `hasEnv` (Environment Variables) |
+| `env` | `getEnv`, `hasEnv` |
 | `process` | `args`, `exit`, `cwd` |
-| `system` | `platform`, `arch`, `totalMemory`, `freeMemory` |
-| `network` | `serve`, `fetchJson` (Simple HTTP Server) |
+| `system` | `platform`, `arch`, `totalMemory`, `freeMemory`, `cpus`, `homedir` |
+| `network` | `serve`, `fetchJson` |
 | `json` | `readJson`, `writeJson`, `format`, `parseSafe` |
-| `check` | `isNumber`, `isString`, `isEmail`, `between` |
+| `check` | `isNumber`, `isString`, `isEmail`, `between`, `coalesce` |
 | `test` | `suite`, `assertEquals`, `assertTrue`, `assertThrows` |
-| `color` | `randomHex`, `rgbToHex`, `hexToRgb` |
-| `html` | `div`, `span`, `p`, `img`, `link` (Browser only) |
-| `crypto` | `hash`, `randomBytes`, `uuid` |
+| `color` | `rgb`, `rgba`, `hex`, `randomHex` |
+| `html` | `tag`, `div`, `span`, `p`, `img`, `link`, `h1` |
+| `crypto` | `hash`, `randomBytes` |
+| `uuid` | `v4`, `validate` |
+| `random` | `float`, `integer`, `choice`, `shuffle` |
+| `stream` | `createReader`, `readAll`, `pipe` |
+| `url` | `parseUrl`, `buildUrl`, `getSearchParam` |
 
 *Usage Example:*
 ```kadence

package/bin/kadence.js

@@ -5,7 +5,7 @@ const readline = require("readline");
 const { execSync } = require("child_process");
 const { compile } = require("../src/compiler");
 
-const VERSION = "0.2.0";
+const VERSION = "0.2.2";
 
 const colors = {
   reset: "\x1b[0m",
@@ -34,26 +34,32 @@ function getPkgName(pkg) {
 
 function printHelp() {
   log(`Kadence CLI v${VERSION}`, colors.bright + colors.cyan);
+  log("A human-readable programming language that feels like poetry", colors.dim);
   console.log(`
 Usage:
+  npx kadence-lang [command] [options]
+
+Core Commands:
   kadence                Start interactive REPL
   kadence <file>         Compile and run a .kade file
   kadence -c <file>      Compile to JavaScript only
-  kadence -c <file> -o <out> --target browser   Compile for browser (no Node APIs)
-  kadence -c <file> -o <out> --sourcemap        Emit source map for debugging
-  kadence create <name> [--web] [--yes]  Create project folder and run npm install
-  kadence init [--web]    Initialize a new project in current directory
-  kadence install <pkg>  Install a package (npm/github)
-  kadence uninstall <pkg> Remove a package
-  kadence update         Update all dependencies
-  kadence list           List installed packages
-  kadence run <script>   Run a script from kadence.json
-  kadence build         Compile all .kade files in project
-  kadence test          Run all .test.kade files
-  kadence docs          Generate documentation from comments
-  kadence dev           Start Vite development server
-  kadence -v             Show version
-  kadence help           Show this help
+  
+Project Commands:
+  kadence create <name> [--web]  Create a new project from a template
+  kadence init [--web]           Initialize Kadence in existing folder
+  kadence dev                    Start Vite development server (Web only)
+  kadence build                  Compile all .kade files in project
+  kadence test                   Run all .test.kade files
+  
+Package Management:
+  kadence install <pkg>          Install a package (kadence or npm)
+  kadence uninstall <pkg>        Remove a package
+  kadence update                 Update all dependencies
+  kadence list                   List installed packages
+
+Other Options:
+  kadence -v                     Show version
+  kadence help                   Show this help
     `);
 }
 
@@ -138,7 +144,7 @@ function writeScaffold(targetDir, opts) {
   const config = {
     name: projectName,
     version: version || "1.0.0",
-    description: description || "",
+    description: description || "A beautiful Kadence project",
     author: author || "",
     scripts: isWeb
       ? { dev: "kadence dev", build: "kadence build --web", preview: "vite preview" }
@@ -148,19 +154,97 @@ function writeScaffold(targetDir, opts) {
 
   const mainKade = path.join(targetDir, "src", "main.kade");
   if (!fs.existsSync(mainKade)) {
-    fs.writeFileSync(mainKade, "// Welcome to your new Kadence project!\nsay \"Hello, World!\"\n", "utf8");
+    if (isWeb) {
+      fs.writeFileSync(
+        mainKade,
+        `// Welcome to your new Kadence Web App!
+say "Kadence is running!"
+
+// Simple reactive counter example
+let count = 0
+
+function increment() {
+    count = count + 1
+    updateUI()
+}
+
+function updateUI() {
+    const el = document.getElementById("counter")
+    if el {
+        el.innerText = "Count: " + count
+    }
+}
+
+// Initialize
+updateUI()
+
+// Expose increment to window for button clicks
+window.increment = increment
+`,
+        "utf8"
+      );
+    } else {
+      fs.writeFileSync(
+        mainKade,
+        `// Welcome to your new Kadence Tool!
+import math
+
+say "Hello from Kadence!"
+say "The square root of 144 is " + math.sqrt(144)
+
+// Try running with: kadence src/main.kade
+`,
+        "utf8"
+      );
+    }
   }
 
   const gitignore = path.join(targetDir, ".gitignore");
   if (!fs.existsSync(gitignore)) {
-    fs.writeFileSync(gitignore, "node_modules/\ndist/\n*.js\n*.js.map\n", "utf8");
+    fs.writeFileSync(gitignore, "node_modules/\ndist/\n*.js\n*.js.map\n.DS_Store\n", "utf8");
+  }
+
+  const readme = path.join(targetDir, "README.md");
+  if (!fs.existsSync(readme)) {
+    fs.writeFileSync(
+      readme,
+      `# ${projectName}
+
+${description || "A new Kadence project."}
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. Start the project:
+   \`\`\`bash
+   ${isWeb ? "npm run dev" : "npm run start"}
+   \`\`\`
+
+## Project Structure
+
+- \`src/\`: Source files (.kade)
+- \`dist/\`: Compiled JavaScript
+- \`kadence.json\`: Kadence project configuration
+`,
+      "utf8"
+    );
   }
 
   const kadenceConfig = path.join(targetDir, "kadence.config.js");
   if (!fs.existsSync(kadenceConfig)) {
     fs.writeFileSync(
       kadenceConfig,
-      "/** @type {import('kadence-lang').Config} */\nmodule.exports = {\n  outDir: 'dist',\n  srcDir: 'src',\n  target: 'node'\n};\n",
+      `/** @type {import('kadence-lang').Config} */
+module.exports = {
+  outDir: 'dist',
+  srcDir: 'src',
+  target: '${isWeb ? "browser" : "node"}'
+};
+`,
       "utf8"
     );
   }
@@ -172,11 +256,13 @@ function writeScaffold(targetDir, opts) {
     const pkg = {
       name: projectName,
       version: version || "1.0.0",
+      description: description || "",
       type: "commonjs",
-      dependencies: { "kadence-lang": "latest" },
+      scripts: config.scripts,
+      dependencies: { "kadence-lang": "^0.2.1" },
     };
     if (isWeb) {
-      pkg.devDependencies = { vite: "latest", "vite-plugin-kadence": "latest" };
+      pkg.devDependencies = { vite: "latest", "vite-plugin-kadence": "^0.2.1" };
     }
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
   }
@@ -187,18 +273,146 @@ function writeScaffold(targetDir, opts) {
       fs.writeFileSync(
         indexHtml,
         `<!DOCTYPE html>
-<html>
+<html lang="en">
 <head>
-    <title>${projectName}</title>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${projectName} | Kadence</title>
+    <link rel="stylesheet" href="/src/style.css">
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;600&display=swap" rel="stylesheet">
 </head>
 <body>
-    <div id="app"></div>
+    <div class="container">
+        <header>
+            <div class="logo">♪</div>
+            <h1>${projectName}</h1>
+            <p class="subtitle">Built with Kadence</p>
+        </header>
+        
+        <main>
+            <div class="card">
+                <h2 id="counter">Count: 0</h2>
+                <button onclick="increment()">Increment</button>
+            </div>
+            
+            <div class="info">
+                <p>Edit <code>src/main.kade</code> to get started.</p>
+            </div>
+        </main>
+    </div>
     <script type="module" src="/src/main.kade"></script>
 </body>
 </html>`,
         "utf8"
       );
     }
+
+    const styleCss = path.join(targetDir, "src", "style.css");
+    if (!fs.existsSync(styleCss)) {
+      fs.writeFileSync(
+        styleCss,
+        `body {
+    margin: 0;
+    padding: 0;
+    font-family: 'Outfit', sans-serif;
+    background: radial-gradient(circle at top right, #1a1a2e, #0f0f1b);
+    color: white;
+    min-height: 100vh;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+}
+
+.container {
+    text-align: center;
+    max-width: 600px;
+    padding: 2rem;
+}
+
+header {
+    margin-bottom: 3rem;
+}
+
+.logo {
+    font-size: 4rem;
+    margin-bottom: 1rem;
+    background: linear-gradient(135deg, #00f2fe 0%, #4facfe 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+}
+
+h1 {
+    font-weight: 600;
+    font-size: 2.5rem;
+    margin: 0;
+}
+
+.subtitle {
+    color: #94a3b8;
+    font-size: 1.1rem;
+    margin-top: 0.5rem;
+}
+
+.card {
+    background: rgba(255, 255, 255, 0.05);
+    backdrop-filter: blur(10px);
+    border: 1px solid rgba(255, 255, 255, 0.1);
+    padding: 2.5rem;
+    border-radius: 24px;
+    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.5);
+    margin-bottom: 2rem;
+    transition: transform 0.3s ease;
+}
+
+.card:hover {
+    transform: translateY(-5px);
+}
+
+h2 {
+    font-size: 2rem;
+    margin-bottom: 1.5rem;
+}
+
+button {
+    background: linear-gradient(135deg, #4facfe 0%, #00f2fe 100%);
+    border: none;
+    color: white;
+    padding: 0.75rem 2rem;
+    font-size: 1.1rem;
+    font-weight: 600;
+    border-radius: 12px;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    box-shadow: 0 10px 15px -3px rgba(79, 172, 254, 0.3);
+}
+
+button:hover {
+    transform: scale(1.05);
+    box-shadow: 0 20px 25px -5px rgba(79, 172, 254, 0.4);
+}
+
+button:active {
+    transform: scale(0.98);
+}
+
+.info {
+    color: #64748b;
+    font-size: 0.9rem;
+}
+
+code {
+    background: rgba(255, 255, 255, 0.1);
+    padding: 0.2rem 0.4rem;
+    border-radius: 4px;
+    color: #e2e8f0;
+}
+`,
+        "utf8"
+      );
+    }
+
     const viteConfig = path.join(targetDir, "vite.config.js");
     if (!fs.existsSync(viteConfig)) {
       fs.writeFileSync(
@@ -207,7 +421,11 @@ function writeScaffold(targetDir, opts) {
 import { kadencePlugin } from './vite-plugin-kadence';
 
 export default defineConfig({
-  plugins: [kadencePlugin()]
+  plugins: [kadencePlugin()],
+  server: {
+    port: 3000,
+    open: true
+  }
 });`,
         "utf8"
       );

package/icon.svg

@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="utf-8"?>
+<svg width="512" height="512" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <!-- Premium Dark Gradient Background -->
+    <linearGradient id="bgGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1a1a2e;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#16213e;stop-opacity:1" />
+    </linearGradient>
+    
+    <!-- Vibrant Accent Gradient (vertical) -->
+    <linearGradient id="accentGradient" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#06d6a0;stop-opacity:1" />
+      <stop offset="50%" style="stop-color:#118ab2;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#7b2cbf;stop-opacity:1" />
+    </linearGradient>
+    
+    <!-- Outer Glow Effect -->
+    <filter id="glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="6" result="coloredBlur"/>
+      <feMerge>
+        <feMergeNode in="coloredBlur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    
+    <!-- Subtle Drop Shadow -->
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="4" stdDeviation="10" flood-color="#000000" flood-opacity="0.3"/>
+    </filter>
+  </defs>
+
+  <!-- Background Container with Rounded Corners -->
+  <rect x="24" y="24" width="464" height="464" rx="96" fill="url(#bgGradient)" filter="url(#shadow)"/>
+  
+  <!-- Subtle Border Ring -->
+  <rect x="24" y="24" width="464" height="464" rx="96" fill="none" stroke="url(#accentGradient)" stroke-width="3" opacity="0.4"/>
+
+  <!-- Rebuilt, unified Kadence "K" -->
+  <g filter="url(#glow)">
+    <!-- Single sculpted K shape using negative space logic -->
+    <path
+      d="
+        M 120 116
+        L 160 116
+        L 160 220
+        L 230 160
+        Q 244 148 262 148
+        L 292 148
+        L 292 188
+        Q 276 188 266 196
+        L 200 252
+        L 270 320
+        Q 284 334 304 334
+        L 332 334
+        L 332 374
+        L 296 374
+        Q 270 374 252 356
+        L 180 286
+        L 160 304
+        L 160 396
+        L 120 396
+        Z
+      "
+      fill="url(#accentGradient)"
+    />
+
+    <!-- Accent rhythm bars to the right -->
+    <rect x="320" y="196" width="24" height="120" rx="12" fill="#06d6a0" opacity="0.9"/>
+    <rect x="360" y="161" width="24" height="190" rx="12" fill="#118ab2" opacity="0.85"/>
+    <rect x="400" y="216" width="24" height="80" rx="12" fill="#7b2cbf" opacity="0.8"/>
+  </g>
+  
+  <!-- Small accent dots for visual interest -->
+  <circle cx="420" cy="100" r="8" fill="#06d6a0" opacity="0.6"/>
+  <circle cx="100" cy="420" r="6" fill="#7b2cbf" opacity="0.5"/>
+</svg>

package/package.json

@@ -1,25 +1,28 @@
 {
   "name": "kadence-lang",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A human-readable programming language that feels like poetry",
+  "icon": "icon.svg",
   "main": "src/compiler.js",
   "bin": {
-    "kadence": "./bin/kadence.js"
+    "kadence": "./bin/kadence.js",
+    "kadence-lang": "./bin/kadence.js"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kadence-lang/kadence-lang.git"
+    "url": "git+https://github.com/Down2EarthGG/Kadence-lang.git"
   },
   "bugs": {
-    "url": "https://github.com/kadence-lang/kadence-lang/issues"
+    "url": "https://github.com/Down2EarthGG/Kadence-lang/issues"
   },
-  "homepage": "https://github.com/kadence-lang/kadence-lang#readme",
+  "homepage": "https://github.com/Down2EarthGG/Kadence-lang#readme",
   "files": [
     "src/",
     "bin/",
     "stdlib/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "icon.svg"
   ],
   "engines": {
     "node": ">=14.0.0"
@@ -28,9 +31,9 @@
     "dev": "npm run serve:demo",
     "demo": "npm run serve:demo",
     "build:demo": "node scripts/build-demo.js",
-    "serve:demo": "npm run build:demo && serve . -p 3000",
+    "serve:demo": "npm run build:demo && serve apps/website -p 3000",
     "build:apps": "node scripts/build-apps.js",
-    "serve:apps": "npm run build:apps && serve . -p 3000",
+    "serve:apps": "npm run build:apps && serve apps/website -p 3000",
     "test": "vitest run",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
@@ -48,10 +51,7 @@
   "author": "The Kadence Team",
   "license": "MIT",
   "dependencies": {
-    "lodash": "^4.17.23",
     "ohm-js": "^17.3.0",
-    "readline-sync": "^1.4.10",
-    "safe-eval": "^0.4.1",
     "source-map": "^0.7.4"
   },
   "devDependencies": {

package/stdlib/REVIEW_NEW_LIBS.md

@@ -0,0 +1,92 @@
+# Review: New stdlib Libraries
+
+Summary of the new/untracked stdlib modules and fixes applied.
+
+---
+
+## 1. **array.kade** ✓
+
+Pure Kadence array utilities: `flatten`, `zip`, `chunk`, `partition`, `take`, `drop`, `reverse`, `findIndex`.
+
+- **Style**: Uses `list`, `add … to result`, `size of`, `increment`/`decrement` consistently.
+- **Note**: `flatten` treats any `elem` with `typeof "object"` and `elem.length` as nested array; that matches array-like values. Consider documenting that only one level of “array-like” is assumed if you want to avoid surprises with non-Array objects.
+
+---
+
+## 2. **async.kade** + **async-helpers.js** ✓
+
+Kadence wrapper over JS helpers: `delay`, `timeout`, `retry`, `debounce`, `throttle`, `parallel`, `race`, `sequential`, `waterfall`, `batch`.
+
+- **Pattern**: Same as other `.kade` + `-helpers.js` pairs: Kadence exports call `run require "./async-helpers.js"` and `run mod.<name> …`.
+- **async-helpers.js**: Clear, no extra dependencies; `batch` expects `processFn(batchItems)` to return an array of results.
+- **async.js**: Generated output; contains leftover `__kadence_*` and `fs` at the top. Prefer regenerating from `async.kade` or trimming the stub so only the actual exports remain.
+
+---
+
+## 3. **format.kade** + **format-helpers.js** ✓ (ordinal fixed)
+
+Formatting: `currency`, `formatNumber`, `percentage`, `fileSize`, `ordinal`, `plural`, `truncate`, `ellipsis`, `padNumber`, `phoneNumber`, `titleCase`, `snakeCase`, `kebabCase`.
+
+- **ordinal**: Logic was wrong for both remainder and 11/12/13. Updated to use `floor` for integer-like behavior and to treat 11–13 correctly (e.g. 11th, 12th, 13th, 21st, 22nd).
+- **format-helpers.js**: Only `currency` and `phoneNumber`; used via `require`. Fine as-is.
+- **titleCase**: Uses `split`/`join`/`uppercase`/`lowercase`; consistent with language reference.
+
+---
+
+## 4. **map.kade** + **map.js** + **object-helpers.js** ✓
+
+Map/object utilities: `keys`, `values`, `entries`, `hasKey`, `merge`, `pick`, `omit`, `mapValues`, `mapKeys`, `invert`, `isEmpty`, `fromPairs`.
+
+- **map.kade**: Delegates to `object-helpers.js` for everything except `isEmpty` (uses `Object.keys`) and `fromPairs` (inline loop). Good split.
+- **object-helpers.js**: Provides `pick`, `omit`, `deepClone`, `get`, `defaults`, plus key/values/entries/hasKey/merge/mapValues/mapKeys/invert. `map.kade` does not yet expose `deepClone`, `get`, or `defaults`; add wrappers in `map.kade` if you want them in the public API.
+- **fromPairs**: Uses `let result = {}` and `result[pair[0]] = pair[1]`. For consistency with LANGUAGE_REFERENCE (“Object: object { key: val }”), you could use `object {}` and `set … of result to …` if the compiler supports empty `object {}` and property set.
+
+---
+
+## 5. **set.kade** ✓
+
+Set operations on lists (no native Set): `union`, `intersection`, `difference`, `symmetricDifference`, `isSubset`, `isSuperset`, `areDisjoint`, `cartesianProduct`.
+
+- **Style**: Pure Kadence, no JS helpers; uses nested `for each` and equality. Readable.
+- **Cost**: O(n²) in many places (e.g. membership via linear search). Acceptable for small sets; for large sets consider a JS helper backed by `Set` and call it from a thin `.kade` wrapper (like async/format).
+
+---
+
+## 6. **validation.kade** ✓ (comparisons fixed)
+
+Validators: `isEmail`, `isUrl`, `isNumeric`, `isAlpha`, `isAlphanumeric`, `isInteger`, `isPositive`, `isNegative`, `isInRange`, `isLength`, `isEmpty`/`isNotEmpty`, `isHexColor`, `isIpAddress`, `isPhoneNumber`, `isCreditCard` (Luhn), `isStrongPassword`.
+
+- **Comparisons**: The compiler only supports `at least` / `at most` for ≥/≤ (see `CompareOp` in grammar). Replaced “more than or equals” / “less than or equals” with “at least” / “at most” in `isInRange`, `isLength`, `isPhoneNumber`, and the Luhn loop.
+- **Name clash**: Resolved by renaming string “blank” check from `isEmpty` to `isBlank`; `isNotEmpty` now calls `isBlank`.
+- **Luhn**: Logic for `isCreditCard` is correct; `(sum / 10) * 10 equals sum` is a valid way to express “sum divisible by 10” without a mod operator.
+
+---
+
+## 7. **object-helpers.js** (modified)
+
+Shared implementation for object/map operations. Used by **map.kade**; no issues found. Exports are consistent with what **map.kade** calls.
+
+---
+
+## 8. **.object.kade.js**
+
+Appears to be compiled output (e.g. from a file like `object.kade`). Typically such files are generated; consider adding them to `.gitignore` or generating them in a build step so they aren’t committed as source.
+
+---
+
+## Summary of changes made
+
+| File             | Change                                                                 |
+|------------------|------------------------------------------------------------------------|
+| **validation.kade** | Replaced “more than or equals” / “less than or equals” with “at least” / “at most” in four places so the code parses and runs. |
+| **format.kade**     | Reworked `ordinal` to use `floor` for tens/remainder and to handle 11–13 correctly (e.g. 11th, 21st). |
+
+---
+
+## Recommendations (implemented)
+
+1. **Consistency**: Use “at least” / “at most” everywhere; **validation.kade** and **test-reverse.kade** were updated.
+2. **validation.kade** `isEmpty`: Renamed to `isBlank`; `isNotEmpty` now calls `isBlank`.
+3. **map.kade**: Exposes `deepClone`, `get`, and `defaults` from **object-helpers.js**; **map.js** updated to match.
+4. **async.js / map.js**: Removed `__kadence_*` and `fs` stubs so the emitted JS is minimal.
+5. **.object.kade.js**: Added `stdlib/.object.kade.js` to **.gitignore** so generated output is not committed.