@algomotion/spec 0.0.0-stage → 1.0.0-alpha.1

package/dist/visualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../src/visualization.ts"],"names":[],"mappings":"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"}

package/dist/visualization.js

@@ -0,0 +1,131 @@
+/**
+ * Top-level document schemas.
+ *
+ * Two forms exist (ADR 0007):
+ * - `VisualizationInput` is what people and LLMs write; it allows shorthands.
+ * - `Visualization` is the canonical form that `parseVisualization` returns
+ *   and that renderers consume.
+ */
+import { z } from 'zod';
+import { AnchoredSource, LIMITS, Section, Source, StepMeta, StructureName, } from "./common.js";
+import { ArrayAction, ArrayActionInput, ArrayDecl, ArrayDeclInput, LinkedListAction, LinkedListActionInput, LinkedListDecl, LinkedListDeclInput, QueueAction, QueueActionInput, QueueDecl, QueueDeclInput, StackAction, StackActionInput, StackDecl, StackDeclInput, TreeAction, TreeActionInput, TreeDecl, TreeDeclInput, GraphAction, GraphActionInput, GraphDecl, GraphDeclInput, HashTableAction, HashTableActionInput, HashTableDecl, HashTableDeclInput, PriorityQueueAction, PriorityQueueActionInput, PriorityQueueDecl, PriorityQueueDeclInput, BTreeAction, BTreeActionInput, BTreeDecl, BTreeDeclInput, PlaneAction, PlaneActionInput, PlaneDecl, PlaneDeclInput, TableAction, TableDecl, TableDeclInput, } from "./kinds/index.js";
+import { PROTOCOL_VERSIONS } from "./version.js";
+const targetField = {
+    target: StructureName.describe('Name of the structure this action applies to.'),
+};
+const withTargets = (options) => options.map((option) => option.extend(targetField));
+/*
+ * One entry per kind (ADR 0012). Kinds may share action names (`highlight`
+ * exists for arrays and graphs with different fields), so the top level is a
+ * plain union of per-kind unions; the parser picks the right one by the
+ * target's kind.
+ */
+/** Any built-in action in canonical form, tagged with its structure. */
+export const TargetedAction = z.union([
+    z.discriminatedUnion('type', withTargets(ArrayAction.options)),
+    z.discriminatedUnion('type', withTargets(StackAction.options)),
+    z.discriminatedUnion('type', withTargets(QueueAction.options)),
+    z.discriminatedUnion('type', withTargets(LinkedListAction.options)),
+    z.discriminatedUnion('type', withTargets(TreeAction.options)),
+    z.discriminatedUnion('type', withTargets(GraphAction.options)),
+    z.discriminatedUnion('type', withTargets(TableAction.options)),
+    z.discriminatedUnion('type', withTargets(HashTableAction.options)),
+    z.discriminatedUnion('type', withTargets(PriorityQueueAction.options)),
+    z.discriminatedUnion('type', withTargets(BTreeAction.options)),
+    z.discriminatedUnion('type', withTargets(PlaneAction.options)),
+]);
+/** Any built-in action in authoring form, tagged with its structure. */
+export const TargetedActionInput = z.union([
+    z.discriminatedUnion('type', withTargets(ArrayActionInput.options)),
+    z.discriminatedUnion('type', withTargets(StackActionInput.options)),
+    z.discriminatedUnion('type', withTargets(QueueActionInput.options)),
+    z.discriminatedUnion('type', withTargets(LinkedListActionInput.options)),
+    z.discriminatedUnion('type', withTargets(TreeActionInput.options)),
+    z.discriminatedUnion('type', withTargets(GraphActionInput.options)),
+    z.discriminatedUnion('type', withTargets(TableAction.options)),
+    z.discriminatedUnion('type', withTargets(HashTableActionInput.options)),
+    z.discriminatedUnion('type', withTargets(PriorityQueueActionInput.options)),
+    z.discriminatedUnion('type', withTargets(BTreeActionInput.options)),
+    z.discriminatedUnion('type', withTargets(PlaneActionInput.options)),
+]);
+export const StructureDecl = z.discriminatedUnion('kind', [
+    ArrayDecl,
+    StackDecl,
+    QueueDecl,
+    LinkedListDecl,
+    TreeDecl,
+    GraphDecl,
+    TableDecl,
+    HashTableDecl,
+    PriorityQueueDecl,
+    BTreeDecl,
+    PlaneDecl,
+]);
+export const StructureDeclInput = z.discriminatedUnion('kind', [
+    ArrayDeclInput,
+    StackDeclInput,
+    QueueDeclInput,
+    LinkedListDeclInput,
+    TreeDeclInput,
+    GraphDeclInput,
+    TableDeclInput,
+    HashTableDeclInput,
+    PriorityQueueDeclInput,
+    BTreeDeclInput,
+    PlaneDeclInput,
+]);
+const steps = (action) => z
+    .array(z
+    .strictObject({
+    actions: z
+        .array(action)
+        .max(LIMITS.actionsPerStep)
+        .describe('Actions applied in order; a step may have none and only narrate.'),
+    meta: StepMeta.optional(),
+})
+    .describe('One point on the timeline the learner can step to.'))
+    .max(LIMITS.steps);
+const structures = (decl) => z
+    .record(StructureName, decl)
+    .refine((r) => Object.keys(r).length > 0, {
+    message: 'Declare at least one structure',
+})
+    .refine((r) => Object.keys(r).length <= LIMITS.structures, {
+    message: `Declare at most ${LIMITS.structures} structures`,
+})
+    .describe('Structures shown in the visualization, keyed by name.')
+    // The refinements above are invisible to JSON Schema; state them there too.
+    .meta({ minProperties: 1, maxProperties: LIMITS.structures });
+const document = (decl, action) => z
+    .strictObject({
+    version: z
+        .enum(PROTOCOL_VERSIONS)
+        .describe('Protocol version, "major.minor": the oldest version that has every feature the document uses. Readers also accept a 0.x version and read the document as 1.0; this schema lists only the versions to write.'),
+    title: z.string().max(LIMITS.textLength).optional(),
+    source: Source.optional(),
+    sources: z
+        .array(AnchoredSource)
+        .min(1)
+        .max(LIMITS.sources)
+        .optional()
+        .describe('The code in one or more languages, one entry per language, instead of `source`. Steps point into every language at once with `meta.at`.'),
+    structures: structures(decl),
+    steps: steps(action),
+    sections: z
+        .array(Section)
+        .max(LIMITS.sections)
+        .optional()
+        .describe('Sections in order of their first step, e.g. one per operation. Steps before the first section belong to none.'),
+})
+    // The parser reports both with its own error; state the rule for JSON
+    // Schema validators too.
+    .meta({ not: { required: ['source', 'sources'] } });
+export const Visualization = document(StructureDecl, TargetedAction).describe('A step-by-step visualization in canonical form.');
+export const VisualizationInput = document(StructureDeclInput, TargetedActionInput).describe('A step-by-step visualization: declared structures plus a timeline of steps, each applying actions to those structures.');
+/**
+ * First-pass schema used by the parser: actions are only checked for
+ * `target` and `type`, so that their payload can then be validated against
+ * the schema of the target's kind with precise error messages.
+ */
+export const Envelope = document(StructureDeclInput, z.looseObject({ target: StructureName, type: z.string().min(1) }));
+//# sourceMappingURL=visualization.js.map

