@zvndev/darkmown 2.2.0 → 2.3.0

package/src/compiler/state.js

@@ -34,6 +34,7 @@ export function handleState(line, ctx, index) {
   const match = line.match(/^:state\s+([A-Za-z_$][\w$]*)\s*=\s*(.+?)(\s+persist)?$/);
   if (!match)
     throw wdError(`Malformed :state in ${at(ctx, index)}: ${line}. ${STATE_USE}`, {
+      code: "WD201",
       file: ctx.file,
       line: lineOf(ctx, index),
       hint: STATE_USE.slice("Use: ".length),
@@ -54,11 +55,15 @@ export function handleState(line, ctx, index) {
  */
 export function declareState(name, value, ctx) {
   if (ctx.loopItem)
-    throw new Error(`State cannot be declared inside a reactive @loop body (${ctx.file})`);
+    throw wdError(`State cannot be declared inside a reactive @loop body (${ctx.file})`, {
+      code: "WD202",
+      file: ctx.file
+    });
   if (ctx.comp.stores.has(name))
     throw wdError(
       `State "${name}" collides with a :store of the same name in ${ctx.file}. Use: :store name = value for the global, or rename one — e.g. ${STORE_EXAMPLE}`,
       {
+        code: "WD203",
         file: ctx.file,
         hint: `:store name = value for the global, or rename one — e.g. ${STORE_EXAMPLE}`,
         example: STORE_EXAMPLE
@@ -66,7 +71,10 @@ export function declareState(name, value, ctx) {
     );
   const key = ctx.sections.length ? `${ctx.sections.at(-1)}:${name}` : name;
   if (ctx.comp.state.has(key))
-    throw new Error(`State "${name}" is declared twice in the same scope (${ctx.file})`);
+    throw wdError(`State "${name}" is declared twice in the same scope (${ctx.file})`, {
+      code: "WD204",
+      file: ctx.file
+    });
   ctx.comp.state.set(key, value);
   ctx.comp.assets.runtime = true;
   return key;
@@ -84,6 +92,7 @@ export function handleStore(line, ctx, index) {
     throw wdError(
       `Malformed :store in ${at(ctx, index)}: ${line}. Use: :store name = value [ephemeral] — e.g. ${STORE_EXAMPLE}`,
       {
+        code: "WD205",
         file: ctx.file,
         line: lineOf(ctx, index),
         hint: `:store name = value [ephemeral] — e.g. ${STORE_EXAMPLE}`,
@@ -110,6 +119,7 @@ export function declareStore(name, value, ctx) {
     throw wdError(
       `Store "${name}" is declared twice in ${ctx.file}. Use: :store name = value — e.g. ${STORE_EXAMPLE}`,
       {
+        code: "WD206",
         file: ctx.file,
         hint: `:store name = value — e.g. ${STORE_EXAMPLE}`,
         example: STORE_EXAMPLE
@@ -119,6 +129,7 @@ export function declareStore(name, value, ctx) {
     throw wdError(
       `Store "${name}" collides with a :state of the same name in ${ctx.file}. Use: :store name = value for the global, or rename one — e.g. ${STORE_EXAMPLE}`,
       {
+        code: "WD207",
         file: ctx.file,
         hint: `:store name = value for the global, or rename one — e.g. ${STORE_EXAMPLE}`,
         example: STORE_EXAMPLE
@@ -152,6 +163,7 @@ export function handleComputed(line, ctx, index) {
   const match = line.match(/^:computed\s+([A-Za-z_$][\w$]*)\s*=\s*(.+)$/);
   if (!match)
     throw wdError(`Malformed :computed in ${at(ctx, index)}: ${line}. Use: ${COMPUTED_EXAMPLE}`, {
+      code: "WD208",
       file: ctx.file,
       line: lineOf(ctx, index),
       hint: COMPUTED_EXAMPLE,
@@ -169,6 +181,7 @@ export function handleComputed(line, ctx, index) {
     throw wdError(
       `Malformed :computed expression in ${at(ctx, index)}: ${line}. Use: ${COMPUTED_EXAMPLE}`,
       {
+        code: "WD209",
         file: ctx.file,
         line: lineOf(ctx, index),
         hint: COMPUTED_EXAMPLE,
@@ -203,6 +216,7 @@ export function handleTheme(line, ctx, index) {
     throw wdError(
       `Malformed :theme in ${at(ctx, index)}: ${line}. Use: :theme  (or  :theme name = "auto") — e.g. ${THEME_EXAMPLE}`,
       {
+        code: "WD210",
         file: ctx.file,
         line: lineOf(ctx, index),
         hint: `:theme  (or  :theme name = "auto") — e.g. ${THEME_EXAMPLE}`,

package/src/compiler/structure.js

@@ -53,6 +53,7 @@ export function handleInclude(line, ctx, index) {
   const match = line.match(/^@include\s+(\S+)(?:\s+with\s+(.+))?$/);
   if (!match)
     throw wdError(`Malformed @include in ${at(ctx, index)}: ${line}. ${INCLUDE_USE}`, {
+      code: "WD603",
       file: ctx.file,
       line: lineOf(ctx, index),
       hint: INCLUDE_USE.slice("Use: ".length),
@@ -107,8 +108,9 @@ function parseIncludeArgs(raw, ctx) {
       const expr = value.slice(1, -1).trim();
       const resolved = lookupPath(expr, ctx);
       if (!resolved.found) {
-        throw new Error(
-          `@include argument ${match[1]}={ ${expr} } in ${ctx.file} does not match any value in scope`
+        throw wdError(
+          `@include argument ${match[1]}={ ${expr} } in ${ctx.file} does not match any value in scope`,
+          { code: "WD604", file: ctx.file }
         );
       }
       args[match[1]] = resolved.value;
@@ -165,8 +167,9 @@ export function handleContainer(header, bodyLines, ctx, index) {
     }
     const cm = rest.match(/^\.([A-Za-z_][\w-]*)/);
     if (!cm)
-      throw new Error(
-        `Unexpected token "${rest.split(/\s+/)[0]}" in container "::: ${header}" in ${at(ctx, index)}`
+      throw wdError(
+        `Unexpected token "${rest.split(/\s+/)[0]}" in container "::: ${header}" in ${at(ctx, index)}`,
+        { code: "WD605", file: ctx.file, line: lineOf(ctx, index) }
       );
     const cls = cm[1];
     rest = rest.slice(cm[0].length).trim();
@@ -231,6 +234,7 @@ export function handleCarousel(line, bodyLines, ctx, index) {
     if (!auto) {
       const hint = `:carousel [autoplay=3000] … :endcarousel — e.g. ${CAROUSEL_EXAMPLE}`;
       throw wdError(`Malformed :carousel in ${at(ctx, index)}: ${line}. Use: ${hint}`, {
+        code: "WD606",
         file: ctx.file,
         line: lineOf(ctx, index),
         hint,
@@ -295,8 +299,9 @@ export function handleIf(line, truthyLines, falsyLines, ctx, index, falsyStart =
     // Per-row meta vars in :if — only valid inside a loop.
     if (LOOP_META[head]) {
       if (!ctx.loopMeta)
-        throw new Error(
-          `":if ${match[1]}" uses the loop meta variable "${head}" outside a @loop in ${ctx.file}. Use it inside a loop body.`
+        throw wdError(
+          `":if ${match[1]}" uses the loop meta variable "${head}" outside a @loop in ${ctx.file}. Use it inside a loop body.`,
+          { code: "WD607", file: ctx.file }
         );
       if (ctx.loopItem) {
         const truthy = ctx.compileBody(truthyLines, truthyCtx).trim();
@@ -322,8 +327,9 @@ export function handleIf(line, truthyLines, falsyLines, ctx, index, falsyStart =
 
     const key = resolveStateKey(head, ctx);
     if (!key) {
-      throw new Error(
-        `:if ${match[1]} in ${ctx.file} does not match a :state or in-scope value. Declare it first.`
+      throw wdError(
+        `:if ${match[1]} in ${ctx.file} does not match a :state or in-scope value. Declare it first.`,
+        { code: "WD608", file: ctx.file }
       );
     }
     ctx.comp.assets.runtime = true;
@@ -344,6 +350,7 @@ export function handleIf(line, truthyLines, falsyLines, ctx, index, falsyStart =
   if (!condition) {
     const hint = `":if name" or ":if a <op> b [and|or|not …]" — e.g. ${IF_EXAMPLE}`;
     throw wdError(`Malformed :if in ${at(ctx, index)}: ${line}. Use ${hint}`, {
+      code: "WD609",
       file: ctx.file,
       line: lineOf(ctx, index),
       hint,
@@ -403,13 +410,15 @@ function validateDemoHref(href, ctx) {
   const value = href.trim();
   // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional — rejects control characters in URLs/hrefs.
   if (value !== href || /[\u0000-\u001F\u007F]/.test(value)) {
-    throw new Error(
-      `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Use a relative URL starting with /, ./, ../, or #, or an http:, https:, or mailto: URL.`
+    throw wdError(
+      `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Use a relative URL starting with /, ./, ../, or #, or an http:, https:, or mailto: URL.`,
+      { code: "WD610", file: ctx.file }
     );
   }
   if (value.startsWith("//")) {
-    throw new Error(
-      `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Protocol-relative URLs are not allowed; use http: or https: explicitly.`
+    throw wdError(
+      `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Protocol-relative URLs are not allowed; use http: or https: explicitly.`,
+      { code: "WD611", file: ctx.file }
     );
   }
   if (
@@ -424,7 +433,8 @@ function validateDemoHref(href, ctx) {
   if (scheme && ["http", "https", "mailto"].includes(scheme[1].toLowerCase())) {
     return value;
   }
-  throw new Error(
-    `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Use a relative URL starting with /, ./, ../, or #, or an http:, https:, or mailto: URL.`
+  throw wdError(
+    `Unsafe :try href "${escapeHtml(href)}" in ${ctx.file}. Use a relative URL starting with /, ./, ../, or #, or an http:, https:, or mailto: URL.`,
+    { code: "WD610", file: ctx.file }
   );
 }

package/src/deploy.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { buildSite } from "./builder.js";
+import { wdError } from "./compiler/context.js";
 import { BASE_SECURITY_HEADERS, REACTIVE_CSP } from "./headers.js";
 
 /** The platforms `darkmown deploy` knows how to drive. */
@@ -25,7 +26,9 @@ export const DEPLOY_TARGETS = ["vercel", "cloudflare"];
  */
 export async function deploy({ cwd, target, prod = false, log, run = spawnProcess, projectName }) {
   if (!DEPLOY_TARGETS.includes(target)) {
-    throw new Error(`Unknown deploy target "${target}". Use one of: ${DEPLOY_TARGETS.join(", ")}.`);
+    throw wdError(`Unknown deploy target "${target}". Use one of: ${DEPLOY_TARGETS.join(", ")}.`, {
+      code: "WD904"
+    });
   }
 
   ensurePlatformConfig(cwd, target);
@@ -46,11 +49,12 @@ export async function deploy({ cwd, target, prod = false, log, run = spawnProces
         output
       )
     ) {
-      throw new Error(
-        `The ${target} CLI is not signed in. Run \`${plan.loginHint}\` (try \`! ${plan.loginHint}\` in this session), then re-run \`darkmown deploy ${target}\`.`
+      throw wdError(
+        `The ${target} CLI is not signed in. Run \`${plan.loginHint}\` (try \`! ${plan.loginHint}\` in this session), then re-run \`darkmown deploy ${target}\`.`,
+        { code: "WD905" }
       );
     }
-    throw new Error(`${target} deploy failed (exit ${result.code}).`);
+    throw wdError(`${target} deploy failed (exit ${result.code}).`, { code: "WD906" });
   }
 
   const url = plan.parseUrl(output);