structured-context-map-views 0.0.0-stage → 0.2.0

package/dist/types/core/format/definition-schema.d.ts

@@ -0,0 +1,181 @@
+import { PARAM_REF } from './param-ref';
+/**
+ * The map view definition format: shared parameters, and the regions a map view is composed of.
+ *
+ * Written as TypeScript so the definition types derive from it (`FromSchema`); the JSON files
+ * for `$schema` references and editors are generated (`bun run generate:schemas`).
+ */
+export declare const definitionSchema: {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json";
+    readonly title: 'Map view definition';
+    readonly description: 'Declares how spaces of one schema are projected into a map view: shared parameters, and the regions the map view is composed of.';
+    readonly type: 'object';
+    readonly required: readonly ['$id', 'schema', 'regions'];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly $schema: {
+            readonly type: 'string';
+        };
+        readonly $id: {
+            readonly type: 'string';
+            readonly pattern: '^sctx-map-view://[^/]+(/[^/]+)?$';
+            readonly description: 'Identifier, namespaced by where the definition is found: "sctx-map-view://core/<name>" (bundled), "sctx-map-view://<plugin>/<name>" (a plugin) or "sctx-map-view://<name>" (the config folder).';
+        };
+        readonly title: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly description: 'Display name. Defaults to the last segment of the `$id`.';
+        };
+        readonly description: {
+            readonly type: 'string';
+        };
+        readonly schema: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly description: '`$id` of the structured-context schema whose spaces this map view applies to.';
+        };
+        readonly parameters: {
+            readonly type: 'object';
+            readonly description: 'Settings the reader can change. Each is a JSON Schema with a default, bound to settings anywhere in the definition with { "$param": "<name>" }.';
+            readonly additionalProperties: {
+                readonly $ref: '#/$defs/parameter';
+            };
+        };
+        readonly regions: {
+            readonly type: 'array';
+            readonly minItems: 1;
+            readonly description: 'Parts of the map view, each with its own layout, nodes and edges. Only the first region is rendered for now.';
+            readonly items: {
+                readonly $ref: '#/$defs/region';
+            };
+        };
+    };
+    readonly $defs: {
+        readonly parameter: {
+            readonly type: 'object';
+            readonly description: "A JSON Schema for the parameter's values (it can $ref, narrow or extend the bundled setting definitions), plus a title for its control.";
+            readonly required: readonly ['default'];
+            readonly properties: {
+                readonly title: {
+                    readonly type: 'string';
+                };
+                readonly description: {
+                    readonly type: 'string';
+                };
+                readonly default: {};
+            };
+        };
+        readonly paramRef: {
+            readonly type: 'object';
+            readonly description: "Takes this setting's value from a declared parameter.";
+            readonly required: readonly ['$param'];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly $param: {
+                    readonly type: 'string';
+                    readonly minLength: 1;
+                };
+            };
+        };
+        readonly region: {
+            readonly type: 'object';
+            readonly required: readonly ['id', 'layout'];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly type: 'string';
+                    readonly minLength: 1;
+                    readonly description: 'Unique within the map view; part of every occurrence id in the region.';
+                };
+                readonly select: {
+                    readonly type: 'object';
+                    readonly description: 'Which nodes of the space the region shows. By default, all of them.';
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly filter: {
+                            readonly type: 'string';
+                            readonly minLength: 1;
+                            readonly description: "A structured-context filter: a view name from the space's config, or an expression such as `WHERE …` or `SELECT … WHERE …`.";
+                        };
+                    };
+                };
+                readonly layout: {
+                    readonly description: 'How the region is arranged, chosen by `type`.';
+                    readonly type: 'object';
+                    readonly required: readonly ['type'];
+                    readonly discriminator: {
+                        readonly propertyName: 'type';
+                    };
+                    readonly oneOf: readonly [{
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/tree.json";
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/landscape.json";
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json";
+                    }];
+                };
+                readonly nodes: {
+                    readonly type: 'object';
+                    readonly additionalProperties: false;
+                    readonly default: {};
+                    readonly properties: {
+                        readonly style: {
+                            readonly description: string;
+                            readonly default: "card";
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/nodeStyle";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly fields: {
+                            readonly description: string;
+                            readonly default: readonly [];
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/fieldList";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly validation: {
+                            readonly description: string;
+                            readonly default: "off";
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/validationLevel";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly validationSources: {
+                            readonly description: string;
+                            readonly default: readonly ["schema", "hierarchy", "rule"];
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/validationSources";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                    };
+                };
+                readonly edges: {
+                    readonly type: 'object';
+                    readonly additionalProperties: false;
+                    readonly default: {};
+                    readonly properties: {
+                        readonly show: {
+                            readonly description: string;
+                            readonly default: true;
+                            readonly anyOf: readonly [{
+                                readonly type: "boolean";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export { PARAM_REF };

package/dist/types/core/format/index.d.ts

@@ -0,0 +1,450 @@
+import { definitionSchema } from './definition-schema';
+import { landscapeLayoutSchema } from './landscape-layout';
+import { settingsSchema } from './settings';
+import { treeLayoutSchema } from './tree-layout';
+import { xyLayoutSchema } from './xy-layout';
+export { PARAM_REF } from './param-ref';
+export { definitionSchema, landscapeLayoutSchema, settingsSchema, treeLayoutSchema, xyLayoutSchema };
+/** The bundled schemas describing the map view definition format. */
+export declare const MAP_VIEW_SCHEMAS: readonly [{
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json";
+    readonly title: 'Map view definition';
+    readonly description: 'Declares how spaces of one schema are projected into a map view: shared parameters, and the regions the map view is composed of.';
+    readonly type: 'object';
+    readonly required: readonly ['$id', 'schema', 'regions'];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly $schema: {
+            readonly type: 'string';
+        };
+        readonly $id: {
+            readonly type: 'string';
+            readonly pattern: '^sctx-map-view://[^/]+(/[^/]+)?$';
+            readonly description: 'Identifier, namespaced by where the definition is found: "sctx-map-view://core/<name>" (bundled), "sctx-map-view://<plugin>/<name>" (a plugin) or "sctx-map-view://<name>" (the config folder).';
+        };
+        readonly title: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly description: 'Display name. Defaults to the last segment of the `$id`.';
+        };
+        readonly description: {
+            readonly type: 'string';
+        };
+        readonly schema: {
+            readonly type: 'string';
+            readonly minLength: 1;
+            readonly description: '`$id` of the structured-context schema whose spaces this map view applies to.';
+        };
+        readonly parameters: {
+            readonly type: 'object';
+            readonly description: 'Settings the reader can change. Each is a JSON Schema with a default, bound to settings anywhere in the definition with { "$param": "<name>" }.';
+            readonly additionalProperties: {
+                readonly $ref: '#/$defs/parameter';
+            };
+        };
+        readonly regions: {
+            readonly type: 'array';
+            readonly minItems: 1;
+            readonly description: 'Parts of the map view, each with its own layout, nodes and edges. Only the first region is rendered for now.';
+            readonly items: {
+                readonly $ref: '#/$defs/region';
+            };
+        };
+    };
+    readonly $defs: {
+        readonly parameter: {
+            readonly type: 'object';
+            readonly description: "A JSON Schema for the parameter's values (it can $ref, narrow or extend the bundled setting definitions), plus a title for its control.";
+            readonly required: readonly ['default'];
+            readonly properties: {
+                readonly title: {
+                    readonly type: 'string';
+                };
+                readonly description: {
+                    readonly type: 'string';
+                };
+                readonly default: {};
+            };
+        };
+        readonly paramRef: {
+            readonly type: 'object';
+            readonly description: "Takes this setting's value from a declared parameter.";
+            readonly required: readonly ['$param'];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly $param: {
+                    readonly type: 'string';
+                    readonly minLength: 1;
+                };
+            };
+        };
+        readonly region: {
+            readonly type: 'object';
+            readonly required: readonly ['id', 'layout'];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly type: 'string';
+                    readonly minLength: 1;
+                    readonly description: 'Unique within the map view; part of every occurrence id in the region.';
+                };
+                readonly select: {
+                    readonly type: 'object';
+                    readonly description: 'Which nodes of the space the region shows. By default, all of them.';
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly filter: {
+                            readonly type: 'string';
+                            readonly minLength: 1;
+                            readonly description: "A structured-context filter: a view name from the space's config, or an expression such as `WHERE …` or `SELECT … WHERE …`.";
+                        };
+                    };
+                };
+                readonly layout: {
+                    readonly description: 'How the region is arranged, chosen by `type`.';
+                    readonly type: 'object';
+                    readonly required: readonly ['type'];
+                    readonly discriminator: {
+                        readonly propertyName: 'type';
+                    };
+                    readonly oneOf: readonly [{
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/tree.json";
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/landscape.json";
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json";
+                    }];
+                };
+                readonly nodes: {
+                    readonly type: 'object';
+                    readonly additionalProperties: false;
+                    readonly default: {};
+                    readonly properties: {
+                        readonly style: {
+                            readonly description: string;
+                            readonly default: "card";
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/nodeStyle";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly fields: {
+                            readonly description: string;
+                            readonly default: readonly [];
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/fieldList";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly validation: {
+                            readonly description: string;
+                            readonly default: "off";
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/validationLevel";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly validationSources: {
+                            readonly description: string;
+                            readonly default: readonly ["schema", "hierarchy", "rule"];
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/validationSources";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                    };
+                };
+                readonly edges: {
+                    readonly type: 'object';
+                    readonly additionalProperties: false;
+                    readonly default: {};
+                    readonly properties: {
+                        readonly show: {
+                            readonly description: string;
+                            readonly default: true;
+                            readonly anyOf: readonly [{
+                                readonly type: "boolean";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json";
+    readonly title: 'Shared map view settings';
+    readonly description: 'Reusable setting definitions. Parameters can $ref these and narrow them, e.g. with allOf and enum.';
+    readonly $defs: {
+        readonly orientation: {
+            readonly title: 'Orientation';
+            readonly enum: readonly ['vertical', 'horizontal'];
+        };
+        readonly nodeStyle: {
+            readonly title: 'Node style';
+            readonly description: 'card: a box with the title and selected fields. shape: a compact marker with a tooltip.';
+            readonly enum: readonly ['card', 'shape'];
+        };
+        readonly validationLevel: {
+            readonly title: 'Validation overlay';
+            readonly description: 'The lowest severity of validation result shown on nodes, or off. error: only errors. warning: errors and warnings. info: everything.';
+            readonly enum: readonly ['off', 'error', 'warning', 'info'];
+        };
+        readonly validationSources: {
+            readonly title: 'Validation sources';
+            readonly description: 'Which kinds of validation result are shown. schema: a node failing its schema. hierarchy: a node under a parent type it is not allowed under. rule: a schema rule violation.';
+            readonly type: 'array';
+            readonly items: {
+                readonly enum: readonly ['schema', 'hierarchy', 'rule'];
+            };
+            readonly uniqueItems: true;
+        };
+        readonly fieldList: {
+            readonly title: 'Fields';
+            readonly type: 'array';
+            readonly items: {
+                readonly type: 'string';
+                readonly minLength: 1;
+            };
+            readonly uniqueItems: true;
+        };
+    };
+}, {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/tree.json";
+    readonly title: 'Tree layout';
+    readonly description: "A tree over the schema's hierarchy: root-type nodes at the top, children via hierarchy edges.";
+    readonly type: 'object';
+    readonly required: readonly ['type'];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly type: {
+            readonly const: 'tree';
+        };
+        readonly orientation: {
+            readonly description: string;
+            readonly default: "vertical";
+            readonly anyOf: readonly [{
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/orientation";
+            }, {
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+            }];
+        };
+        readonly dag: {
+            readonly description: string;
+            readonly default: "repeat";
+            readonly anyOf: readonly [{
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/tree.json#/$defs/dag";
+            }, {
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+            }];
+        };
+    };
+    readonly $defs: {
+        readonly dag: {
+            readonly title: 'Nodes with several parents';
+            readonly description: 'repeat: the node appears under each parent, its subtree shown once. cross-edge: the node appears under its first parent, with extra connectors from the others.';
+            readonly enum: readonly ['repeat', 'cross-edge'];
+        };
+    };
+}, {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/landscape.json";
+    readonly title: 'Landscape layout';
+    readonly description: 'Nested containers: each grouping level becomes containers inside the level above, and the last level is drawn as nodes.';
+    readonly type: 'object';
+    readonly required: readonly ['type', 'group'];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly type: {
+            readonly const: 'landscape';
+        };
+        readonly orientation: {
+            readonly description: string;
+            readonly default: "horizontal";
+            readonly anyOf: readonly [{
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/orientation";
+            }, {
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+            }];
+        };
+        readonly group: {
+            readonly type: 'array';
+            readonly minItems: 1;
+            readonly description: 'Grouping levels, outermost first. The last level is drawn as nodes; the others as containers. Adjacent node levels are joined by any edge between their types, in either direction.';
+            readonly items: {
+                readonly type: 'object';
+                readonly if: {
+                    readonly type: 'object';
+                    readonly required: readonly ['field'];
+                };
+                readonly then: {
+                    readonly type: 'object';
+                    readonly description: "Containers labelled by the values of a field of the next node level's nodes. A node with several values appears under each.";
+                    readonly required: readonly ['field'];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly field: {
+                            readonly type: 'string';
+                            readonly minLength: 1;
+                        };
+                    };
+                };
+                readonly else: {
+                    readonly type: 'object';
+                    readonly description: 'A level of nodes of one type.';
+                    readonly required: readonly ['type'];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly type: {
+                            readonly description: 'Node type at this level.';
+                            readonly anyOf: readonly [{
+                                readonly type: 'string';
+                                readonly minLength: 1;
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                        readonly edge: {
+                            readonly type: 'object';
+                            readonly description: 'Which edges join this level to the node level above (or to the last `via` type). By default, any edge between the two types.';
+                            readonly required: readonly ['field'];
+                            readonly additionalProperties: false;
+                            readonly properties: {
+                                readonly field: {
+                                    readonly type: 'string';
+                                    readonly minLength: 1;
+                                };
+                            };
+                        };
+                        readonly via: {
+                            readonly type: 'array';
+                            readonly minItems: 1;
+                            readonly description: 'Types skipped between the node level above and this one, in order. Nodes are joined through a chain of edges across them. Ignored on the first level, which has no level above.';
+                            readonly items: {
+                                readonly type: 'string';
+                                readonly minLength: 1;
+                            };
+                        };
+                        readonly intermediate: {
+                            readonly description: string;
+                            readonly default: "hidden";
+                            readonly anyOf: readonly [{
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/landscape.json#/$defs/intermediate";
+                            }, {
+                                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                            }];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    readonly $defs: {
+        readonly intermediate: {
+            readonly title: 'Skipped levels';
+            readonly description: 'hidden: not shown. breadcrumb: listed on each node reached through them.';
+            readonly enum: readonly ['hidden', 'breadcrumb'];
+        };
+    };
+}, {
+    readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
+    readonly $id: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json";
+    readonly title: 'XY layout';
+    readonly description: 'Nodes positioned on two axes by numeric fields. Nodes of the plotted types without a usable value on both axes are listed beside the plot, not dropped.';
+    readonly type: 'object';
+    readonly required: readonly ['type', 'x', 'y'];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly type: {
+            readonly const: 'xy';
+        };
+        readonly x: {
+            readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json#/$defs/axis";
+        };
+        readonly y: {
+            readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json#/$defs/axis";
+        };
+        readonly types: {
+            readonly description: string;
+            readonly default: readonly [];
+            readonly anyOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly uniqueItems: true;
+            }, {
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+            }];
+        };
+        readonly edgeFields: {
+            readonly description: string;
+            readonly default: readonly [];
+            readonly anyOf: readonly [{
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/settings.json#/$defs/fieldList";
+            }, {
+                readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+            }];
+        };
+    };
+    readonly $defs: {
+        readonly axis: {
+            readonly title: 'Axis';
+            readonly type: 'object';
+            readonly required: readonly ['field'];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly field: {
+                    readonly description: 'Numeric field giving the position.';
+                    readonly anyOf: readonly [{
+                        readonly type: 'string';
+                        readonly minLength: 1;
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                    }];
+                };
+                readonly domain: {
+                    readonly description: 'Values at the two ends of the axis: [min, max], or "data" for the smallest and largest plotted values. Nodes outside a fixed domain are listed as unplaced.';
+                    readonly default: 'data';
+                    readonly anyOf: readonly [{
+                        readonly const: 'data';
+                    }, {
+                        readonly type: 'array';
+                        readonly items: {
+                            readonly type: 'number';
+                        };
+                        readonly minItems: 2;
+                        readonly maxItems: 2;
+                    }];
+                };
+                readonly direction: {
+                    readonly description: string;
+                    readonly default: "ascending";
+                    readonly anyOf: readonly [{
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/layouts/xy.json#/$defs/direction";
+                    }, {
+                        readonly $ref: "https://raw.githubusercontent.com/mindsocket/structured-context-map-views/main/schemas/generated/latest/definition.json#/$defs/paramRef";
+                    }];
+                };
+                readonly label: {
+                    readonly type: 'string';
+                    readonly description: 'Axis title. Defaults to the field name.';
+                };
+            };
+        };
+        readonly direction: {
+            readonly title: 'Axis direction';
+            readonly enum: readonly ['ascending', 'descending'];
+        };
+    };
+}];