package/dist/visualization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualization.js","sourceRoot":"","sources":["../src/visualization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,cAAc,EACd,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,EACR,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,QAAQ,EACR,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAC5B,+CAA+C,CAChD;CACF,CAAC;AAaF,MAAM,WAAW,GAAG,CAAyC,OAAU,EAAE,EAAE,CACzE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAkB,CAAC;AAEvE;;;;;GAKG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/D,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC;IACzC,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;CACpE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,SAAS;IACT,SAAS;IACT,SAAS;IACT,cAAc;IACd,QAAQ;IACR,SAAS;IACT,SAAS;IACT,aAAa;IACb,iBAAiB;IACjB,SAAS;IACT,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC7D,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,sBAAsB;IACtB,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,KAAK,GAAG,CAAsB,MAAS,EAAE,EAAE,CAC/C,CAAC;KACE,KAAK,CACJ,CAAC;KACE,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC;SAC1B,QAAQ,CACP,kEAAkE,CACnE;IACH,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;CAC1B,CAAC;KACD,QAAQ,CAAC,oDAAoD,CAAC,CAClE;KACA,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEvB,MAAM,UAAU,GAAG,CAAsB,IAAO,EAAE,EAAE,CAClD,CAAC;KACE,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC;KAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;IACxC,OAAO,EAAE,gCAAgC;CAC1C,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE;IACzD,OAAO,EAAE,mBAAmB,MAAM,CAAC,UAAU,aAAa;CAC3D,CAAC;KACD,QAAQ,CAAC,uDAAuD,CAAC;IAClE,4EAA4E;KAC3E,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;AAElE,MAAM,QAAQ,GAAG,CACf,IAAO,EACP,MAAS,EACT,EAAE,CACF,CAAC;KACE,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,iBAAiB,CAAC;SACvB,QAAQ,CACP,6MAA6M,CAC9M;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;IACzB,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,yIAAyI,CAC1I;IACH,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CACP,+GAA+G,CAChH;CACJ,CAAC;IACF,sEAAsE;IACtE,yBAAyB;KACxB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,QAAQ,CAC3E,iDAAiD,CAClD,CAAC;AAIF,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CACxC,kBAAkB,EAClB,mBAAmB,CACpB,CAAC,QAAQ,CACR,wHAAwH,CACzH,CAAC;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAC9B,kBAAkB,EAClB,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAClE,CAAC"}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@algomotion/spec",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-alpha.1",
+  "description": "Protocol schemas, types and validation for algomotion traces.",
+  "keywords": [
+    "algorithms",
+    "visualization",
+    "education",
+    "schema",
+    "protocol"
+  ],
+  "license": "GPL-3.0-or-later",
+  "homepage": "https://algomotion.turing2234.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Eryc123Y/algorithm-visualizer.git",
+    "directory": "packages/spec"
+  },
+  "bugs": {
+    "url": "https://github.com/Eryc123Y/algorithm-visualizer/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "@algomotion/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./visualization.schema.json": "./schema/visualization.schema.json"
+  },
+  "files": [
+    "dist",
+    "schema"
+  ],
+  "scripts": {
+    "build": "tsc --build tsconfig.lib.json",
+    "generate:schema": "node scripts/generate-schema.ts"
+  },
+  "dependencies": {
+    "zod": "^4.6.7"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  }
+}