sdtk-design-kit 0.1.0

package/src/lib/args.js

@@ -0,0 +1,47 @@
+"use strict";
+
+function parseFlags(args, defs = {}) {
+  const flags = {};
+  const positionals = [];
+  const input = Array.isArray(args) ? args : [];
+
+  for (let index = 0; index < input.length; index += 1) {
+    const arg = input[index];
+    if (arg === "--") {
+      positionals.push(...input.slice(index + 1));
+      break;
+    }
+    if (!arg.startsWith("-") || arg === "-") {
+      positionals.push(arg);
+      continue;
+    }
+    const raw = arg.replace(/^-+/, "");
+    const [name, inlineValue] = raw.split(/=(.*)/s).filter((part) => part !== undefined);
+    const def = defs[name];
+    if (!def) {
+      positionals.push(arg);
+      continue;
+    }
+    if (def.type === "boolean") {
+      flags[name] = inlineValue === undefined ? true : inlineValue !== "false";
+      continue;
+    }
+    if (inlineValue !== undefined) {
+      flags[name] = inlineValue;
+      continue;
+    }
+    const value = input[index + 1];
+    if (value === undefined || value.startsWith("-")) {
+      flags[name] = "";
+      continue;
+    }
+    flags[name] = value;
+    index += 1;
+  }
+
+  return { flags, positionals };
+}
+
+module.exports = {
+  parseFlags,
+};

package/src/lib/design-paths.js

@@ -0,0 +1,72 @@
+"use strict";
+
+const path = require("path");
+
+const DESIGN_DOCS_RELATIVE = path.join("docs", "design");
+const DESIGN_WIREFRAMES_RELATIVE = path.join("docs", "design", "wireframes");
+const DESIGN_REVIEWS_RELATIVE = path.join("docs", "design", "reviews");
+const DESIGN_README_RELATIVE = path.join("docs", "design", "README.md");
+const DESIGN_BRIEF_RELATIVE = path.join("docs", "design", "DESIGN_BRIEF.md");
+const DESIGN_SCREEN_MAP_RELATIVE = path.join("docs", "design", "SCREEN_MAP.md");
+const DESIGN_SYSTEM_RELATIVE = path.join("docs", "design", "DESIGN_SYSTEM.md");
+const DESIGN_HANDOFF_RELATIVE = path.join("docs", "design", "DESIGN_HANDOFF.md");
+const DESIGN_STATE_RELATIVE = path.join(".sdtk", "design");
+const DESIGN_MANIFEST_RELATIVE = path.join(".sdtk", "design", "manifest.json");
+
+function resolveProjectPath(projectPath) {
+  return path.resolve(projectPath || process.cwd());
+}
+
+function normalizeComparablePath(targetPath) {
+  const resolved = path.resolve(targetPath);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+
+function isPathInsideOrEqual(targetPath, rootPath) {
+  const comparableTarget = normalizeComparablePath(targetPath);
+  const comparableRoot = normalizeComparablePath(rootPath);
+  return comparableTarget === comparableRoot || comparableTarget.startsWith(comparableRoot + path.sep);
+}
+
+function assertProjectLocalPath(targetPath, projectPath, label = "path") {
+  const resolvedProject = resolveProjectPath(projectPath);
+  const resolvedTarget = path.resolve(targetPath);
+  if (!isPathInsideOrEqual(resolvedTarget, resolvedProject)) {
+    throw new Error(`Refusing to access ${label} outside project root: ${resolvedTarget}`);
+  }
+  return resolvedTarget;
+}
+
+function describeDesignPaths(projectPath) {
+  const root = resolveProjectPath(projectPath);
+  return {
+    projectPath: root,
+    designDocsPath: path.join(root, DESIGN_DOCS_RELATIVE),
+    wireframesPath: path.join(root, DESIGN_WIREFRAMES_RELATIVE),
+    reviewsPath: path.join(root, DESIGN_REVIEWS_RELATIVE),
+    designReadmePath: path.join(root, DESIGN_README_RELATIVE),
+    designBriefPath: path.join(root, DESIGN_BRIEF_RELATIVE),
+    screenMapPath: path.join(root, DESIGN_SCREEN_MAP_RELATIVE),
+    designSystemPath: path.join(root, DESIGN_SYSTEM_RELATIVE),
+    designHandoffPath: path.join(root, DESIGN_HANDOFF_RELATIVE),
+    designStatePath: path.join(root, DESIGN_STATE_RELATIVE),
+    manifestPath: path.join(root, DESIGN_MANIFEST_RELATIVE),
+  };
+}
+
+module.exports = {
+  DESIGN_BRIEF_RELATIVE,
+  DESIGN_DOCS_RELATIVE,
+  DESIGN_HANDOFF_RELATIVE,
+  DESIGN_MANIFEST_RELATIVE,
+  DESIGN_README_RELATIVE,
+  DESIGN_REVIEWS_RELATIVE,
+  DESIGN_SCREEN_MAP_RELATIVE,
+  DESIGN_STATE_RELATIVE,
+  DESIGN_SYSTEM_RELATIVE,
+  DESIGN_WIREFRAMES_RELATIVE,
+  assertProjectLocalPath,
+  describeDesignPaths,
+  isPathInsideOrEqual,
+  resolveProjectPath,
+};

package/src/lib/errors.js

@@ -0,0 +1,21 @@
+"use strict";
+
+class CliError extends Error {
+  constructor(message, exitCode = 4) {
+    super(message);
+    this.name = "CliError";
+    this.exitCode = exitCode;
+  }
+}
+
+class ValidationError extends CliError {
+  constructor(message) {
+    super(message, 2);
+    this.name = "ValidationError";
+  }
+}
+
+module.exports = {
+  CliError,
+  ValidationError,
+};