@trail-cli/guide-schema 0.1.0

package/dist/index.js

@@ -0,0 +1,290 @@
+// src/target.ts
+import { z } from "zod";
+var TARGET_STRATEGY_ORDER = [
+  "testId",
+  "role",
+  "label",
+  "text",
+  "selector"
+];
+var TargetSchema = z.object({
+  testId: z.string().min(1).optional(),
+  role: z.string().min(1).optional(),
+  name: z.string().min(1).optional(),
+  label: z.string().min(1).optional(),
+  text: z.string().min(1).optional(),
+  selector: z.string().min(1).optional()
+}).strict().superRefine((value, ctx) => {
+  const hasStrategy = !!value.testId || !!value.role && !!value.name || !!value.label || !!value.text || !!value.selector;
+  if (!hasStrategy) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Target must specify at least one of testId, role+name, label, text, or selector."
+    });
+  }
+  if (value.role && !value.name) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["name"], message: "A role target also requires a name." });
+  }
+  if (value.name && !value.role) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["role"], message: "A name target also requires a role." });
+  }
+});
+
+// src/steps.ts
+import { z as z2 } from "zod";
+var id = z2.string().min(1);
+var instruction = z2.string().min(1);
+var autoAdvance = z2.boolean().optional();
+var ClickStepSchema = z2.object({ id, action: z2.literal("click"), target: TargetSchema, instruction, autoAdvance }).strict();
+var InputStepSchema = z2.object({
+  id,
+  action: z2.literal("input"),
+  target: TargetSchema,
+  value: z2.string(),
+  instruction,
+  autoAdvance
+}).strict();
+var SelectStepSchema = z2.object({
+  id,
+  action: z2.literal("select"),
+  target: TargetSchema,
+  value: z2.string(),
+  instruction,
+  autoAdvance
+}).strict();
+var VerifyStepSchema = z2.object({ id, action: z2.literal("verify"), target: TargetSchema, instruction }).strict();
+var NavigateStepSchema = z2.object({ id, action: z2.literal("navigate"), url: z2.string().min(1), instruction }).strict();
+var WaitStepSchema = z2.object({
+  id,
+  action: z2.literal("wait"),
+  target: TargetSchema.optional(),
+  timeoutMs: z2.number().int().positive().optional(),
+  instruction
+}).strict();
+var GuideStepSchema = z2.discriminatedUnion("action", [
+  ClickStepSchema,
+  InputStepSchema,
+  SelectStepSchema,
+  VerifyStepSchema,
+  NavigateStepSchema,
+  WaitStepSchema
+]);
+var placementFields = {
+  before: z2.string().min(1).optional(),
+  after: z2.string().min(1).optional()
+};
+var AuthorGuideStepSchema = z2.discriminatedUnion("action", [
+  ClickStepSchema.extend(placementFields),
+  InputStepSchema.extend(placementFields),
+  SelectStepSchema.extend(placementFields),
+  VerifyStepSchema.extend(placementFields),
+  NavigateStepSchema.extend(placementFields),
+  WaitStepSchema.extend(placementFields)
+]);
+
+// src/guide.ts
+import { z as z3 } from "zod";
+var GuideSchema = z3.object({
+  id: z3.string().min(1),
+  title: z3.string().min(1),
+  application: z3.string().min(1),
+  release: z3.string().min(1),
+  start: z3.object({ url: z3.string().min(1) }).strict(),
+  steps: z3.array(GuideStepSchema).min(1, "A guide must contain at least one step.")
+}).passthrough();
+var AuthorGuideSchema = z3.object({
+  id: z3.string().min(1),
+  title: z3.string().min(1),
+  application: z3.string().min(1),
+  release: z3.string().min(1),
+  start: z3.object({ url: z3.string().min(1) }).strict(),
+  extends: z3.string().min(1).optional(),
+  steps: z3.array(AuthorGuideStepSchema).min(1, "A guide must contain at least one step.")
+}).passthrough().superRefine((guide, context) => {
+  guide.steps.forEach((step, index) => {
+    const hasBefore = step.before !== void 0;
+    const hasAfter = step.after !== void 0;
+    if (hasBefore && hasAfter) {
+      context.addIssue({
+        code: z3.ZodIssueCode.custom,
+        path: ["steps", index],
+        message: "An extension step must use either before or after, not both."
+      });
+    }
+    if (guide.extends && !hasBefore && !hasAfter) {
+      context.addIssue({
+        code: z3.ZodIssueCode.custom,
+        path: ["steps", index],
+        message: "An extension step must specify before or after."
+      });
+    }
+    if (!guide.extends && (hasBefore || hasAfter)) {
+      context.addIssue({
+        code: z3.ZodIssueCode.custom,
+        path: ["steps", index],
+        message: "before and after are only valid on a guide with extends."
+      });
+    }
+  });
+});
+
+// src/parse.ts
+import { parse as parseYamlText } from "yaml";
+function formatPath(path) {
+  if (path.length === 0) return "(root)";
+  let out = "";
+  for (const segment of path) {
+    if (typeof segment === "number") {
+      out += `[${segment}]`;
+    } else {
+      out += out ? `.${segment}` : segment;
+    }
+  }
+  return out;
+}
+function issuesFromZodError(error) {
+  return error.issues.map((issue) => {
+    const path = formatPath(issue.path);
+    const lastSegment = issue.path[issue.path.length - 1];
+    if (lastSegment === "target" && issue.code === "invalid_type") {
+      return { path, message: "Target is required." };
+    }
+    return { path, message: issue.message };
+  });
+}
+function parseData(raw) {
+  const result = GuideSchema.safeParse(raw);
+  if (!result.success) {
+    return { success: false, issues: issuesFromZodError(result.error) };
+  }
+  return { success: true, guide: result.data };
+}
+function parseAuthorData(raw) {
+  const result = AuthorGuideSchema.safeParse(raw);
+  if (!result.success) {
+    return { success: false, issues: issuesFromZodError(result.error) };
+  }
+  return { success: true, guide: result.data };
+}
+function parseGuideYaml(yamlText) {
+  let raw;
+  try {
+    raw = parseYamlText(yamlText);
+  } catch (error) {
+    return {
+      success: false,
+      issues: [
+        { path: "(yaml)", message: error instanceof Error ? error.message : "Invalid YAML." }
+      ]
+    };
+  }
+  return parseData(raw);
+}
+function parseAuthorGuideYaml(yamlText) {
+  let raw;
+  try {
+    raw = parseYamlText(yamlText);
+  } catch (error) {
+    return {
+      success: false,
+      issues: [
+        { path: "(yaml)", message: error instanceof Error ? error.message : "Invalid YAML." }
+      ]
+    };
+  }
+  return parseAuthorData(raw);
+}
+function parseGuideJson(jsonText) {
+  let raw;
+  try {
+    raw = JSON.parse(jsonText);
+  } catch (error) {
+    return {
+      success: false,
+      issues: [
+        { path: "(json)", message: error instanceof Error ? error.message : "Invalid JSON." }
+      ]
+    };
+  }
+  return parseData(raw);
+}
+
+// src/resolve.ts
+function withoutPlacement(step) {
+  const { before: _before, after: _after, ...runtimeStep } = step;
+  return runtimeStep;
+}
+function duplicateStepIssue(steps) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const step of steps) {
+    if (ids.has(step.id)) {
+      return { path: "steps", message: `Duplicate step id: ${step.id}.` };
+    }
+    ids.add(step.id);
+  }
+  return void 0;
+}
+function runtimeGuideData(guide, steps) {
+  const { extends: _extends, steps: _steps, ...runtimeGuide } = guide;
+  return { ...runtimeGuide, steps };
+}
+function resolveGuide(guide, guidesById, resolving = /* @__PURE__ */ new Set()) {
+  var _a;
+  if (resolving.has(guide.id)) {
+    return { success: false, issues: [{ path: "extends", message: "Guide inheritance cycle detected." }] };
+  }
+  if (!guide.extends) {
+    const steps2 = guide.steps.map(withoutPlacement);
+    const duplicateIssue2 = duplicateStepIssue(steps2);
+    if (duplicateIssue2) return { success: false, issues: [duplicateIssue2] };
+    const parsed2 = GuideSchema.safeParse(runtimeGuideData(guide, steps2));
+    return parsed2.success ? { success: true, guide: parsed2.data } : { success: false, issues: parsed2.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })) };
+  }
+  const base = guidesById.get(guide.extends);
+  if (!base) {
+    return { success: false, issues: [{ path: "extends", message: `Base guide not found: ${guide.extends}.` }] };
+  }
+  if (guide.release !== base.release || guide.application !== base.application) {
+    return {
+      success: false,
+      issues: [{ path: "extends", message: "An extension must match its base guide's release and application." }]
+    };
+  }
+  const nextResolving = new Set(resolving);
+  nextResolving.add(guide.id);
+  const baseResult = resolveGuide(base, guidesById, nextResolving);
+  if (!baseResult.success) return baseResult;
+  const steps = [...baseResult.guide.steps];
+  for (const extensionStep of guide.steps) {
+    const anchorId = (_a = extensionStep.before) != null ? _a : extensionStep.after;
+    const anchorIndex = steps.findIndex((step) => step.id === anchorId);
+    if (anchorIndex === -1) {
+      return { success: false, issues: [{ path: "steps", message: `Anchor step not found: ${anchorId}.` }] };
+    }
+    steps.splice(extensionStep.before ? anchorIndex : anchorIndex + 1, 0, withoutPlacement(extensionStep));
+  }
+  const duplicateIssue = duplicateStepIssue(steps);
+  if (duplicateIssue) return { success: false, issues: [duplicateIssue] };
+  const parsed = GuideSchema.safeParse(runtimeGuideData(guide, steps));
+  return parsed.success ? { success: true, guide: parsed.data } : { success: false, issues: parsed.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })) };
+}
+export {
+  AuthorGuideSchema,
+  AuthorGuideStepSchema,
+  ClickStepSchema,
+  GuideSchema,
+  GuideStepSchema,
+  InputStepSchema,
+  NavigateStepSchema,
+  SelectStepSchema,
+  TARGET_STRATEGY_ORDER,
+  TargetSchema,
+  VerifyStepSchema,
+  WaitStepSchema,
+  issuesFromZodError,
+  parseAuthorGuideYaml,
+  parseGuideJson,
+  parseGuideYaml,
+  resolveGuide
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/target.ts","../src/steps.ts","../src/guide.ts","../src/parse.ts","../src/resolve.ts"],"sourcesContent":["import { z } from \"zod\";\r\n\r\n/**\r\n * Priority order used by the SDK's target resolver, highest priority first.\r\n * A single target may carry more than one hint (e.g. a `testId` with a `selector`\r\n * fallback); the resolver tries them in this order until one matches.\r\n */\r\nexport const TARGET_STRATEGY_ORDER = [\r\n  \"testId\",\r\n  \"role\",\r\n  \"label\",\r\n  \"text\",\r\n  \"selector\",\r\n] as const;\r\n\r\nexport const TargetSchema = z\r\n  .object({\r\n    testId: z.string().min(1).optional(),\r\n    role: z.string().min(1).optional(),\r\n    name: z.string().min(1).optional(),\r\n    label: z.string().min(1).optional(),\r\n    text: z.string().min(1).optional(),\r\n    selector: z.string().min(1).optional(),\r\n  })\r\n  .strict()\r\n  .superRefine((value, ctx) => {\r\n    const hasStrategy =\r\n      !!value.testId || (!!value.role && !!value.name) || !!value.label || !!value.text || !!value.selector;\r\n    if (!hasStrategy) {\r\n      ctx.addIssue({\r\n        code: z.ZodIssueCode.custom,\r\n        message: \"Target must specify at least one of testId, role+name, label, text, or selector.\",\r\n      });\r\n    }\r\n    if (value.role && !value.name) {\r\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: [\"name\"], message: \"A role target also requires a name.\" });\r\n    }\r\n    if (value.name && !value.role) {\r\n      ctx.addIssue({ code: z.ZodIssueCode.custom, path: [\"role\"], message: \"A name target also requires a role.\" });\r\n    }\r\n  });\r\n\r\nexport type Target = z.infer<typeof TargetSchema>;\r\n","import { z } from \"zod\";\r\nimport { TargetSchema } from \"./target.js\";\r\n\r\nconst id = z.string().min(1);\r\nconst instruction = z.string().min(1);\r\nconst autoAdvance = z.boolean().optional();\r\n\r\nexport const ClickStepSchema = z\r\n  .object({ id, action: z.literal(\"click\"), target: TargetSchema, instruction, autoAdvance })\r\n  .strict();\r\n\r\nexport const InputStepSchema = z\r\n  .object({\r\n    id,\r\n    action: z.literal(\"input\"),\r\n    target: TargetSchema,\r\n    value: z.string(),\r\n    instruction,\r\n    autoAdvance,\r\n  })\r\n  .strict();\r\n\r\nexport const SelectStepSchema = z\r\n  .object({\r\n    id,\r\n    action: z.literal(\"select\"),\r\n    target: TargetSchema,\r\n    value: z.string(),\r\n    instruction,\r\n    autoAdvance,\r\n  })\r\n  .strict();\r\n\r\nexport const VerifyStepSchema = z\r\n  .object({ id, action: z.literal(\"verify\"), target: TargetSchema, instruction })\r\n  .strict();\r\n\r\nexport const NavigateStepSchema = z\r\n  .object({ id, action: z.literal(\"navigate\"), url: z.string().min(1), instruction })\r\n  .strict();\r\n\r\nexport const WaitStepSchema = z\r\n  .object({\r\n    id,\r\n    action: z.literal(\"wait\"),\r\n    target: TargetSchema.optional(),\r\n    timeoutMs: z.number().int().positive().optional(),\r\n    instruction,\r\n  })\r\n  .strict();\r\n\r\n/** Discriminated union keyed on `action`, so each step carries only the fields it needs. */\r\nexport const GuideStepSchema = z.discriminatedUnion(\"action\", [\r\n  ClickStepSchema,\r\n  InputStepSchema,\r\n  SelectStepSchema,\r\n  VerifyStepSchema,\r\n  NavigateStepSchema,\r\n  WaitStepSchema,\r\n]);\r\n\r\nexport type ClickStep = z.infer<typeof ClickStepSchema>;\r\nexport type InputStep = z.infer<typeof InputStepSchema>;\r\nexport type SelectStep = z.infer<typeof SelectStepSchema>;\r\nexport type VerifyStep = z.infer<typeof VerifyStepSchema>;\r\nexport type NavigateStep = z.infer<typeof NavigateStepSchema>;\r\nexport type WaitStep = z.infer<typeof WaitStepSchema>;\r\nexport type GuideStep = z.infer<typeof GuideStepSchema>;\r\nexport type GuideActionType = GuideStep[\"action\"];\r\n\r\nconst placementFields = {\r\n  before: z.string().min(1).optional(),\r\n  after: z.string().min(1).optional(),\r\n};\r\n\r\n/** A source-only step that is inserted relative to a step inherited from a base guide. */\r\nexport const AuthorGuideStepSchema = z.discriminatedUnion(\"action\", [\r\n  ClickStepSchema.extend(placementFields),\r\n  InputStepSchema.extend(placementFields),\r\n  SelectStepSchema.extend(placementFields),\r\n  VerifyStepSchema.extend(placementFields),\r\n  NavigateStepSchema.extend(placementFields),\r\n  WaitStepSchema.extend(placementFields),\r\n]);\r\n\r\nexport type AuthorGuideStep = z.infer<typeof AuthorGuideStepSchema>;\r\n","import { z } from \"zod\";\r\nimport { AuthorGuideStepSchema, GuideStepSchema } from \"./steps.js\";\r\n\r\n/**\r\n * `.passthrough()` keeps unknown top-level keys (e.g. future `meta` blocks used by\r\n * a browser recorder) so older guides stay forward-compatible without a schema bump.\r\n */\r\nexport const GuideSchema = z\r\n  .object({\r\n    id: z.string().min(1),\r\n    title: z.string().min(1),\r\n    application: z.string().min(1),\r\n    release: z.string().min(1),\r\n    start: z.object({ url: z.string().min(1) }).strict(),\r\n    steps: z.array(GuideStepSchema).min(1, \"A guide must contain at least one step.\"),\r\n  })\r\n  .passthrough();\r\n\r\nexport type Guide = z.infer<typeof GuideSchema>;\r\n\r\n/**\r\n * Authoring guides may extend another guide from the same release. Extension steps\r\n * are additive and must declare one stable insertion anchor.\r\n */\r\nexport const AuthorGuideSchema = z\r\n  .object({\r\n    id: z.string().min(1),\r\n    title: z.string().min(1),\r\n    application: z.string().min(1),\r\n    release: z.string().min(1),\r\n    start: z.object({ url: z.string().min(1) }).strict(),\r\n    extends: z.string().min(1).optional(),\r\n    steps: z.array(AuthorGuideStepSchema).min(1, \"A guide must contain at least one step.\"),\r\n  })\r\n  .passthrough()\r\n  .superRefine((guide, context) => {\r\n    guide.steps.forEach((step, index) => {\r\n      const hasBefore = step.before !== undefined;\r\n      const hasAfter = step.after !== undefined;\r\n\r\n      if (hasBefore && hasAfter) {\r\n        context.addIssue({\r\n          code: z.ZodIssueCode.custom,\r\n          path: [\"steps\", index],\r\n          message: \"An extension step must use either before or after, not both.\",\r\n        });\r\n      }\r\n\r\n      if (guide.extends && !hasBefore && !hasAfter) {\r\n        context.addIssue({\r\n          code: z.ZodIssueCode.custom,\r\n          path: [\"steps\", index],\r\n          message: \"An extension step must specify before or after.\",\r\n        });\r\n      }\r\n\r\n      if (!guide.extends && (hasBefore || hasAfter)) {\r\n        context.addIssue({\r\n          code: z.ZodIssueCode.custom,\r\n          path: [\"steps\", index],\r\n          message: \"before and after are only valid on a guide with extends.\",\r\n        });\r\n      }\r\n    });\r\n  });\r\n\r\nexport type AuthorGuide = z.infer<typeof AuthorGuideSchema>;\r\n","import { parse as parseYamlText } from \"yaml\";\r\nimport type { ZodError } from \"zod\";\r\nimport { AuthorGuideSchema, GuideSchema, type AuthorGuide, type Guide } from \"./guide.js\";\r\n\r\nexport interface GuideValidationIssue {\r\n  path: string;\r\n  message: string;\r\n}\r\n\r\nexport type GuideParseResult =\r\n  | { success: true; guide: Guide }\r\n  | { success: false; issues: GuideValidationIssue[] };\r\n\r\nexport type AuthorGuideParseResult =\r\n  | { success: true; guide: AuthorGuide }\r\n  | { success: false; issues: GuideValidationIssue[] };\r\n\r\nfunction formatPath(path: (string | number)[]): string {\r\n  if (path.length === 0) return \"(root)\";\r\n  let out = \"\";\r\n  for (const segment of path) {\r\n    if (typeof segment === \"number\") {\r\n      out += `[${segment}]`;\r\n    } else {\r\n      out += out ? `.${segment}` : segment;\r\n    }\r\n  }\r\n  return out;\r\n}\r\n\r\nexport function issuesFromZodError(error: ZodError): GuideValidationIssue[] {\r\n  return error.issues.map((issue) => {\r\n    const path = formatPath(issue.path);\r\n    const lastSegment = issue.path[issue.path.length - 1];\r\n    // Give the common \"missing target\" case from the spec a friendlier message.\r\n    if (lastSegment === \"target\" && issue.code === \"invalid_type\") {\r\n      return { path, message: \"Target is required.\" };\r\n    }\r\n    return { path, message: issue.message };\r\n  });\r\n}\r\n\r\nfunction parseData(raw: unknown): GuideParseResult {\r\n  const result = GuideSchema.safeParse(raw);\r\n  if (!result.success) {\r\n    return { success: false, issues: issuesFromZodError(result.error) };\r\n  }\r\n  return { success: true, guide: result.data };\r\n}\r\n\r\nfunction parseAuthorData(raw: unknown): AuthorGuideParseResult {\r\n  const result = AuthorGuideSchema.safeParse(raw);\r\n  if (!result.success) {\r\n    return { success: false, issues: issuesFromZodError(result.error) };\r\n  }\r\n  return { success: true, guide: result.data };\r\n}\r\n\r\nexport function parseGuideYaml(yamlText: string): GuideParseResult {\r\n  let raw: unknown;\r\n  try {\r\n    raw = parseYamlText(yamlText);\r\n  } catch (error) {\r\n    return {\r\n      success: false,\r\n      issues: [\r\n        { path: \"(yaml)\", message: error instanceof Error ? error.message : \"Invalid YAML.\" },\r\n      ],\r\n    };\r\n  }\r\n  return parseData(raw);\r\n}\r\n\r\nexport function parseAuthorGuideYaml(yamlText: string): AuthorGuideParseResult {\r\n  let raw: unknown;\r\n  try {\r\n    raw = parseYamlText(yamlText);\r\n  } catch (error) {\r\n    return {\r\n      success: false,\r\n      issues: [\r\n        { path: \"(yaml)\", message: error instanceof Error ? error.message : \"Invalid YAML.\" },\r\n      ],\r\n    };\r\n  }\r\n  return parseAuthorData(raw);\r\n}\r\n\r\nexport function parseGuideJson(jsonText: string): GuideParseResult {\r\n  let raw: unknown;\r\n  try {\r\n    raw = JSON.parse(jsonText);\r\n  } catch (error) {\r\n    return {\r\n      success: false,\r\n      issues: [\r\n        { path: \"(json)\", message: error instanceof Error ? error.message : \"Invalid JSON.\" },\r\n      ],\r\n    };\r\n  }\r\n  return parseData(raw);\r\n}\r\n","import { GuideSchema, type AuthorGuide, type Guide } from \"./guide.js\";\r\nimport type { GuideStep } from \"./steps.js\";\r\n\r\nexport interface GuideResolutionIssue {\r\n  path: string;\r\n  message: string;\r\n}\r\n\r\nexport type GuideResolutionResult =\r\n  | { success: true; guide: Guide }\r\n  | { success: false; issues: GuideResolutionIssue[] };\r\n\r\nfunction withoutPlacement(step: AuthorGuide[\"steps\"][number]): GuideStep {\r\n  const { before: _before, after: _after, ...runtimeStep } = step;\r\n  return runtimeStep as GuideStep;\r\n}\r\n\r\nfunction duplicateStepIssue(steps: GuideStep[]): GuideResolutionIssue | undefined {\r\n  const ids = new Set<string>();\r\n  for (const step of steps) {\r\n    if (ids.has(step.id)) {\r\n      return { path: \"steps\", message: `Duplicate step id: ${step.id}.` };\r\n    }\r\n    ids.add(step.id);\r\n  }\r\n  return undefined;\r\n}\r\n\r\nfunction runtimeGuideData(guide: AuthorGuide, steps: GuideStep[]): Omit<AuthorGuide, \"extends\" | \"steps\"> & { steps: GuideStep[] } {\r\n  const { extends: _extends, steps: _steps, ...runtimeGuide } = guide;\r\n  return { ...runtimeGuide, steps };\r\n}\r\n\r\n/** Resolves an authoring guide and all of its same-release bases into a runtime guide. */\r\nexport function resolveGuide(\r\n  guide: AuthorGuide,\r\n  guidesById: ReadonlyMap<string, AuthorGuide>,\r\n  resolving = new Set<string>(),\r\n): GuideResolutionResult {\r\n  if (resolving.has(guide.id)) {\r\n    return { success: false, issues: [{ path: \"extends\", message: \"Guide inheritance cycle detected.\" }] };\r\n  }\r\n\r\n  if (!guide.extends) {\r\n    const steps = guide.steps.map(withoutPlacement);\r\n    const duplicateIssue = duplicateStepIssue(steps);\r\n    if (duplicateIssue) return { success: false, issues: [duplicateIssue] };\r\n    const parsed = GuideSchema.safeParse(runtimeGuideData(guide, steps));\r\n    return parsed.success\r\n      ? { success: true, guide: parsed.data }\r\n      : { success: false, issues: parsed.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message })) };\r\n  }\r\n\r\n  const base = guidesById.get(guide.extends);\r\n  if (!base) {\r\n    return { success: false, issues: [{ path: \"extends\", message: `Base guide not found: ${guide.extends}.` }] };\r\n  }\r\n  if (guide.release !== base.release || guide.application !== base.application) {\r\n    return {\r\n      success: false,\r\n      issues: [{ path: \"extends\", message: \"An extension must match its base guide's release and application.\" }],\r\n    };\r\n  }\r\n\r\n  const nextResolving = new Set(resolving);\r\n  nextResolving.add(guide.id);\r\n  const baseResult = resolveGuide(base, guidesById, nextResolving);\r\n  if (!baseResult.success) return baseResult;\r\n\r\n  const steps = [...baseResult.guide.steps];\r\n  for (const extensionStep of guide.steps) {\r\n    const anchorId = extensionStep.before ?? extensionStep.after;\r\n    const anchorIndex = steps.findIndex((step) => step.id === anchorId);\r\n    if (anchorIndex === -1) {\r\n      return { success: false, issues: [{ path: \"steps\", message: `Anchor step not found: ${anchorId}.` }] };\r\n    }\r\n    steps.splice(extensionStep.before ? anchorIndex : anchorIndex + 1, 0, withoutPlacement(extensionStep));\r\n  }\r\n\r\n  const duplicateIssue = duplicateStepIssue(steps);\r\n  if (duplicateIssue) return { success: false, issues: [duplicateIssue] };\r\n  const parsed = GuideSchema.safeParse(runtimeGuideData(guide, steps));\r\n  return parsed.success\r\n    ? { success: true, guide: parsed.data }\r\n    : { success: false, issues: parsed.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message })) };\r\n}"],"mappings":"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","names":["z","z","z","z","steps","duplicateIssue","parsed"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@trail-cli/guide-schema",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ndivhomakhuvha/trail.git"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "yaml": "^2.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.4",
+    "typescript": "^5.5.4"
+  }
+}