@markdy/core 0.7.26 → 0.7.28

package/dist/index.d.ts

@@ -197,7 +197,7 @@ declare const PRESET_NAMES: readonly string[];
  */
 declare const BUILTIN_ACTOR_TYPES: readonly BuiltinActorType[];
 /** Actions valid on every actor type. */
-declare const UNIVERSAL_ACTION_NAMES: readonly ["enter", "exit", "move", "fade_in", "fade_out", "scale", "rotate", "shake", "say", "throw", "play"];
+declare const UNIVERSAL_ACTION_NAMES: readonly ["enter", "exit", "move", "spring", "follow_path", "fade_in", "fade_out", "scale", "rotate", "shake", "pulse", "glow", "ripple", "blur", "line_reveal", "mask", "parallax", "say", "throw", "play"];
 /**
  * Actions that require a `figure` actor. Applying one to any other actor
  * type is a hard `ParseError`, not a soft warning — it's always a mistake.
@@ -212,4 +212,8 @@ type ActorPack = {
 };
 declare function registerActorPack(pack: ActorPack): void;
 
-export { type ActorDef, type ActorPack, type ActorType, type AssetDef, BUILTIN_ACTOR_TYPES, type BuiltinActorType, CAMERA_ACTION_NAMES, type Chapter, FIGURE_ONLY_ACTION_NAMES, type ImportDecl, PRESETS, PRESET_NAMES, ParseError, type ParseOptions, type ParseWarning, type PresetFn, type SceneAST, type SceneMeta, type SequenceDef, type TemplateDef, type TimelineEvent, UNIVERSAL_ACTION_NAMES, parse, registerActorPack };
+declare const TECHNICAL_NODE_TYPES: readonly ["service", "api", "microservice", "backend", "server", "worker", "job", "scheduler", "cron", "batch", "function", "lambda", "edge", "controller", "handler", "repository", "module", "package", "library", "sdk", "cli", "runtime", "process", "client", "user", "browser", "web", "mobile", "desktop", "frontend", "app", "page", "view", "component", "store", "db", "database", "sql", "nosql", "table", "index", "warehouse", "lake", "object_store", "bucket", "blob", "volume", "disk", "search", "cache", "queue", "topic", "stream", "event", "event_bus", "bus", "broker", "pubsub", "kafka", "producer", "consumer", "dead_letter", "dlq", "webhook", "cloud", "region", "vpc", "subnet", "network", "internet", "dns", "cdn", "proxy", "gateway", "api_gateway", "load_balancer", "reverse_proxy", "router", "switch", "nat", "firewall", "waf", "vpn", "bastion", "container", "cluster", "pod", "node", "deployment", "replicaset", "statefulset", "daemonset", "namespace", "ingress", "service_mesh", "sidecar", "image", "registry", "docker", "compose", "helm", "chart", "configmap", "pvc", "auth", "identity", "oauth", "oidc", "jwt", "session", "policy", "role", "permission", "vault", "secret", "key", "certificate", "repo", "branch", "commit", "pipeline", "workflow", "runner", "build", "test", "artifact", "deploy", "release", "environment", "preview", "monitor", "metrics", "logs", "trace", "alert", "dashboard", "probe", "slo", "start", "end", "state", "decision", "condition", "step", "loop", "sequence", "participant", "replica", "shard", "leader", "follower", "quorum", "consensus", "lock", "class", "interface", "method", "object", "enum", "type"];
+declare const VISUAL_PRIMITIVE_TYPES: readonly ["panel", "surface", "terminal", "metric", "stat", "grid", "matrix", "lane", "track", "marker", "dot", "token_strip", "chips", "glyph_card", "glyph"];
+declare const TECHNICAL_NODE_KINDS: Record<(typeof TECHNICAL_NODE_TYPES)[number], string>;
+
+export { type ActorDef, type ActorPack, type ActorType, type AssetDef, BUILTIN_ACTOR_TYPES, type BuiltinActorType, CAMERA_ACTION_NAMES, type Chapter, FIGURE_ONLY_ACTION_NAMES, type ImportDecl, PRESETS, PRESET_NAMES, ParseError, type ParseOptions, type ParseWarning, type PresetFn, type SceneAST, type SceneMeta, type SequenceDef, TECHNICAL_NODE_KINDS, TECHNICAL_NODE_TYPES, type TemplateDef, type TimelineEvent, UNIVERSAL_ACTION_NAMES, VISUAL_PRIMITIVE_TYPES, parse, registerActorPack };

package/dist/index.js

@@ -236,11 +236,20 @@ var UNIVERSAL_ACTION_NAMES = [
   "enter",
   "exit",
   "move",
+  "spring",
+  "follow_path",
   "fade_in",
   "fade_out",
   "scale",
   "rotate",
   "shake",
+  "pulse",
+  "glow",
+  "ripple",
+  "blur",
+  "line_reveal",
+  "mask",
+  "parallax",
   "say",
   "throw",
   "play"
@@ -290,6 +299,349 @@ function isKnownAction(actorType, action) {
   return actorActions.get(actorType)?.has(action) ?? false;
 }
 
+// src/system-vocabulary.ts
+var TECHNICAL_NODE_TYPES = [
+  "service",
+  "api",
+  "microservice",
+  "backend",
+  "server",
+  "worker",
+  "job",
+  "scheduler",
+  "cron",
+  "batch",
+  "function",
+  "lambda",
+  "edge",
+  "controller",
+  "handler",
+  "repository",
+  "module",
+  "package",
+  "library",
+  "sdk",
+  "cli",
+  "runtime",
+  "process",
+  "client",
+  "user",
+  "browser",
+  "web",
+  "mobile",
+  "desktop",
+  "frontend",
+  "app",
+  "page",
+  "view",
+  "component",
+  "store",
+  "db",
+  "database",
+  "sql",
+  "nosql",
+  "table",
+  "index",
+  "warehouse",
+  "lake",
+  "object_store",
+  "bucket",
+  "blob",
+  "volume",
+  "disk",
+  "search",
+  "cache",
+  "queue",
+  "topic",
+  "stream",
+  "event",
+  "event_bus",
+  "bus",
+  "broker",
+  "pubsub",
+  "kafka",
+  "producer",
+  "consumer",
+  "dead_letter",
+  "dlq",
+  "webhook",
+  "cloud",
+  "region",
+  "vpc",
+  "subnet",
+  "network",
+  "internet",
+  "dns",
+  "cdn",
+  "proxy",
+  "gateway",
+  "api_gateway",
+  "load_balancer",
+  "reverse_proxy",
+  "router",
+  "switch",
+  "nat",
+  "firewall",
+  "waf",
+  "vpn",
+  "bastion",
+  "container",
+  "cluster",
+  "pod",
+  "node",
+  "deployment",
+  "replicaset",
+  "statefulset",
+  "daemonset",
+  "namespace",
+  "ingress",
+  "service_mesh",
+  "sidecar",
+  "image",
+  "registry",
+  "docker",
+  "compose",
+  "helm",
+  "chart",
+  "configmap",
+  "pvc",
+  "auth",
+  "identity",
+  "oauth",
+  "oidc",
+  "jwt",
+  "session",
+  "policy",
+  "role",
+  "permission",
+  "vault",
+  "secret",
+  "key",
+  "certificate",
+  "repo",
+  "branch",
+  "commit",
+  "pipeline",
+  "workflow",
+  "runner",
+  "build",
+  "test",
+  "artifact",
+  "deploy",
+  "release",
+  "environment",
+  "preview",
+  "monitor",
+  "metrics",
+  "logs",
+  "trace",
+  "alert",
+  "dashboard",
+  "probe",
+  "slo",
+  "start",
+  "end",
+  "state",
+  "decision",
+  "condition",
+  "step",
+  "loop",
+  "sequence",
+  "participant",
+  "replica",
+  "shard",
+  "leader",
+  "follower",
+  "quorum",
+  "consensus",
+  "lock",
+  "class",
+  "interface",
+  "method",
+  "object",
+  "enum",
+  "type"
+];
+var VISUAL_PRIMITIVE_TYPES = [
+  "panel",
+  "surface",
+  "terminal",
+  "metric",
+  "stat",
+  "grid",
+  "matrix",
+  "lane",
+  "track",
+  "marker",
+  "dot",
+  "token_strip",
+  "chips",
+  "glyph_card",
+  "glyph"
+];
+var TECHNICAL_NODE_KINDS = {
+  service: "compute",
+  api: "compute",
+  microservice: "compute",
+  backend: "compute",
+  server: "compute",
+  worker: "compute",
+  job: "compute",
+  scheduler: "compute",
+  cron: "compute",
+  batch: "compute",
+  function: "compute",
+  lambda: "compute",
+  edge: "compute",
+  controller: "compute",
+  handler: "compute",
+  repository: "compute",
+  runtime: "compute",
+  process: "compute",
+  module: "code",
+  package: "code",
+  library: "code",
+  sdk: "code",
+  cli: "code",
+  class: "code",
+  interface: "code",
+  method: "code",
+  object: "code",
+  enum: "code",
+  type: "code",
+  client: "client",
+  user: "client",
+  browser: "client",
+  web: "client",
+  mobile: "client",
+  desktop: "client",
+  frontend: "client",
+  app: "client",
+  page: "client",
+  view: "client",
+  component: "client",
+  store: "client",
+  db: "data",
+  database: "data",
+  sql: "data",
+  nosql: "data",
+  table: "data",
+  index: "data",
+  warehouse: "data",
+  lake: "data",
+  object_store: "data",
+  bucket: "data",
+  blob: "data",
+  volume: "data",
+  disk: "data",
+  search: "data",
+  cache: "data",
+  queue: "messaging",
+  topic: "messaging",
+  stream: "messaging",
+  event: "messaging",
+  event_bus: "messaging",
+  bus: "messaging",
+  broker: "messaging",
+  pubsub: "messaging",
+  kafka: "messaging",
+  producer: "messaging",
+  consumer: "messaging",
+  dead_letter: "messaging",
+  dlq: "messaging",
+  webhook: "messaging",
+  cloud: "network",
+  region: "network",
+  vpc: "network",
+  subnet: "network",
+  network: "network",
+  internet: "network",
+  dns: "network",
+  cdn: "network",
+  proxy: "network",
+  gateway: "network",
+  api_gateway: "network",
+  load_balancer: "network",
+  reverse_proxy: "network",
+  router: "network",
+  switch: "network",
+  nat: "network",
+  firewall: "network",
+  waf: "network",
+  vpn: "network",
+  bastion: "network",
+  container: "platform",
+  cluster: "platform",
+  pod: "platform",
+  node: "platform",
+  deployment: "platform",
+  replicaset: "platform",
+  statefulset: "platform",
+  daemonset: "platform",
+  namespace: "platform",
+  ingress: "platform",
+  service_mesh: "platform",
+  sidecar: "platform",
+  image: "platform",
+  registry: "platform",
+  docker: "platform",
+  compose: "platform",
+  helm: "platform",
+  chart: "platform",
+  configmap: "platform",
+  pvc: "platform",
+  auth: "security",
+  identity: "security",
+  oauth: "security",
+  oidc: "security",
+  jwt: "security",
+  session: "security",
+  policy: "security",
+  role: "security",
+  permission: "security",
+  vault: "security",
+  secret: "security",
+  key: "security",
+  certificate: "security",
+  repo: "delivery",
+  branch: "delivery",
+  commit: "delivery",
+  pipeline: "delivery",
+  workflow: "delivery",
+  runner: "delivery",
+  build: "delivery",
+  test: "delivery",
+  artifact: "delivery",
+  deploy: "delivery",
+  release: "delivery",
+  environment: "delivery",
+  preview: "delivery",
+  monitor: "observability",
+  metrics: "observability",
+  logs: "observability",
+  trace: "observability",
+  alert: "observability",
+  dashboard: "observability",
+  probe: "observability",
+  slo: "observability",
+  start: "flow",
+  end: "flow",
+  state: "flow",
+  decision: "flow",
+  condition: "flow",
+  step: "flow",
+  loop: "flow",
+  sequence: "flow",
+  participant: "flow",
+  replica: "distributed",
+  shard: "distributed",
+  leader: "distributed",
+  follower: "distributed",
+  quorum: "distributed",
+  consensus: "distributed",
+  lock: "distributed"
+};
+
 // src/parser.ts
 var ParseError = class extends Error {
   constructor(message, line) {
@@ -517,6 +869,24 @@ var SEQ_EVENT_RE = /^@\+([\d.]+):\s+\$\.(!?\w+)\((.*)\)$/;
 var CHAPTER_HEADER_RE = /^scene\s+"([^"]+)"\s*\{$/;
 var IMPORT_RE = /^import\s+"([^"]+)"\s+as\s+(\w+)\s*$/;
 var PRESET_RE = /^preset\s+(\w+)(?:\s*\((.*)\))?\s*$/;
+var ARCHITECTURE_NODE_RE = new RegExp(
+  `^(${TECHNICAL_NODE_TYPES.join("|")})\\s+(\\w+)(?:\\s+("[^"]+"|'[^']+'))?(?:\\s+at\\s+\\(\\s*(-?[\\d.]+)\\s*,\\s*(-?[\\d.]+)\\s*\\))?(.*)$`
+);
+var ARCHITECTURE_ALIAS_TO_TYPE = {
+  api: "service",
+  database: "database",
+  db: "db",
+  user: "client",
+  client: "client",
+  service: "service",
+  queue: "queue",
+  cache: "cache",
+  cloud: "cloud",
+  region: "region",
+  container: "container",
+  microservice: "microservice",
+  cluster: "cluster"
+};
 function interpolate(s, vars) {
   return s.replace(
     /\\?\$\{([A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*)\}/g,
@@ -779,7 +1149,7 @@ function parse(source, opts = {}) {
       }
       continue;
     }
-    if (raw.startsWith("actor ")) {
+    if (raw.startsWith("actor ") || isArchitectureNodeLine(raw)) {
       const actorInfo = parseActorLine(raw, lineNum, ast);
       if (!actorCountWarned && actorCountWarningThreshold > 0) {
         const actorCount = Object.keys(ast.actors).length;
@@ -845,6 +1215,8 @@ function parseActorCallArgs(argsRaw) {
   });
 }
 function parseActorLine(raw, lineNum, ast) {
+  const architectureNode = parseArchitectureNodeLine(raw, lineNum, ast);
+  if (architectureNode) return architectureNode;
   const amAnchor = ACTOR_ANCHOR_POS_RE.exec(raw);
   const amNum = amAnchor ? null : ACTOR_NUM_POS_RE.exec(raw);
   if (!amAnchor && !amNum) throw new ParseError(`Invalid actor declaration: ${raw}`, lineNum);
@@ -935,6 +1307,57 @@ function parseActorLine(raw, lineNum, ast) {
   };
   return { name, args: resolvedArgs };
 }
+function isArchitectureNodeLine(raw) {
+  return ARCHITECTURE_NODE_RE.test(raw);
+}
+function parseArchitectureNodeLine(raw, lineNum, ast) {
+  const m = ARCHITECTURE_NODE_RE.exec(raw);
+  if (!m) return null;
+  const [, alias, name, labelRaw, xRaw, yRaw, trailer] = m;
+  if (name === "camera") {
+    throw new ParseError(
+      `"camera" is a reserved actor name; choose a different architecture node name`,
+      lineNum
+    );
+  }
+  const typeName = ARCHITECTURE_ALIAS_TO_TYPE[alias] ?? alias;
+  if (!isKnownActorType(typeName)) {
+    throw new ParseError(
+      `Architecture node "${alias}" requires an actor pack that registers type "${typeName}"`,
+      lineNum
+    );
+  }
+  const actorIndex = Object.keys(ast.actors).length;
+  const x = xRaw === void 0 ? autoNodeX(actorIndex, ast.meta.width) : Number(xRaw);
+  const y = yRaw === void 0 ? autoNodeY(actorIndex, ast.meta.height, ast.meta.width) : Number(yRaw);
+  if (x < 0 || x > ast.meta.width || y < 0 || y > ast.meta.height) {
+    throw new ParseError(
+      `Actor "${name}" position (${x}, ${y}) is outside scene bounds (0\u2013${ast.meta.width}, 0\u2013${ast.meta.height})`,
+      lineNum
+    );
+  }
+  const quoted = labelRaw ? parseQuotedLiteral(labelRaw.trim()) : null;
+  const label = quoted ?? labelRaw?.trim() ?? name;
+  const modifiers = parseActorTrailer(trailer, lineNum, ast.warnings);
+  ast.actors[name] = {
+    type: typeName,
+    args: [label],
+    x,
+    y,
+    ...modifiers
+  };
+  return { name, args: [label] };
+}
+function autoNodeX(index, width) {
+  const columns = Math.max(1, Math.floor(width / 220));
+  const gutter = width / (columns + 1);
+  return Math.round(gutter * (index % columns + 1));
+}
+function autoNodeY(index, height, width = DEFAULTS.width) {
+  const columns = Math.max(1, Math.floor(width / 220));
+  const row = Math.floor(index / columns);
+  return Math.min(height - 60, 90 + row * 120);
+}
 var GROUP_RE = /^group\s+([A-Za-z_][\w.]*)\s*=\s*(.+)$/;
 function parseGroupLine(raw, lineNum, ast) {
   const m = GROUP_RE.exec(raw);
@@ -1208,7 +1631,10 @@ export {
   PRESETS,
   PRESET_NAMES,
   ParseError,
+  TECHNICAL_NODE_KINDS,
+  TECHNICAL_NODE_TYPES,
   UNIVERSAL_ACTION_NAMES,
+  VISUAL_PRIMITIVE_TYPES,
   parse,
   registerActorPack
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/core",
-  "version": "0.7.26",
+  "version": "0.7.28",
   "description": "MarkdyScript parser and AST types — zero runtime dependencies.",
   "license": "MIT",
   "type": "module",