novac 2.0.1 → 2.2.0

package/novac/src/core/config.js

@@ -0,0 +1,155 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { ConfigFile, Shema, ShemaType } = require('./bstd');
+
+// Define the Nova config schema
+const novaConfigSchema = new Shema({
+  name: new ShemaType('String', val => typeof val === 'string'),
+  version: new ShemaType('String', val => typeof val === 'string'),
+  author: new ShemaType('String', val => typeof val === 'string'),
+  description: new ShemaType('String', val => typeof val === 'string'),
+  main: new ShemaType('String', val => typeof val === 'string'),
+  license: new ShemaType('String', val => typeof val === 'string'),
+  scripts: new ShemaType('Object', val => typeof val === 'object' && val !== null),
+  dependencies: new ShemaType('Object', val => typeof val === 'object' && val !== null),
+  devDependencies: new ShemaType('Object', val => typeof val === 'object' && val !== null),
+});
+
+// Initialize or load the global Nova config
+function initializeConfig() {
+  const configPath = path.join(os.homedir(), '.novac', 'nvconfig.json');
+  const configDir = path.dirname(configPath);
+
+  // Create config directory if it doesn't exist
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+
+  // Create config file if it doesn't exist
+  if (!fs.existsSync(configPath)) {
+    const defaultConfig = {
+      name: 'nova-project',
+      version: '1.0.0',
+      author: '',
+      description: '',
+      main: 'src/main.nova',
+      license: 'MIT',
+      scripts: {},
+      dependencies: {},
+      devDependencies: {},
+    };
+    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+  }
+
+  return configPath;
+}
+
+// Get config value
+function getConfig(keyPath) {
+  const configPath = initializeConfig();
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+
+  if (!keyPath) {
+    return config;
+  }
+
+  // Parse key path like "scripts.build" or "dependencies.lodash"
+  const keys = keyPath.split('.');
+  let current = config;
+
+  for (const key of keys) {
+    if (current && typeof current === 'object' && key in current) {
+      current = current[key];
+    } else {
+      return undefined;
+    }
+  }
+
+  return current;
+}
+
+// Set config value
+function setConfig(keyPath, value) {
+  const configPath = initializeConfig();
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+
+  const keys = keyPath.split('.');
+  let current = config;
+
+  // Navigate to the parent object
+  for (let i = 0; i < keys.length - 1; i++) {
+    const key = keys[i];
+    if (!(key in current) || typeof current[key] !== 'object') {
+      current[key] = {};
+    }
+    current = current[key];
+  }
+
+  // Set the value
+  current[keys[keys.length - 1]] = parseValue(value);
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+
+// Parse string value to appropriate type
+function parseValue(value) {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  if (value === 'null') return null;
+  if (value === 'undefined') return undefined;
+  if (!isNaN(value) && value !== '') return Number(value);
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+// Interactive setup for config
+function interactiveSetup() {
+  const configPath = initializeConfig();
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+
+  const questions = [
+    { key: 'name', default: config.name || 'nova-project' },
+    { key: 'version', default: config.version || '1.0.0' },
+    { key: 'author', default: config.author || '' },
+    { key: 'description', default: config.description || '' },
+    { key: 'main', default: config.main || 'src/main.nova' },
+    { key: 'license', default: config.license || 'MIT' },
+  ];
+
+  const readline = require('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  let questionIndex = 0;
+
+  const askQuestion = () => {
+    if (questionIndex >= questions.length) {
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      console.log('Config saved successfully!');
+      rl.close();
+      return;
+    }
+
+    const question = questions[questionIndex];
+    rl.question(`${question.key} (${question.default}): `, (answer) => {
+      config[question.key] = answer.trim() === '' ? question.default : answer.trim();
+      questionIndex++;
+      askQuestion();
+    });
+  };
+
+  askQuestion();
+}
+
+module.exports = {
+  initializeConfig,
+  getConfig,
+  setConfig,
+  interactiveSetup,
+};

package/novac/src/core/describe.js

@@ -0,0 +1,187 @@
+/**
+ * describe.js
+ * Converts Nova Air AST into natural-language explanations.
+ * Style: clear, rhythmic, and human — with natural punctuation.
+ */
+
+function describe(node, depth = 0) {
+  const indent = "  ".repeat(depth);
+  if (!node) return "";
+  if (Array.isArray(node))
+    return node.map(n => describe(n, depth)).join("\n");
+
+  switch (node.kind) {
+    // ─────────── ROOT ───────────
+    case "program":
+      return node.nodes.map(n => describe(n, depth)).join("\n");
+
+    // ─────────── DECLARATION ───────────
+    case "declare": {
+      const kind = node.isConst ? "constant" : "variable";
+      const pointer = node.isPointer ? "pointer to " : "";
+      if (node.destructure)
+        return `${indent}Create a ${kind} pattern: unpack into { ${node.destructure.props
+          .map(p => p.alias)
+          .join(", ")} }${node.value ? `, using ${describe(node.value)}` : ""}.`;
+      if (node.value)
+        return `${indent}Declare ${kind}: ${pointer}${node.name}, and set it to ${describe(node.value)}.`;
+      return `${indent}Declare ${kind}: ${pointer}${node.name}.`;
+    }
+
+    // ─────────── ASSIGNMENT ───────────
+    case "assign":
+      return `${indent}Set ${describe(node.name)} to ${describe(node.value)}.`;
+
+    // ─────────── REFERENCES ───────────
+    case "ref":
+      return node.name;
+
+    // ─────────── VALUES ───────────
+    case "value":
+      return JSON.stringify(node.value);
+
+    // ─────────── FUNCTIONS ───────────
+    case "function": {
+      const args = node.args.length
+        ? node.args.map(a => describe(a)).join(", ")
+        : "no arguments";
+      return `${indent}${node.isAsync ? "Async " : ""}function '${node.name}': takes (${args}), and ${summarizeBody(node.body)}.`;
+    }
+
+    case "arrowfunc": {
+      const args = node.args.length
+        ? node.args.map(a => describe(a)).join(", ")
+        : "no arguments";
+      return `${indent}Arrow function: takes (${args}), and ${summarizeBody(node.body)}.`;
+    }
+
+    // ─────────── RETURN ───────────
+    case "return":
+      return `${indent}Return ${node.value ? describe(node.value) : "nothing"}${node.terminate ? ", immediately" : ""}.`;
+
+    // ─────────── CLASS ───────────
+    case "class":
+      return `${indent}Define a class '${node.name}'${node.superClass ? `, extending ${describe(node.superClass)}` : ""}: \n${node.members
+        .map(m => describe(m, depth + 1))
+        .join("\n")}`;
+
+    // ─────────── BRANCHING ───────────
+    case "branch": {
+      const base = `${indent}${capitalize(node.type)} statement: ${
+        node.args ? `when (${describe(node.args)})` : ""
+      }, then:\n${describe(node.body, depth + 1)}`;
+      const next = node.next
+        ? `\n${indent}else:\n${describe(node.next.body, depth + 1)}`
+        : "";
+      return base + next;
+    }
+
+    // ─────────── LOOPS ───────────
+    case "while":
+    case "repeat":
+    case "for":
+    case "do":
+    case "until":
+      return `${indent}${capitalize(node.kind)} loop: ${
+        node.args ? `condition is ${describe(node.args)},` : ""
+      } running:\n${describe(node.body, depth + 1)}`;
+
+    // ─────────── CALLS ───────────
+    case "call": {
+      const name = typeof node.name === "string" ? node.name : describe(node.name);
+      const args = node.args.length
+        ? `, with arguments: ${node.args.map(a => describe(a)).join(", ")}`
+        : "";
+      return `${indent}Call ${name}${args}.`;
+    }
+
+    // ─────────── PROPERTY ACCESS ───────────
+    case "prop":
+      return `${describe(node.object)}.${node.name}`;
+
+    // ─────────── INDEX ACCESS ───────────
+    case "subscript":
+      return `${describe(node.object)}[${describe(node.index)}]`;
+
+    // ─────────── ASYNC / AWAIT ───────────
+    case "await":
+      return `${indent}Await: wait for ${describe(node.operand)} to complete.`;
+
+    // ─────────── ERROR HANDLING ───────────
+    case "throw":
+      return `${indent}Throw ${describe(node.value)}.`;
+
+    case "try":
+      return `${indent}Try block:\n${describe(node.tryBody, depth + 1)}${
+        node.catchBody
+          ? `\n${indent}If an error occurs: catch it as '${node.catchName}', then:\n${describe(node.catchBody, depth + 1)}`
+          : ""
+      }${node.finallyBody ? `\n${indent}Finally: always run\n${describe(node.finallyBody, depth + 1)}` : ""}`;
+
+    // ─────────── EXPRESSIONS ───────────
+    case "binary":
+      return `${describe(node.left)} ${node.operator} ${describe(node.right)}.`;
+
+    case "unary":
+      return `${node.operator}${describe(node.operand)}.`;
+
+    case "postfix":
+      return `${describe(node.operand)}${node.operator}.`;
+
+    // ─────────── MEMORY / POINTERS ───────────
+    case "deref":
+      return `the value pointed to by ${describe(node.operand)}.`;
+
+    case "currency":
+      return `${describe(node.operand)} (in ${node.name}).`;
+
+    // ─────────── STRUCTURES ───────────
+    case "object":
+      return `object: { ${Object.entries(node.props)
+        .map(([k, v]) => `${k}: ${describe(v)}`)
+        .join(", ")} }.`;
+
+    case "array":
+      return `array: [${node.elements.map(e => describe(e)).join(", ")}].`;
+
+    // ─────────── PATTERNS ───────────
+    case "objpattern":
+      return `{ ${node.props
+        .map(p => `${p.key}${p.key !== p.alias ? ` as ${p.alias}` : ""}`)
+        .join(", ")} }`;
+
+    case "arrpattern":
+      return `[${node.elements.map(e => describe(e)).join(", ")}]`;
+
+    // ─────────── TEMPLATES ───────────
+    case "template":
+      return node.parts.map(p => describe(p)).join("");
+
+    // ─────────── EXECUTION ───────────
+    case "exec":
+      return `${indent}Execute: ${describe(node.expr)}.`;
+
+    // ─────────── FALLBACK ───────────
+    case "EOF":
+      return "";
+    default:
+      return `${indent}(Unknown node type: '${node.kind}')`;
+  }
+}
+
+// ─────────── HELPERS ───────────
+function summarizeBody(body) {
+  if (!body || !body.length) return "does nothing";
+  const first = describe(body[0]);
+  if (body.length === 1) {
+    if (first.startsWith("Return")) return `returns ${first.replace(/^Return /, "").trim()}`;
+    return `does: ${first.toLowerCase()}`;
+  }
+  return "runs several steps in order";
+}
+
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+module.exports = { describe };