@miragon/team-topologies-schema-model 0.1.0

package/dist/index.js

@@ -0,0 +1,404 @@
+import { z } from 'zod';
+import { nanoid } from 'nanoid';
+
+// src/types.ts
+var DND_MIME = "application/x-tt-team-type";
+var TEAM_TYPES = [
+  "stream-aligned",
+  "enabling",
+  "complicated-subsystem",
+  "platform"
+];
+var INTERACTION_MODES = [
+  "collaboration",
+  "x-as-a-service",
+  "facilitating"
+];
+var DOCUMENT_VERSION = 2;
+
+// src/notation.ts
+var TEAM_TYPE_SPECS = {
+  "stream-aligned": {
+    type: "stream-aligned",
+    label: "Stream-aligned",
+    description: "Aligned to a single, valuable stream of work; owns it end-to-end.",
+    shape: "rounded-rect-horizontal",
+    fill: "#FFEDB8",
+    stroke: "#FFD966",
+    strokeStyle: "solid",
+    strokeWidth: 2,
+    defaultSize: { width: 240, height: 96 },
+    minSize: { width: 140, height: 64 }
+  },
+  enabling: {
+    type: "enabling",
+    label: "Enabling",
+    description: "Helps stream-aligned teams acquire missing capabilities; coaches, then steps back.",
+    shape: "rounded-rect-vertical",
+    fill: "#DFBDCF",
+    stroke: "#D09CB7",
+    strokeStyle: "solid",
+    strokeWidth: 2,
+    defaultSize: { width: 120, height: 200 },
+    minSize: { width: 80, height: 120 }
+  },
+  "complicated-subsystem": {
+    type: "complicated-subsystem",
+    label: "Complicated Subsystem",
+    description: "Owns a part of the system needing deep specialist knowledge, reducing others' cognitive load.",
+    shape: "octagon",
+    fill: "#FFC08B",
+    stroke: "#E88814",
+    strokeStyle: "solid",
+    strokeWidth: 2,
+    defaultSize: { width: 170, height: 150 },
+    minSize: { width: 110, height: 100 }
+  },
+  platform: {
+    type: "platform",
+    label: "Platform",
+    description: "Provides internal self-service capabilities to reduce cognitive load for stream-aligned teams.",
+    shape: "rect",
+    fill: "#B7CDF1",
+    stroke: "#6D9EEB",
+    strokeStyle: "solid",
+    strokeWidth: 2,
+    defaultSize: { width: 380, height: 130 },
+    minSize: { width: 200, height: 90 }
+  }
+};
+var INTERACTION_MODE_SPECS = {
+  collaboration: {
+    mode: "collaboration",
+    label: "Collaboration",
+    description: "Two teams work closely together for a defined period; high overhead, high discovery.",
+    shape: "parallelogram",
+    fill: "#C6BEDF",
+    stroke: "#967EE2",
+    strokeStyle: "dashed",
+    strokeWidth: 2,
+    opacity: 0.5,
+    directional: false,
+    defaultSize: { width: 112, height: 72 },
+    minSize: { width: 60, height: 44 }
+  },
+  "x-as-a-service": {
+    mode: "x-as-a-service",
+    label: "X-as-a-Service",
+    description: "One team consumes something the other provides 'as a service'; minimal collaboration.",
+    shape: "triangle",
+    fill: "#B4B4B4",
+    stroke: "#999696",
+    strokeStyle: "dashed",
+    strokeWidth: 2,
+    opacity: 0.5,
+    directional: true,
+    defaultSize: { width: 88, height: 78 },
+    minSize: { width: 54, height: 48 }
+  },
+  facilitating: {
+    mode: "facilitating",
+    label: "Facilitating",
+    description: "One team helps/coaches another to clear impediments and learn; sensing and discovery.",
+    shape: "circle",
+    fill: "#C9DFBE",
+    stroke: "#78996B",
+    strokeStyle: "dashed",
+    strokeWidth: 2,
+    opacity: 0.5,
+    directional: false,
+    defaultSize: { width: 84, height: 84 },
+    minSize: { width: 48, height: 48 }
+  }
+};
+var FLOW_SPEC = {
+  label: "Flow of change",
+  fill: "transparent",
+  stroke: "#6b6459",
+  strokeStyle: "dashed",
+  strokeWidth: 2,
+  defaultSize: { width: 520, height: 64 },
+  minSize: { width: 160, height: 36 }
+};
+function dashArray(style, strokeWidth = 2) {
+  switch (style) {
+    case "dashed":
+      return `${strokeWidth * 3} ${strokeWidth * 2}`;
+    case "dotted":
+      return `${strokeWidth} ${strokeWidth * 1.5}`;
+    case "solid":
+    default:
+      return "";
+  }
+}
+var ALL_TEAM_SPECS = Object.values(TEAM_TYPE_SPECS);
+var ALL_INTERACTION_SPECS = Object.values(INTERACTION_MODE_SPECS);
+var teamTypeSchema = z.enum(TEAM_TYPES);
+var interactionModeSchema = z.enum(INTERACTION_MODES);
+var sizeSchema = z.object({
+  width: z.number().finite().positive(),
+  height: z.number().finite().positive()
+});
+var positionSchema = z.object({
+  x: z.number().finite(),
+  y: z.number().finite()
+});
+var hexColor = z.string().regex(/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/, "expected a hex colour");
+var teamNodeSchema = z.object({
+  id: z.string().min(1),
+  type: teamTypeSchema,
+  label: z.string(),
+  description: z.string().optional(),
+  position: positionSchema,
+  size: sizeSchema,
+  fill: hexColor.optional(),
+  stroke: hexColor.optional()
+});
+var interactionSchema = z.object({
+  id: z.string().min(1),
+  mode: interactionModeSchema,
+  label: z.string().optional(),
+  position: positionSchema,
+  size: sizeSchema,
+  fill: hexColor.optional(),
+  stroke: hexColor.optional()
+});
+var flowSchema = z.object({
+  id: z.string().min(1),
+  label: z.string().optional(),
+  position: positionSchema,
+  size: sizeSchema
+});
+var documentSchema = z.object({
+  version: z.literal(DOCUMENT_VERSION),
+  title: z.string(),
+  nodes: z.array(teamNodeSchema),
+  interactions: z.array(interactionSchema),
+  flows: z.array(flowSchema)
+});
+function parseDocument(input) {
+  const migrated = migrate(input);
+  const result = documentSchema.safeParse(migrated);
+  if (!result.success) {
+    return {
+      ok: false,
+      error: result.error.issues.map((i2) => `${i2.path.join(".") || "(root)"}: ${i2.message}`).join("; ")
+    };
+  }
+  return { ok: true, document: result.data };
+}
+function migrate(input) {
+  if (input == null || typeof input !== "object") return input;
+  const doc = input;
+  const next = { ...doc };
+  delete next.showFlowOfChange;
+  next.version = DOCUMENT_VERSION;
+  if (typeof next.title !== "string") next.title = "Untitled team topology";
+  if (!Array.isArray(next.nodes)) next.nodes = [];
+  next.interactions = Array.isArray(next.interactions) ? next.interactions.filter(
+    (e) => e != null && typeof e === "object" && "position" in e && "size" in e
+  ) : [];
+  if (!Array.isArray(next.flows)) next.flows = [];
+  return next;
+}
+
+// src/serialize.ts
+function round(n) {
+  return Math.round(n * 100) / 100;
+}
+function normPosition(p) {
+  return { x: round(p.x), y: round(p.y) };
+}
+function normSize(s2) {
+  return { width: round(s2.width), height: round(s2.height) };
+}
+function normNode(n) {
+  const out = {
+    id: n.id,
+    type: n.type,
+    label: n.label,
+    position: normPosition(n.position),
+    size: normSize(n.size)
+  };
+  if (n.description) out.description = n.description;
+  if (n.fill) out.fill = n.fill;
+  if (n.stroke) out.stroke = n.stroke;
+  return out;
+}
+function normInteraction(e) {
+  const out = {
+    id: e.id,
+    mode: e.mode,
+    position: normPosition(e.position),
+    size: normSize(e.size)
+  };
+  if (e.label) out.label = e.label;
+  if (e.fill) out.fill = e.fill;
+  if (e.stroke) out.stroke = e.stroke;
+  return out;
+}
+function normFlow(f) {
+  const out = {
+    id: f.id,
+    position: normPosition(f.position),
+    size: normSize(f.size)
+  };
+  if (f.label) out.label = f.label;
+  return out;
+}
+var byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+function canonicalize(doc) {
+  return {
+    version: DOCUMENT_VERSION,
+    title: doc.title,
+    nodes: [...doc.nodes].map(normNode).sort(byId),
+    interactions: [...doc.interactions].map(normInteraction).sort(byId),
+    flows: [...doc.flows].map(normFlow).sort(byId)
+  };
+}
+function serializeDocument(doc, pretty = true) {
+  const canonical = canonicalize(doc);
+  return JSON.stringify(canonical, null, pretty ? 2 : 0);
+}
+function newId(prefix) {
+  return `${prefix}_${nanoid(8)}`;
+}
+function createTeamNode(type, position, overrides = {}) {
+  const spec = TEAM_TYPE_SPECS[type];
+  return {
+    id: newId("team"),
+    type,
+    label: overrides.label ?? spec.label,
+    description: overrides.description,
+    position,
+    size: overrides.size ?? { ...spec.defaultSize },
+    fill: overrides.fill,
+    stroke: overrides.stroke
+  };
+}
+function createInteractionShape(mode, position, overrides = {}) {
+  const spec = INTERACTION_MODE_SPECS[mode];
+  return {
+    id: newId("int"),
+    mode,
+    position,
+    size: overrides.size ?? { ...spec.defaultSize },
+    label: overrides.label,
+    fill: overrides.fill,
+    stroke: overrides.stroke
+  };
+}
+function createFlowShape(position, overrides = {}) {
+  return {
+    id: newId("flow"),
+    position,
+    size: overrides.size ?? { ...FLOW_SPEC.defaultSize },
+    label: overrides.label ?? FLOW_SPEC.label
+  };
+}
+function emptyDocument(title = "Untitled team topology") {
+  return {
+    version: DOCUMENT_VERSION,
+    title,
+    nodes: [],
+    interactions: [],
+    flows: []
+  };
+}
+
+// src/sample.ts
+var s = TEAM_TYPE_SPECS;
+var i = INTERACTION_MODE_SPECS;
+var SAMPLE_DOCUMENT = {
+  version: DOCUMENT_VERSION,
+  title: "Online retail \u2014 team topology",
+  nodes: [
+    {
+      id: "team_enabling",
+      type: "enabling",
+      label: "Agile Enablement",
+      description: "Coaches teams on testing and continuous delivery practices.",
+      position: { x: 60, y: 150 },
+      size: { ...s.enabling.defaultSize }
+    },
+    {
+      id: "team_checkout",
+      type: "stream-aligned",
+      label: "Checkout Stream",
+      description: "Owns the end-to-end checkout & payments journey.",
+      position: { x: 320, y: 110 },
+      size: { ...s["stream-aligned"].defaultSize }
+    },
+    {
+      id: "team_mobile",
+      type: "stream-aligned",
+      label: "Mobile Experience",
+      description: "Owns the native mobile shopping experience.",
+      position: { x: 700, y: 110 },
+      size: { ...s["stream-aligned"].defaultSize }
+    },
+    {
+      id: "team_fraud",
+      type: "complicated-subsystem",
+      label: "Risk & Fraud Engine",
+      description: "Specialist ML team owning real-time fraud scoring.",
+      position: { x: 740, y: 320 },
+      size: { ...s["complicated-subsystem"].defaultSize }
+    },
+    {
+      id: "team_platform",
+      type: "platform",
+      label: "Internal Developer Platform",
+      description: "Self-service CI/CD, observability and runtime for all streams.",
+      position: { x: 300, y: 540 },
+      size: { ...s.platform.defaultSize }
+    }
+  ],
+  interactions: [
+    {
+      id: "int_enable_checkout",
+      mode: "facilitating",
+      label: "test automation",
+      position: { x: 212, y: 158 },
+      size: { ...i.facilitating.defaultSize }
+    },
+    {
+      id: "int_checkout_fraud",
+      mode: "collaboration",
+      label: "fraud rules discovery",
+      position: { x: 566, y: 232 },
+      size: { ...i.collaboration.defaultSize }
+    },
+    {
+      id: "int_platform_checkout",
+      mode: "x-as-a-service",
+      position: { x: 384, y: 396 },
+      size: { ...i["x-as-a-service"].defaultSize }
+    },
+    {
+      id: "int_platform_mobile",
+      mode: "x-as-a-service",
+      position: { x: 612, y: 396 },
+      size: { ...i["x-as-a-service"].defaultSize }
+    },
+    {
+      id: "int_fraud_mobile",
+      mode: "x-as-a-service",
+      label: "risk scoring API",
+      position: { x: 800, y: 238 },
+      size: { ...i["x-as-a-service"].defaultSize }
+    }
+  ],
+  flows: [
+    {
+      id: "flow_main",
+      label: "Flow of change",
+      position: { x: 60, y: 712 },
+      size: { width: 880, height: 60 }
+    }
+  ]
+};
+
+export { ALL_INTERACTION_SPECS, ALL_TEAM_SPECS, DND_MIME, DOCUMENT_VERSION, FLOW_SPEC, INTERACTION_MODES, INTERACTION_MODE_SPECS, SAMPLE_DOCUMENT, TEAM_TYPES, TEAM_TYPE_SPECS, canonicalize, createFlowShape, createInteractionShape, createTeamNode, dashArray, documentSchema, emptyDocument, flowSchema, interactionSchema, newId, parseDocument, serializeDocument, teamNodeSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/notation.ts","../src/schema.ts","../src/serialize.ts","../src/factory.ts","../src/sample.ts"],"names":["i","s"],"mappings":";;;;AASO,IAAM,QAAA,GAAW;AAKjB,IAAM,UAAA,GAAkC;AAAA,EAC7C,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,uBAAA;AAAA,EACA;AACF;AAKO,IAAM,iBAAA,GAAgD;AAAA,EAC3D,eAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF;AAyDO,IAAM,gBAAA,GAAmB;;;ACdzB,IAAM,eAAA,GAAkD;AAAA,EAC7D,gBAAA,EAAkB;AAAA,IAChB,IAAA,EAAM,gBAAA;AAAA,IACN,KAAA,EAAO,gBAAA;AAAA,IACP,WAAA,EAAa,mEAAA;AAAA,IACb,KAAA,EAAO,yBAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,OAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA,EAAG;AAAA,IACtC,OAAA,EAAS,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA;AAAG,GACpC;AAAA,EACA,QAAA,EAAU;AAAA,IACR,IAAA,EAAM,UAAA;AAAA,IACN,KAAA,EAAO,UAAA;AAAA,IACP,WAAA,EACE,oFAAA;AAAA,IACF,KAAA,EAAO,uBAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,OAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,GAAA,EAAI;AAAA,IACvC,OAAA,EAAS,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,GAAA;AAAI,GACpC;AAAA,EACA,uBAAA,EAAyB;AAAA,IACvB,IAAA,EAAM,uBAAA;AAAA,IACN,KAAA,EAAO,uBAAA;AAAA,IACP,WAAA,EACE,+FAAA;AAAA,IACF,KAAA,EAAO,SAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,OAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,GAAA,EAAI;AAAA,IACvC,OAAA,EAAS,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,GAAA;AAAI,GACrC;AAAA,EACA,QAAA,EAAU;AAAA,IACR,IAAA,EAAM,UAAA;AAAA,IACN,KAAA,EAAO,UAAA;AAAA,IACP,WAAA,EACE,gGAAA;AAAA,IACF,KAAA,EAAO,MAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,OAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,GAAA,EAAI;AAAA,IACvC,OAAA,EAAS,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA;AAAG;AAEtC;AAEO,IAAM,sBAAA,GAAuE;AAAA,EAClF,aAAA,EAAe;AAAA,IACb,IAAA,EAAM,eAAA;AAAA,IACN,KAAA,EAAO,eAAA;AAAA,IACP,WAAA,EACE,sFAAA;AAAA,IACF,KAAA,EAAO,eAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,QAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,OAAA,EAAS,GAAA;AAAA,IACT,WAAA,EAAa,KAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA,EAAG;AAAA,IACtC,OAAA,EAAS,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,EAAA;AAAG,GACnC;AAAA,EACA,gBAAA,EAAkB;AAAA,IAChB,IAAA,EAAM,gBAAA;AAAA,IACN,KAAA,EAAO,gBAAA;AAAA,IACP,WAAA,EACE,uFAAA;AAAA,IACF,KAAA,EAAO,UAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,QAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,OAAA,EAAS,GAAA;AAAA,IACT,WAAA,EAAa,IAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,EAAA,EAAG;AAAA,IACrC,OAAA,EAAS,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,EAAA;AAAG,GACnC;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,IAAA,EAAM,cAAA;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,WAAA,EACE,uFAAA;AAAA,IACF,KAAA,EAAO,QAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,WAAA,EAAa,QAAA;AAAA,IACb,WAAA,EAAa,CAAA;AAAA,IACb,OAAA,EAAS,GAAA;AAAA,IACT,WAAA,EAAa,KAAA;AAAA,IACb,WAAA,EAAa,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,EAAA,EAAG;AAAA,IACrC,OAAA,EAAS,EAAE,KAAA,EAAO,EAAA,EAAI,QAAQ,EAAA;AAAG;AAErC;AAMO,IAAM,SAAA,GAAsB;AAAA,EACjC,KAAA,EAAO,gBAAA;AAAA,EACP,IAAA,EAAM,aAAA;AAAA,EACN,MAAA,EAAQ,SAAA;AAAA,EACR,WAAA,EAAa,QAAA;AAAA,EACb,WAAA,EAAa,CAAA;AAAA,EACb,WAAA,EAAa,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA,EAAG;AAAA,EACtC,OAAA,EAAS,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA;AACjC;AAGO,SAAS,SAAA,CAAU,KAAA,EAAoB,WAAA,GAAc,CAAA,EAAW;AACrE,EAAA,QAAQ,KAAA;AAAO,IACb,KAAK,QAAA;AACH,MAAA,OAAO,CAAA,EAAG,WAAA,GAAc,CAAC,CAAA,CAAA,EAAI,cAAc,CAAC,CAAA,CAAA;AAAA,IAC9C,KAAK,QAAA;AACH,MAAA,OAAO,CAAA,EAAG,WAAW,CAAA,CAAA,EAAI,WAAA,GAAc,GAAG,CAAA,CAAA;AAAA,IAC5C,KAAK,OAAA;AAAA,IACL;AACE,MAAA,OAAO,EAAA;AAAA;AAEb;AAEO,IAAM,cAAA,GAA0C,MAAA,CAAO,MAAA,CAAO,eAAe;AAC7E,IAAM,qBAAA,GACX,MAAA,CAAO,MAAA,CAAO,sBAAsB;AC9LtC,IAAM,cAAA,GAAiB,CAAA,CAAE,IAAA,CAAK,UAA8C,CAAA;AAC5E,IAAM,qBAAA,GAAwB,CAAA,CAAE,IAAA,CAAK,iBAAqD,CAAA;AAE1F,IAAM,UAAA,GAAa,EAAE,MAAA,CAAO;AAAA,EAC1B,OAAO,CAAA,CAAE,MAAA,EAAO,CAAE,MAAA,GAAS,QAAA,EAAS;AAAA,EACpC,QAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,MAAA,GAAS,QAAA;AAC9B,CAAC,CAAA;AAED,IAAM,cAAA,GAAiB,EAAE,MAAA,CAAO;AAAA,EAC9B,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,MAAA,EAAO;AAAA,EACrB,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,MAAA;AAChB,CAAC,CAAA;AAED,IAAM,WAAW,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,wCAAwC,uBAAuB,CAAA;AAE1F,IAAM,cAAA,GAAiB,EAAE,MAAA,CAAO;AAAA,EACrC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACpB,IAAA,EAAM,cAAA;AAAA,EACN,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,EAChB,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAU,cAAA;AAAA,EACV,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,SAAS,QAAA,EAAS;AAAA,EACxB,MAAA,EAAQ,SAAS,QAAA;AACnB,CAAC;AAEM,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA,EACxC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACpB,IAAA,EAAM,qBAAA;AAAA,EACN,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,QAAA,EAAU,cAAA;AAAA,EACV,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,SAAS,QAAA,EAAS;AAAA,EACxB,MAAA,EAAQ,SAAS,QAAA;AACnB,CAAC;AAEM,IAAM,UAAA,GAAa,EAAE,MAAA,CAAO;AAAA,EACjC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACpB,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,QAAA,EAAU,cAAA;AAAA,EACV,IAAA,EAAM;AACR,CAAC;AAEM,IAAM,cAAA,GAAiB,EAAE,MAAA,CAAO;AAAA,EACrC,OAAA,EAAS,CAAA,CAAE,OAAA,CAAQ,gBAAgB,CAAA;AAAA,EACnC,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,EAChB,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,cAAc,CAAA;AAAA,EAC7B,YAAA,EAAc,CAAA,CAAE,KAAA,CAAM,iBAAiB,CAAA;AAAA,EACvC,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,UAAU;AAC3B,CAAC;AASM,SAAS,cAAc,KAAA,EAA6B;AACzD,EAAA,MAAM,QAAA,GAAW,QAAQ,KAAK,CAAA;AAC9B,EAAA,MAAM,MAAA,GAAS,cAAA,CAAe,SAAA,CAAU,QAAQ,CAAA;AAChD,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,KAAA,EAAO,OAAO,KAAA,CAAM,MAAA,CACjB,IAAI,CAACA,EAAAA,KAAM,GAAGA,EAAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAA,IAAK,QAAQ,CAAA,EAAA,EAAKA,EAAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAC1D,KAAK,IAAI;AAAA,KACd;AAAA,EACF;AACA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,QAAA,EAAU,OAAO,IAAA,EAAmB;AACzD;AAQA,SAAS,QAAQ,KAAA,EAAyB;AACxC,EAAA,IAAI,KAAA,IAAS,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACvD,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,MAAM,IAAA,GAAgC,EAAE,GAAG,GAAA,EAAI;AAC/C,EAAA,OAAO,IAAA,CAAK,gBAAA;AACZ,EAAA,IAAA,CAAK,OAAA,GAAU,gBAAA;AACf,EAAA,IAAI,OAAO,IAAA,CAAK,KAAA,KAAU,QAAA,OAAe,KAAA,GAAQ,wBAAA;AACjD,EAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA,EAAG,IAAA,CAAK,QAAQ,EAAC;AAE9C,EAAA,IAAA,CAAK,eAAe,KAAA,CAAM,OAAA,CAAQ,KAAK,YAAY,CAAA,GAC/C,KAAK,YAAA,CAAa,MAAA;AAAA,IAChB,CAAC,MAAM,CAAA,IAAK,IAAA,IAAQ,OAAO,CAAA,KAAM,QAAA,IAAY,UAAA,IAAc,CAAA,IAAK,MAAA,IAAU;AAAA,MAE5E,EAAC;AACL,EAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA,EAAG,IAAA,CAAK,QAAQ,EAAC;AAC9C,EAAA,OAAO,IAAA;AACT;;;AC9FA,SAAS,MAAM,CAAA,EAAmB;AAChC,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,CAAA,GAAI,GAAG,CAAA,GAAI,GAAA;AAC/B;AAEA,SAAS,aAAa,CAAA,EAAuB;AAC3C,EAAA,OAAO,EAAE,CAAA,EAAG,KAAA,CAAM,CAAA,CAAE,CAAC,GAAG,CAAA,EAAG,KAAA,CAAM,CAAA,CAAE,CAAC,CAAA,EAAE;AACxC;AAEA,SAAS,SAASC,EAAAA,EAAe;AAC/B,EAAA,OAAO,EAAE,KAAA,EAAO,KAAA,CAAMA,EAAAA,CAAE,KAAK,GAAG,MAAA,EAAQ,KAAA,CAAMA,EAAAA,CAAE,MAAM,CAAA,EAAE;AAC1D;AAGA,SAAS,SAAS,CAAA,EAAuB;AACvC,EAAA,MAAM,GAAA,GAAgB;AAAA,IACpB,IAAI,CAAA,CAAE,EAAA;AAAA,IACN,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,QAAA,EAAU,YAAA,CAAa,CAAA,CAAE,QAAQ,CAAA;AAAA,IACjC,IAAA,EAAM,QAAA,CAAS,CAAA,CAAE,IAAI;AAAA,GACvB;AACA,EAAA,IAAI,CAAA,CAAE,WAAA,EAAa,GAAA,CAAI,WAAA,GAAc,CAAA,CAAE,WAAA;AACvC,EAAA,IAAI,CAAA,CAAE,IAAA,EAAM,GAAA,CAAI,IAAA,GAAO,CAAA,CAAE,IAAA;AACzB,EAAA,IAAI,CAAA,CAAE,MAAA,EAAQ,GAAA,CAAI,MAAA,GAAS,CAAA,CAAE,MAAA;AAC7B,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,gBAAgB,CAAA,EAAuC;AAC9D,EAAA,MAAM,GAAA,GAAwB;AAAA,IAC5B,IAAI,CAAA,CAAE,EAAA;AAAA,IACN,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,QAAA,EAAU,YAAA,CAAa,CAAA,CAAE,QAAQ,CAAA;AAAA,IACjC,IAAA,EAAM,QAAA,CAAS,CAAA,CAAE,IAAI;AAAA,GACvB;AACA,EAAA,IAAI,CAAA,CAAE,KAAA,EAAO,GAAA,CAAI,KAAA,GAAQ,CAAA,CAAE,KAAA;AAC3B,EAAA,IAAI,CAAA,CAAE,IAAA,EAAM,GAAA,CAAI,IAAA,GAAO,CAAA,CAAE,IAAA;AACzB,EAAA,IAAI,CAAA,CAAE,MAAA,EAAQ,GAAA,CAAI,MAAA,GAAS,CAAA,CAAE,MAAA;AAC7B,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,SAAS,CAAA,EAAyB;AACzC,EAAA,MAAM,GAAA,GAAiB;AAAA,IACrB,IAAI,CAAA,CAAE,EAAA;AAAA,IACN,QAAA,EAAU,YAAA,CAAa,CAAA,CAAE,QAAQ,CAAA;AAAA,IACjC,IAAA,EAAM,QAAA,CAAS,CAAA,CAAE,IAAI;AAAA,GACvB;AACA,EAAA,IAAI,CAAA,CAAE,KAAA,EAAO,GAAA,CAAI,KAAA,GAAQ,CAAA,CAAE,KAAA;AAC3B,EAAA,OAAO,GAAA;AACT;AAEA,IAAM,IAAA,GAAO,CAAC,CAAA,EAAmB,CAAA,KAC/B,CAAA,CAAE,EAAA,GAAK,CAAA,CAAE,EAAA,GAAK,EAAA,GAAK,CAAA,CAAE,EAAA,GAAK,CAAA,CAAE,KAAK,CAAA,GAAI,CAAA;AAGhC,SAAS,aAAa,GAAA,EAA6B;AACxD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,gBAAA;AAAA,IACT,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,KAAA,EAAO,CAAC,GAAG,GAAA,CAAI,KAAK,EAAE,GAAA,CAAI,QAAQ,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAAA,IAC7C,YAAA,EAAc,CAAC,GAAG,GAAA,CAAI,YAAY,EAAE,GAAA,CAAI,eAAe,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAAA,IAClE,KAAA,EAAO,CAAC,GAAG,GAAA,CAAI,KAAK,EAAE,GAAA,CAAI,QAAQ,CAAA,CAAE,IAAA,CAAK,IAAI;AAAA,GAC/C;AACF;AAGO,SAAS,iBAAA,CAAkB,GAAA,EAAiB,MAAA,GAAS,IAAA,EAAc;AACxE,EAAA,MAAM,SAAA,GAAY,aAAa,GAAG,CAAA;AAClC,EAAA,OAAO,KAAK,SAAA,CAAU,SAAA,EAAW,IAAA,EAAM,MAAA,GAAS,IAAI,CAAC,CAAA;AACvD;AC9DO,SAAS,MAAM,MAAA,EAAwB;AAC5C,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,MAAA,CAAO,CAAC,CAAC,CAAA,CAAA;AAC/B;AAGO,SAAS,cAAA,CACd,IAAA,EACA,QAAA,EACA,SAAA,GAAoD,EAAC,EAC3C;AACV,EAAA,MAAM,IAAA,GAAO,gBAAgB,IAAI,CAAA;AACjC,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,MAAM,MAAM,CAAA;AAAA,IAChB,IAAA;AAAA,IACA,KAAA,EAAO,SAAA,CAAU,KAAA,IAAS,IAAA,CAAK,KAAA;AAAA,IAC/B,aAAa,SAAA,CAAU,WAAA;AAAA,IACvB,QAAA;AAAA,IACA,MAAM,SAAA,CAAU,IAAA,IAAQ,EAAE,GAAG,KAAK,WAAA,EAAY;AAAA,IAC9C,MAAM,SAAA,CAAU,IAAA;AAAA,IAChB,QAAQ,SAAA,CAAU;AAAA,GACpB;AACF;AAGO,SAAS,sBAAA,CACd,IAAA,EACA,QAAA,EACA,SAAA,GAAyE,EAAC,EACxD;AAClB,EAAA,MAAM,IAAA,GAAO,uBAAuB,IAAI,CAAA;AACxC,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,MAAM,KAAK,CAAA;AAAA,IACf,IAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAM,SAAA,CAAU,IAAA,IAAQ,EAAE,GAAG,KAAK,WAAA,EAAY;AAAA,IAC9C,OAAO,SAAA,CAAU,KAAA;AAAA,IACjB,MAAM,SAAA,CAAU,IAAA;AAAA,IAChB,QAAQ,SAAA,CAAU;AAAA,GACpB;AACF;AAGO,SAAS,eAAA,CACd,QAAA,EACA,SAAA,GAAyD,EAAC,EAC/C;AACX,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,MAAM,MAAM,CAAA;AAAA,IAChB,QAAA;AAAA,IACA,MAAM,SAAA,CAAU,IAAA,IAAQ,EAAE,GAAG,UAAU,WAAA,EAAY;AAAA,IACnD,KAAA,EAAO,SAAA,CAAU,KAAA,IAAS,SAAA,CAAU;AAAA,GACtC;AACF;AAGO,SAAS,aAAA,CAAc,QAAQ,wBAAA,EAAsC;AAC1E,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,gBAAA;AAAA,IACT,KAAA;AAAA,IACA,OAAO,EAAC;AAAA,IACR,cAAc,EAAC;AAAA,IACf,OAAO;AAAC,GACV;AACF;;;ACvEA,IAAM,CAAA,GAAI,eAAA;AACV,IAAM,CAAA,GAAI,sBAAA;AAEH,IAAM,eAAA,GAA8B;AAAA,EACzC,OAAA,EAAS,gBAAA;AAAA,EACT,KAAA,EAAO,oCAAA;AAAA,EACP,KAAA,EAAO;AAAA,IACL;AAAA,MACE,EAAA,EAAI,eAAA;AAAA,MACJ,IAAA,EAAM,UAAA;AAAA,MACN,KAAA,EAAO,kBAAA;AAAA,MACP,WAAA,EAAa,6DAAA;AAAA,MACb,QAAA,EAAU,EAAE,CAAA,EAAG,EAAA,EAAI,GAAG,GAAA,EAAI;AAAA,MAC1B,IAAA,EAAM,EAAE,GAAG,CAAA,CAAE,SAAS,WAAA;AAAY,KACpC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,eAAA;AAAA,MACJ,IAAA,EAAM,gBAAA;AAAA,MACN,KAAA,EAAO,iBAAA;AAAA,MACP,WAAA,EAAa,kDAAA;AAAA,MACb,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,gBAAgB,EAAE,WAAA;AAAY,KAC7C;AAAA,IACA;AAAA,MACE,EAAA,EAAI,aAAA;AAAA,MACJ,IAAA,EAAM,gBAAA;AAAA,MACN,KAAA,EAAO,mBAAA;AAAA,MACP,WAAA,EAAa,6CAAA;AAAA,MACb,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,gBAAgB,EAAE,WAAA;AAAY,KAC7C;AAAA,IACA;AAAA,MACE,EAAA,EAAI,YAAA;AAAA,MACJ,IAAA,EAAM,uBAAA;AAAA,MACN,KAAA,EAAO,qBAAA;AAAA,MACP,WAAA,EAAa,oDAAA;AAAA,MACb,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,uBAAuB,EAAE,WAAA;AAAY,KACpD;AAAA,IACA;AAAA,MACE,EAAA,EAAI,eAAA;AAAA,MACJ,IAAA,EAAM,UAAA;AAAA,MACN,KAAA,EAAO,6BAAA;AAAA,MACP,WAAA,EAAa,gEAAA;AAAA,MACb,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,IAAA,EAAM,EAAE,GAAG,CAAA,CAAE,SAAS,WAAA;AAAY;AACpC,GACF;AAAA,EACA,YAAA,EAAc;AAAA,IACZ;AAAA,MACE,EAAA,EAAI,qBAAA;AAAA,MACJ,IAAA,EAAM,cAAA;AAAA,MACN,KAAA,EAAO,iBAAA;AAAA,MACP,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,IAAA,EAAM,EAAE,GAAG,CAAA,CAAE,aAAa,WAAA;AAAY,KACxC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,oBAAA;AAAA,MACJ,IAAA,EAAM,eAAA;AAAA,MACN,KAAA,EAAO,uBAAA;AAAA,MACP,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,IAAA,EAAM,EAAE,GAAG,CAAA,CAAE,cAAc,WAAA;AAAY,KACzC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,uBAAA;AAAA,MACJ,IAAA,EAAM,gBAAA;AAAA,MACN,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,gBAAgB,EAAE,WAAA;AAAY,KAC7C;AAAA,IACA;AAAA,MACE,EAAA,EAAI,qBAAA;AAAA,MACJ,IAAA,EAAM,gBAAA;AAAA,MACN,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,gBAAgB,EAAE,WAAA;AAAY,KAC7C;AAAA,IACA;AAAA,MACE,EAAA,EAAI,kBAAA;AAAA,MACJ,IAAA,EAAM,gBAAA;AAAA,MACN,KAAA,EAAO,kBAAA;AAAA,MACP,QAAA,EAAU,EAAE,CAAA,EAAG,GAAA,EAAK,GAAG,GAAA,EAAI;AAAA,MAC3B,MAAM,EAAE,GAAG,CAAA,CAAE,gBAAgB,EAAE,WAAA;AAAY;AAC7C,GACF;AAAA,EACA,KAAA,EAAO;AAAA,IACL;AAAA,MACE,EAAA,EAAI,WAAA;AAAA,MACJ,KAAA,EAAO,gBAAA;AAAA,MACP,QAAA,EAAU,EAAE,CAAA,EAAG,EAAA,EAAI,GAAG,GAAA,EAAI;AAAA,MAC1B,IAAA,EAAM,EAAE,KAAA,EAAO,GAAA,EAAK,QAAQ,EAAA;AAAG;AACjC;AAEJ","file":"index.js","sourcesContent":["/**\n * Pure (DOM-free) domain types for the Team Topologies model.\n *\n * This module is the canonical representation of a diagram and must never\n * import from the rendering layer (`@xyflow/react`) or touch the DOM, so it\n * can be unit-tested in isolation and reused across views / exporters.\n */\n\n/** MIME type used when dragging a team type from the palette onto the canvas. */\nexport const DND_MIME = \"application/x-tt-team-type\";\n\n/** The four fundamental team types in Team Topologies. */\nexport type TeamType = \"stream-aligned\" | \"enabling\" | \"complicated-subsystem\" | \"platform\";\n\nexport const TEAM_TYPES: readonly TeamType[] = [\n  \"stream-aligned\",\n  \"enabling\",\n  \"complicated-subsystem\",\n  \"platform\",\n] as const;\n\n/** The three core team interaction modes in Team Topologies. */\nexport type InteractionMode = \"collaboration\" | \"x-as-a-service\" | \"facilitating\";\n\nexport const INTERACTION_MODES: readonly InteractionMode[] = [\n  \"collaboration\",\n  \"x-as-a-service\",\n  \"facilitating\",\n] as const;\n\n/** Geometric size of a node in canvas units (px). Encodes cognitive load. */\nexport interface Size {\n  width: number;\n  height: number;\n}\n\n/** Position of a node on the canvas in canvas units (px). */\nexport interface Position {\n  x: number;\n  y: number;\n}\n\n/** A team node in the canonical document model. */\nexport interface TeamNode {\n  id: string;\n  type: TeamType;\n  label: string;\n  description?: string;\n  position: Position;\n  size: Size;\n  fill?: string;\n  stroke?: string;\n}\n\n/**\n * An interaction in the canonical document model.\n *\n * Per the official Team Topologies notation, an interaction is a placed,\n * resizable SHAPE (parallelogram / triangle / circle) overlaid on the boundary\n * between the teams it relates to — not a connecting line. The relationship is\n * therefore spatial (overlap), so there is no source/target reference.\n */\nexport interface InteractionShape {\n  id: string;\n  mode: InteractionMode;\n  label?: string;\n  position: Position;\n  size: Size;\n  fill?: string;\n  stroke?: string;\n}\n\n/**\n * A \"flow of change\" guide: a placed, resizable arrow element. Lets you anchor\n * the implied left-to-right flow, and visualise several team groupings on one\n * canvas.\n */\nexport interface FlowShape {\n  id: string;\n  label?: string;\n  position: Position;\n  size: Size;\n}\n\n/** Current document schema version. Bump + add a migration when shape changes. */\nexport const DOCUMENT_VERSION = 2 as const;\n\n/**\n * A complete Team Topologies diagram. This is what gets serialised to JSON,\n * embedded into exported images, and encoded into share URLs.\n */\nexport interface TtDocument {\n  version: typeof DOCUMENT_VERSION;\n  title: string;\n  nodes: TeamNode[];\n  interactions: InteractionShape[];\n  flows: FlowShape[];\n}\n","/**\n * The Team Topologies visual notation, encoded as data.\n *\n * Colours, shapes and stroke styles follow the official\n * \"Team-Shape-Templates\" specification published by Team Topologies\n * (https://github.com/TeamTopologies/Team-Shape-Templates):\n *\n *  - Team shapes are SOLID outlines (long-lived structures).\n *  - Interaction-mode shapes are 50% transparent with DASHED outlines\n *    (short-lived interactions).\n *  - Each element is distinguished by SHAPE as well as colour, so the\n *    notation stays readable for people with colour-vision deficiency.\n *\n * This module is pure data — it must not import the rendering layer.\n */\n\nimport type { InteractionMode, Size, TeamType } from \"./types\";\n\nexport type TeamShape = \"rounded-rect-horizontal\" | \"rounded-rect-vertical\" | \"octagon\" | \"rect\";\n\nexport type InteractionGlyph = \"parallelogram\" | \"triangle\" | \"circle\";\n\nexport type StrokeStyle = \"solid\" | \"dashed\" | \"dotted\";\n\nexport interface TeamTypeSpec {\n  type: TeamType;\n  /** Short display name. */\n  label: string;\n  /** One-line purpose, shown in the palette and inspector. */\n  description: string;\n  shape: TeamShape;\n  fill: string;\n  stroke: string;\n  strokeStyle: StrokeStyle;\n  strokeWidth: number;\n  /** Default size when a node of this type is created. */\n  defaultSize: Size;\n  /** Minimum size enforced by the resizer. */\n  minSize: Size;\n}\n\nexport interface InteractionModeSpec {\n  mode: InteractionMode;\n  label: string;\n  description: string;\n  shape: InteractionGlyph;\n  fill: string;\n  stroke: string;\n  strokeStyle: StrokeStyle;\n  strokeWidth: number;\n  /** Opacity for the interaction shape (short-lived → translucent). */\n  opacity: number;\n  /** Whether direction is semantically meaningful (the X-as-a-Service triangle). */\n  directional: boolean;\n  /** Default size when a shape of this mode is created. */\n  defaultSize: Size;\n  /** Minimum size enforced by the resizer. */\n  minSize: Size;\n}\n\n/** The left-to-right \"flow of change\" guide, a placeable annotation element. */\nexport interface FlowSpec {\n  label: string;\n  fill: string;\n  stroke: string;\n  strokeStyle: StrokeStyle;\n  strokeWidth: number;\n  defaultSize: Size;\n  minSize: Size;\n}\n\nexport const TEAM_TYPE_SPECS: Record<TeamType, TeamTypeSpec> = {\n  \"stream-aligned\": {\n    type: \"stream-aligned\",\n    label: \"Stream-aligned\",\n    description: \"Aligned to a single, valuable stream of work; owns it end-to-end.\",\n    shape: \"rounded-rect-horizontal\",\n    fill: \"#FFEDB8\",\n    stroke: \"#FFD966\",\n    strokeStyle: \"solid\",\n    strokeWidth: 2,\n    defaultSize: { width: 240, height: 96 },\n    minSize: { width: 140, height: 64 },\n  },\n  enabling: {\n    type: \"enabling\",\n    label: \"Enabling\",\n    description:\n      \"Helps stream-aligned teams acquire missing capabilities; coaches, then steps back.\",\n    shape: \"rounded-rect-vertical\",\n    fill: \"#DFBDCF\",\n    stroke: \"#D09CB7\",\n    strokeStyle: \"solid\",\n    strokeWidth: 2,\n    defaultSize: { width: 120, height: 200 },\n    minSize: { width: 80, height: 120 },\n  },\n  \"complicated-subsystem\": {\n    type: \"complicated-subsystem\",\n    label: \"Complicated Subsystem\",\n    description:\n      \"Owns a part of the system needing deep specialist knowledge, reducing others' cognitive load.\",\n    shape: \"octagon\",\n    fill: \"#FFC08B\",\n    stroke: \"#E88814\",\n    strokeStyle: \"solid\",\n    strokeWidth: 2,\n    defaultSize: { width: 170, height: 150 },\n    minSize: { width: 110, height: 100 },\n  },\n  platform: {\n    type: \"platform\",\n    label: \"Platform\",\n    description:\n      \"Provides internal self-service capabilities to reduce cognitive load for stream-aligned teams.\",\n    shape: \"rect\",\n    fill: \"#B7CDF1\",\n    stroke: \"#6D9EEB\",\n    strokeStyle: \"solid\",\n    strokeWidth: 2,\n    defaultSize: { width: 380, height: 130 },\n    minSize: { width: 200, height: 90 },\n  },\n};\n\nexport const INTERACTION_MODE_SPECS: Record<InteractionMode, InteractionModeSpec> = {\n  collaboration: {\n    mode: \"collaboration\",\n    label: \"Collaboration\",\n    description:\n      \"Two teams work closely together for a defined period; high overhead, high discovery.\",\n    shape: \"parallelogram\",\n    fill: \"#C6BEDF\",\n    stroke: \"#967EE2\",\n    strokeStyle: \"dashed\",\n    strokeWidth: 2,\n    opacity: 0.5,\n    directional: false,\n    defaultSize: { width: 112, height: 72 },\n    minSize: { width: 60, height: 44 },\n  },\n  \"x-as-a-service\": {\n    mode: \"x-as-a-service\",\n    label: \"X-as-a-Service\",\n    description:\n      \"One team consumes something the other provides 'as a service'; minimal collaboration.\",\n    shape: \"triangle\",\n    fill: \"#B4B4B4\",\n    stroke: \"#999696\",\n    strokeStyle: \"dashed\",\n    strokeWidth: 2,\n    opacity: 0.5,\n    directional: true,\n    defaultSize: { width: 88, height: 78 },\n    minSize: { width: 54, height: 48 },\n  },\n  facilitating: {\n    mode: \"facilitating\",\n    label: \"Facilitating\",\n    description:\n      \"One team helps/coaches another to clear impediments and learn; sensing and discovery.\",\n    shape: \"circle\",\n    fill: \"#C9DFBE\",\n    stroke: \"#78996B\",\n    strokeStyle: \"dashed\",\n    strokeWidth: 2,\n    opacity: 0.5,\n    directional: false,\n    defaultSize: { width: 84, height: 84 },\n    minSize: { width: 48, height: 48 },\n  },\n};\n\n/**\n * The \"flow of change\" guide — a placeable dashed arrow (left-to-right).\n * Not a team or interaction: a standalone annotation element.\n */\nexport const FLOW_SPEC: FlowSpec = {\n  label: \"Flow of change\",\n  fill: \"transparent\",\n  stroke: \"#6b6459\",\n  strokeStyle: \"dashed\",\n  strokeWidth: 2,\n  defaultSize: { width: 520, height: 64 },\n  minSize: { width: 160, height: 36 },\n};\n\n/** Maps a stroke style to an SVG/CSS dash array (empty string = solid). */\nexport function dashArray(style: StrokeStyle, strokeWidth = 2): string {\n  switch (style) {\n    case \"dashed\":\n      return `${strokeWidth * 3} ${strokeWidth * 2}`;\n    case \"dotted\":\n      return `${strokeWidth} ${strokeWidth * 1.5}`;\n    case \"solid\":\n    default:\n      return \"\";\n  }\n}\n\nexport const ALL_TEAM_SPECS: readonly TeamTypeSpec[] = Object.values(TEAM_TYPE_SPECS);\nexport const ALL_INTERACTION_SPECS: readonly InteractionModeSpec[] =\n  Object.values(INTERACTION_MODE_SPECS);\n","/**\n * Runtime validation for the document model using Zod.\n *\n * Anything entering the app from the outside world (imported files, share\n * URLs, localStorage) is parsed through {@link parseDocument} so malformed or\n * tampered data can never corrupt the editor state.\n */\n\nimport { z } from \"zod\";\nimport { DOCUMENT_VERSION, INTERACTION_MODES, TEAM_TYPES } from \"./types\";\nimport type { TtDocument } from \"./types\";\n\nconst teamTypeSchema = z.enum(TEAM_TYPES as unknown as [string, ...string[]]);\nconst interactionModeSchema = z.enum(INTERACTION_MODES as unknown as [string, ...string[]]);\n\nconst sizeSchema = z.object({\n  width: z.number().finite().positive(),\n  height: z.number().finite().positive(),\n});\n\nconst positionSchema = z.object({\n  x: z.number().finite(),\n  y: z.number().finite(),\n});\n\nconst hexColor = z.string().regex(/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/, \"expected a hex colour\");\n\nexport const teamNodeSchema = z.object({\n  id: z.string().min(1),\n  type: teamTypeSchema,\n  label: z.string(),\n  description: z.string().optional(),\n  position: positionSchema,\n  size: sizeSchema,\n  fill: hexColor.optional(),\n  stroke: hexColor.optional(),\n});\n\nexport const interactionSchema = z.object({\n  id: z.string().min(1),\n  mode: interactionModeSchema,\n  label: z.string().optional(),\n  position: positionSchema,\n  size: sizeSchema,\n  fill: hexColor.optional(),\n  stroke: hexColor.optional(),\n});\n\nexport const flowSchema = z.object({\n  id: z.string().min(1),\n  label: z.string().optional(),\n  position: positionSchema,\n  size: sizeSchema,\n});\n\nexport const documentSchema = z.object({\n  version: z.literal(DOCUMENT_VERSION),\n  title: z.string(),\n  nodes: z.array(teamNodeSchema),\n  interactions: z.array(interactionSchema),\n  flows: z.array(flowSchema),\n});\n\nexport type ParseResult = { ok: true; document: TtDocument } | { ok: false; error: string };\n\n/**\n * Validates and (if necessary) migrates unknown data into a {@link TtDocument}.\n * Returns a discriminated result rather than throwing so callers can show a\n * friendly message.\n */\nexport function parseDocument(input: unknown): ParseResult {\n  const migrated = migrate(input);\n  const result = documentSchema.safeParse(migrated);\n  if (!result.success) {\n    return {\n      ok: false,\n      error: result.error.issues\n        .map((i) => `${i.path.join(\".\") || \"(root)\"}: ${i.message}`)\n        .join(\"; \"),\n    };\n  }\n  return { ok: true, document: result.data as TtDocument };\n}\n\n/**\n * Forward-migrates older document shapes to the current version. v1 modelled\n * interactions as edges (source/target, no geometry) and carried a\n * `showFlowOfChange` flag; v2 makes interactions placed shapes and adds `flows`.\n * Legacy edge-interactions can't be placed meaningfully, so they're dropped.\n */\nfunction migrate(input: unknown): unknown {\n  if (input == null || typeof input !== \"object\") return input;\n  const doc = input as Record<string, unknown>;\n  const next: Record<string, unknown> = { ...doc };\n  delete next.showFlowOfChange; // v1 flag, gone in v2\n  next.version = DOCUMENT_VERSION;\n  if (typeof next.title !== \"string\") next.title = \"Untitled team topology\";\n  if (!Array.isArray(next.nodes)) next.nodes = [];\n  // Keep only placed interaction shapes; drop legacy edges (no position/size).\n  next.interactions = Array.isArray(next.interactions)\n    ? next.interactions.filter(\n        (e) => e != null && typeof e === \"object\" && \"position\" in e && \"size\" in e,\n      )\n    : [];\n  if (!Array.isArray(next.flows)) next.flows = [];\n  return next;\n}\n","/**\n * Deterministic serialisation of the document model.\n *\n * Producing byte-stable JSON (sorted arrays, fixed key order, rounded\n * coordinates) makes diagrams diff-friendly in version control and gives\n * stable share URLs / embedded payloads.\n */\n\nimport { DOCUMENT_VERSION } from \"./types\";\nimport type { FlowShape, InteractionShape, Position, Size, TeamNode, TtDocument } from \"./types\";\n\n/** Round to 2 decimals to strip floating-point drift from drag operations. */\nfunction round(n: number): number {\n  return Math.round(n * 100) / 100;\n}\n\nfunction normPosition(p: Position): Position {\n  return { x: round(p.x), y: round(p.y) };\n}\n\nfunction normSize(s: Size): Size {\n  return { width: round(s.width), height: round(s.height) };\n}\n\n/** Drops undefined fields and applies a fixed key order to a node. */\nfunction normNode(n: TeamNode): TeamNode {\n  const out: TeamNode = {\n    id: n.id,\n    type: n.type,\n    label: n.label,\n    position: normPosition(n.position),\n    size: normSize(n.size),\n  };\n  if (n.description) out.description = n.description;\n  if (n.fill) out.fill = n.fill;\n  if (n.stroke) out.stroke = n.stroke;\n  return out;\n}\n\nfunction normInteraction(e: InteractionShape): InteractionShape {\n  const out: InteractionShape = {\n    id: e.id,\n    mode: e.mode,\n    position: normPosition(e.position),\n    size: normSize(e.size),\n  };\n  if (e.label) out.label = e.label;\n  if (e.fill) out.fill = e.fill;\n  if (e.stroke) out.stroke = e.stroke;\n  return out;\n}\n\nfunction normFlow(f: FlowShape): FlowShape {\n  const out: FlowShape = {\n    id: f.id,\n    position: normPosition(f.position),\n    size: normSize(f.size),\n  };\n  if (f.label) out.label = f.label;\n  return out;\n}\n\nconst byId = (a: { id: string }, b: { id: string }): number =>\n  a.id < b.id ? -1 : a.id > b.id ? 1 : 0;\n\n/** Returns a canonicalised copy of a document (sorted, rounded, version-stamped). */\nexport function canonicalize(doc: TtDocument): TtDocument {\n  return {\n    version: DOCUMENT_VERSION,\n    title: doc.title,\n    nodes: [...doc.nodes].map(normNode).sort(byId),\n    interactions: [...doc.interactions].map(normInteraction).sort(byId),\n    flows: [...doc.flows].map(normFlow).sort(byId),\n  };\n}\n\n/** Serialises a document to deterministic, pretty-printed JSON. */\nexport function serializeDocument(doc: TtDocument, pretty = true): string {\n  const canonical = canonicalize(doc);\n  return JSON.stringify(canonical, null, pretty ? 2 : 0);\n}\n","/**\n * Factory helpers for constructing well-formed model objects with the correct\n * notation defaults (sizes, labels). Kept DOM-free.\n */\n\nimport { nanoid } from \"nanoid\";\nimport { FLOW_SPEC, INTERACTION_MODE_SPECS, TEAM_TYPE_SPECS } from \"./notation\";\nimport type {\n  FlowShape,\n  InteractionMode,\n  InteractionShape,\n  Position,\n  TeamNode,\n  TeamType,\n  TtDocument,\n} from \"./types\";\nimport { DOCUMENT_VERSION } from \"./types\";\n\nexport function newId(prefix: string): string {\n  return `${prefix}_${nanoid(8)}`;\n}\n\n/** Creates a team node of the given type at a position, with notation defaults. */\nexport function createTeamNode(\n  type: TeamType,\n  position: Position,\n  overrides: Partial<Omit<TeamNode, \"id\" | \"type\">> = {},\n): TeamNode {\n  const spec = TEAM_TYPE_SPECS[type];\n  return {\n    id: newId(\"team\"),\n    type,\n    label: overrides.label ?? spec.label,\n    description: overrides.description,\n    position,\n    size: overrides.size ?? { ...spec.defaultSize },\n    fill: overrides.fill,\n    stroke: overrides.stroke,\n  };\n}\n\n/** Creates a placed interaction shape of the given mode, with notation defaults. */\nexport function createInteractionShape(\n  mode: InteractionMode,\n  position: Position,\n  overrides: Partial<Omit<InteractionShape, \"id\" | \"mode\" | \"position\">> = {},\n): InteractionShape {\n  const spec = INTERACTION_MODE_SPECS[mode];\n  return {\n    id: newId(\"int\"),\n    mode,\n    position,\n    size: overrides.size ?? { ...spec.defaultSize },\n    label: overrides.label,\n    fill: overrides.fill,\n    stroke: overrides.stroke,\n  };\n}\n\n/** Creates a placed \"flow of change\" arrow, with notation defaults. */\nexport function createFlowShape(\n  position: Position,\n  overrides: Partial<Omit<FlowShape, \"id\" | \"position\">> = {},\n): FlowShape {\n  return {\n    id: newId(\"flow\"),\n    position,\n    size: overrides.size ?? { ...FLOW_SPEC.defaultSize },\n    label: overrides.label ?? FLOW_SPEC.label,\n  };\n}\n\n/** An empty document with sensible defaults. */\nexport function emptyDocument(title = \"Untitled team topology\"): TtDocument {\n  return {\n    version: DOCUMENT_VERSION,\n    title,\n    nodes: [],\n    interactions: [],\n    flows: [],\n  };\n}\n","/**\n * A small but complete example diagram exercising all four team types, all three\n * interaction modes (as placed shapes overlaying the team boundaries) and a\n * flow-of-change element. Ids are fixed so the fixture serialises stably.\n */\n\nimport { DOCUMENT_VERSION } from \"./types\";\nimport type { TtDocument } from \"./types\";\nimport { INTERACTION_MODE_SPECS, TEAM_TYPE_SPECS } from \"./notation\";\n\nconst s = TEAM_TYPE_SPECS;\nconst i = INTERACTION_MODE_SPECS;\n\nexport const SAMPLE_DOCUMENT: TtDocument = {\n  version: DOCUMENT_VERSION,\n  title: \"Online retail — team topology\",\n  nodes: [\n    {\n      id: \"team_enabling\",\n      type: \"enabling\",\n      label: \"Agile Enablement\",\n      description: \"Coaches teams on testing and continuous delivery practices.\",\n      position: { x: 60, y: 150 },\n      size: { ...s.enabling.defaultSize },\n    },\n    {\n      id: \"team_checkout\",\n      type: \"stream-aligned\",\n      label: \"Checkout Stream\",\n      description: \"Owns the end-to-end checkout & payments journey.\",\n      position: { x: 320, y: 110 },\n      size: { ...s[\"stream-aligned\"].defaultSize },\n    },\n    {\n      id: \"team_mobile\",\n      type: \"stream-aligned\",\n      label: \"Mobile Experience\",\n      description: \"Owns the native mobile shopping experience.\",\n      position: { x: 700, y: 110 },\n      size: { ...s[\"stream-aligned\"].defaultSize },\n    },\n    {\n      id: \"team_fraud\",\n      type: \"complicated-subsystem\",\n      label: \"Risk & Fraud Engine\",\n      description: \"Specialist ML team owning real-time fraud scoring.\",\n      position: { x: 740, y: 320 },\n      size: { ...s[\"complicated-subsystem\"].defaultSize },\n    },\n    {\n      id: \"team_platform\",\n      type: \"platform\",\n      label: \"Internal Developer Platform\",\n      description: \"Self-service CI/CD, observability and runtime for all streams.\",\n      position: { x: 300, y: 540 },\n      size: { ...s.platform.defaultSize },\n    },\n  ],\n  interactions: [\n    {\n      id: \"int_enable_checkout\",\n      mode: \"facilitating\",\n      label: \"test automation\",\n      position: { x: 212, y: 158 },\n      size: { ...i.facilitating.defaultSize },\n    },\n    {\n      id: \"int_checkout_fraud\",\n      mode: \"collaboration\",\n      label: \"fraud rules discovery\",\n      position: { x: 566, y: 232 },\n      size: { ...i.collaboration.defaultSize },\n    },\n    {\n      id: \"int_platform_checkout\",\n      mode: \"x-as-a-service\",\n      position: { x: 384, y: 396 },\n      size: { ...i[\"x-as-a-service\"].defaultSize },\n    },\n    {\n      id: \"int_platform_mobile\",\n      mode: \"x-as-a-service\",\n      position: { x: 612, y: 396 },\n      size: { ...i[\"x-as-a-service\"].defaultSize },\n    },\n    {\n      id: \"int_fraud_mobile\",\n      mode: \"x-as-a-service\",\n      label: \"risk scoring API\",\n      position: { x: 800, y: 238 },\n      size: { ...i[\"x-as-a-service\"].defaultSize },\n    },\n  ],\n  flows: [\n    {\n      id: \"flow_main\",\n      label: \"Flow of change\",\n      position: { x: 60, y: 712 },\n      size: { width: 880, height: 60 },\n    },\n  ],\n};\n"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@miragon/team-topologies-schema-model",
+  "version": "0.1.0",
+  "description": "The Team Topologies data model with types, the notation specification, runtime validation, migrations and deterministic JSON serialization.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miragon/team-topologies-modeler.git",
+    "directory": "packages/schema-model"
+  },
+  "homepage": "https://github.com/miragon/team-topologies-modeler/tree/main/packages/schema-model#readme",
+  "bugs": "https://github.com/miragon/team-topologies-modeler/issues",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "npm --prefix ../.. run test"
+  },
+  "dependencies": {
+    "nanoid": "5.0.9",
+    "zod": "3.24.1"
+  },
+  "devDependencies": {
+    "tsup": "8.3.5",
+    "typescript": "5.7.2",
+    "vitest": "3.2.6"
+  }
+}