oatschema 0.0.1 → 0.1.0

package/dist/compiled/0.8.0/regression.js

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-FileCopyrightText: 2015-2021 Evgeny Poberezkin
+// SPDX-License-Identifier: Apache-2.0 AND MIT
+import{FORMATS as D,ucs2length as S}from"../../formats.js";const B=x;var G=x;const C={"x-license":{id:"Apache-2.0",notice:"Copyright 2025-2026 The OATS Authors",url:"https://github.com/oatschema/oats/blob/main/LICENSE"},$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://oatschema.org/0.8.0/regression",title:"Regression","x-version":"0.8.0",description:"Represent continuous numerical predictions. Supports point estimates, confidence intervals, and time-series forecasting.",type:"object",properties:{target:{type:"string",description:"The name of or a reference to the variable being predicted (e.g., 'temperature', 'stock_price').",maxLength:256},unit:{type:"string",description:"The unit of measurement.",maxLength:128},producer:{type:"string",description:"The creator (model, tool or author) of this regression.",maxLength:1024},score_explanation:{type:"string",description:"Explanation of the score metric and its semantics (e.g. 'R-squared' or 'Model Confidence').",maxLength:256},points:{type:"array",description:"The regression data points. A single item represents a point estimate; multiple items represent a time series or distribution.",minItems:1,maxItems:1e4,items:{type:"object",description:"A single predicted value.",properties:{value:{description:"The predicted or sampled value. Null represents a missing value, such as a gap in a time series.",anyOf:[{type:"number"},{type:"null"}]},statistic:{type:"string",description:"The statistical nature of this value.",enum:["mean","median","mode","min","max","quantile","sample"]},quantile_level:{type:"number",description:"The quantile level (e.g., 0.95). Required when statistic is 'quantile', and only allowed then.",minimum:0,maximum:1},timestamp:{type:"string",format:"date-time",maxLength:128,description:"The specific time this prediction applies to."},interval_lower:{type:"number",description:"The lower bound of the confidence interval."},interval_upper:{type:"number",description:"The upper bound of the confidence interval. Must not be less than interval_lower."},score:{type:"number",description:"A normalized score for this point (-1.0 to 1.0). Depending on the metric, this may be a probability (0 to 1) or a bipolar metric such as R-squared clipped to [-1, 1]. Use score_explanation to clarify.",minimum:-1,maximum:1},attributes:{type:"object",description:"Arbitrary metadata relevant to this point.",maxProperties:16,propertyNames:{maxLength:128},additionalProperties:{anyOf:[{type:"string",maxLength:1024},{type:"number"},{type:"boolean"},{type:"null"}]}}},required:["value"],allOf:[{if:{properties:{statistic:{const:"quantile"}},required:["statistic"]},then:{required:["quantile_level"]}},{if:{required:["quantile_level"]},then:{properties:{statistic:{const:"quantile"}},required:["statistic"]}}],additionalProperties:!1}},attributes:{type:"object",description:"Arbitrary metadata relevant to this regression.",maxProperties:16,propertyNames:{maxLength:128},additionalProperties:{anyOf:[{type:"string",maxLength:1024},{type:"number"},{type:"boolean"},{type:"null"}]}}},required:["points"],additionalProperties:!1},u=Object.prototype.hasOwnProperty,b=S,M=D["date-time"];function x(l,{instancePath:a="",parentData:K,parentDataProperty:U,rootData:V=l,dynamicAnchors:$={}}={}){let e=null,t=0;const q=x.evaluated;if(q.dynamicProps&&(q.props=void 0),q.dynamicItems&&(q.items=void 0),l&&typeof l=="object"&&!Array.isArray(l)){if(l.points===void 0||!u.call(l,"points")){const o={instancePath:a,schemaPath:"#/required",keyword:"required",params:{missingProperty:"points"}};e===null?e=[o]:e.push(o),t++}for(const o of Object.keys(l))if(!(o==="target"||o==="unit"||o==="producer"||o==="score_explanation"||o==="points"||o==="attributes")){const n={instancePath:a,schemaPath:"#/additionalProperties",keyword:"additionalProperties",params:{additionalProperty:o}};e===null?e=[n]:e.push(n),t++}if(l.target!==void 0&&u.call(l,"target")){let o=l.target;if(typeof o=="string"){if(b(o)>256){const n={instancePath:a+"/target",schemaPath:"#/properties/target/maxLength",keyword:"maxLength",params:{limit:256}};e===null?e=[n]:e.push(n),t++}}else{const n={instancePath:a+"/target",schemaPath:"#/properties/target/type",keyword:"type",params:{type:"string"}};e===null?e=[n]:e.push(n),t++}}if(l.unit!==void 0&&u.call(l,"unit")){let o=l.unit;if(typeof o=="string"){if(b(o)>128){const n={instancePath:a+"/unit",schemaPath:"#/properties/unit/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[n]:e.push(n),t++}}else{const n={instancePath:a+"/unit",schemaPath:"#/properties/unit/type",keyword:"type",params:{type:"string"}};e===null?e=[n]:e.push(n),t++}}if(l.producer!==void 0&&u.call(l,"producer")){let o=l.producer;if(typeof o=="string"){if(b(o)>1024){const n={instancePath:a+"/producer",schemaPath:"#/properties/producer/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[n]:e.push(n),t++}}else{const n={instancePath:a+"/producer",schemaPath:"#/properties/producer/type",keyword:"type",params:{type:"string"}};e===null?e=[n]:e.push(n),t++}}if(l.score_explanation!==void 0&&u.call(l,"score_explanation")){let o=l.score_explanation;if(typeof o=="string"){if(b(o)>256){const n={instancePath:a+"/score_explanation",schemaPath:"#/properties/score_explanation/maxLength",keyword:"maxLength",params:{limit:256}};e===null?e=[n]:e.push(n),t++}}else{const n={instancePath:a+"/score_explanation",schemaPath:"#/properties/score_explanation/type",keyword:"type",params:{type:"string"}};e===null?e=[n]:e.push(n),t++}}if(l.points!==void 0&&u.call(l,"points")){let o=l.points;if(Array.isArray(o)){if(o.length>1e4){const p={instancePath:a+"/points",schemaPath:"#/properties/points/maxItems",keyword:"maxItems",params:{limit:1e4}};e===null?e=[p]:e.push(p),t++}if(o.length<1){const p={instancePath:a+"/points",schemaPath:"#/properties/points/minItems",keyword:"minItems",params:{limit:1}};e===null?e=[p]:e.push(p),t++}const n=o.length;for(let p=0;p<n;p++){let i=o[p];const y=t;let O=!0;const N=t;if(i&&typeof i=="object"&&!Array.isArray(i)){let r;if((i.statistic===void 0||!u.call(i,"statistic"))&&(r="statistic")){const s={};e===null?e=[s]:e.push(s),t++}else if(i.statistic!==void 0&&u.call(i,"statistic")&&i.statistic!=="quantile"){const s={};e===null?e=[s]:e.push(s),t++}}var j=N===t;if(t=y,e!==null&&(y?e.length=y:e=null),j){const r=t;if(i&&typeof i=="object"&&!Array.isArray(i)&&(i.quantile_level===void 0||!u.call(i,"quantile_level"))){const m={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/allOf/0/then/required",keyword:"required",params:{missingProperty:"quantile_level"}};e===null?e=[m]:e.push(m),t++}var j=r===t;O=j}if(!O){const r={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/allOf/0/if",keyword:"if",params:{failingKeyword:"then"}};e===null?e=[r]:e.push(r),t++}const k=t;let _=!0;const c=t;if(i&&typeof i=="object"&&!Array.isArray(i)){let r;if((i.quantile_level===void 0||!u.call(i,"quantile_level"))&&(r="quantile_level")){const s={};e===null?e=[s]:e.push(s),t++}}var A=c===t;if(t=k,e!==null&&(k?e.length=k:e=null),A){const r=t;if(i&&typeof i=="object"&&!Array.isArray(i)){if(i.statistic===void 0||!u.call(i,"statistic")){const m={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/allOf/1/then/required",keyword:"required",params:{missingProperty:"statistic"}};e===null?e=[m]:e.push(m),t++}if(i.statistic!==void 0&&u.call(i,"statistic")&&i.statistic!=="quantile"){const m={instancePath:a+"/points/"+p+"/statistic",schemaPath:"#/properties/points/items/allOf/1/then/properties/statistic/const",keyword:"const",params:{allowedValue:"quantile"}};e===null?e=[m]:e.push(m),t++}}var A=r===t;if(_=A,_){var w={};w.statistic=!0}}if(!_){const r={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/allOf/1/if",keyword:"if",params:{failingKeyword:"then"}};e===null?e=[r]:e.push(r),t++}if(w!==!0&&(w=w||{},w.statistic=!0),i&&typeof i=="object"&&!Array.isArray(i)){if(i.value===void 0||!u.call(i,"value")){const r={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/required",keyword:"required",params:{missingProperty:"value"}};e===null?e=[r]:e.push(r),t++}for(const r of Object.keys(i))if(!(r==="value"||r==="statistic"||r==="quantile_level"||r==="timestamp"||r==="interval_lower"||r==="interval_upper"||r==="score"||r==="attributes")){const s={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/additionalProperties",keyword:"additionalProperties",params:{additionalProperty:r}};e===null?e=[s]:e.push(s),t++}if(i.value!==void 0&&u.call(i,"value")){let r=i.value;const s=t;let m=!1;const h=t;if(!(typeof r=="number"&&isFinite(r))){const g={instancePath:a+"/points/"+p+"/value",schemaPath:"#/properties/points/items/properties/value/anyOf/0/type",keyword:"type",params:{type:"number"}};e===null?e=[g]:e.push(g),t++}var L=h===t;m=m||L;const d=t;if(r!==null){const g={instancePath:a+"/points/"+p+"/value",schemaPath:"#/properties/points/items/properties/value/anyOf/1/type",keyword:"type",params:{type:"null"}};e===null?e=[g]:e.push(g),t++}var L=d===t;if(m=m||L,m)t=s,e!==null&&(s?e.length=s:e=null);else{const g={instancePath:a+"/points/"+p+"/value",schemaPath:"#/properties/points/items/properties/value/anyOf",keyword:"anyOf",params:Object.assign({},{branchErrors:t-s})};e===null?e=[g]:e.push(g),t++}}if(i.statistic!==void 0&&u.call(i,"statistic")){let r=i.statistic;if(typeof r!="string"){const s={instancePath:a+"/points/"+p+"/statistic",schemaPath:"#/properties/points/items/properties/statistic/type",keyword:"type",params:{type:"string"}};e===null?e=[s]:e.push(s),t++}if(!(r==="mean"||r==="median"||r==="mode"||r==="min"||r==="max"||r==="quantile"||r==="sample")){const s={instancePath:a+"/points/"+p+"/statistic",schemaPath:"#/properties/points/items/properties/statistic/enum",keyword:"enum",params:{allowedValues:C.properties.points.items.properties.statistic.enum}};e===null?e=[s]:e.push(s),t++}}if(i.quantile_level!==void 0&&u.call(i,"quantile_level")){let r=i.quantile_level;if(typeof r=="number"&&isFinite(r)){if(r>1||isNaN(r)){const s={instancePath:a+"/points/"+p+"/quantile_level",schemaPath:"#/properties/points/items/properties/quantile_level/maximum",keyword:"maximum",params:{comparison:"<=",limit:1}};e===null?e=[s]:e.push(s),t++}if(r<0||isNaN(r)){const s={instancePath:a+"/points/"+p+"/quantile_level",schemaPath:"#/properties/points/items/properties/quantile_level/minimum",keyword:"minimum",params:{comparison:">=",limit:0}};e===null?e=[s]:e.push(s),t++}}else{const s={instancePath:a+"/points/"+p+"/quantile_level",schemaPath:"#/properties/points/items/properties/quantile_level/type",keyword:"type",params:{type:"number"}};e===null?e=[s]:e.push(s),t++}}if(i.timestamp!==void 0&&u.call(i,"timestamp")){let r=i.timestamp;if(typeof r=="string"){if(b(r)>128){const s={instancePath:a+"/points/"+p+"/timestamp",schemaPath:"#/properties/points/items/properties/timestamp/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[s]:e.push(s),t++}if(!M(r)){const s={instancePath:a+"/points/"+p+"/timestamp",schemaPath:"#/properties/points/items/properties/timestamp/format",keyword:"format",params:{format:"date-time"}};e===null?e=[s]:e.push(s),t++}}else{const s={instancePath:a+"/points/"+p+"/timestamp",schemaPath:"#/properties/points/items/properties/timestamp/type",keyword:"type",params:{type:"string"}};e===null?e=[s]:e.push(s),t++}}if(i.interval_lower!==void 0&&u.call(i,"interval_lower")){let r=i.interval_lower;if(!(typeof r=="number"&&isFinite(r))){const s={instancePath:a+"/points/"+p+"/interval_lower",schemaPath:"#/properties/points/items/properties/interval_lower/type",keyword:"type",params:{type:"number"}};e===null?e=[s]:e.push(s),t++}}if(i.interval_upper!==void 0&&u.call(i,"interval_upper")){let r=i.interval_upper;if(!(typeof r=="number"&&isFinite(r))){const s={instancePath:a+"/points/"+p+"/interval_upper",schemaPath:"#/properties/points/items/properties/interval_upper/type",keyword:"type",params:{type:"number"}};e===null?e=[s]:e.push(s),t++}}if(i.score!==void 0&&u.call(i,"score")){let r=i.score;if(typeof r=="number"&&isFinite(r)){if(r>1||isNaN(r)){const s={instancePath:a+"/points/"+p+"/score",schemaPath:"#/properties/points/items/properties/score/maximum",keyword:"maximum",params:{comparison:"<=",limit:1}};e===null?e=[s]:e.push(s),t++}if(r<-1||isNaN(r)){const s={instancePath:a+"/points/"+p+"/score",schemaPath:"#/properties/points/items/properties/score/minimum",keyword:"minimum",params:{comparison:">=",limit:-1}};e===null?e=[s]:e.push(s),t++}}else{const s={instancePath:a+"/points/"+p+"/score",schemaPath:"#/properties/points/items/properties/score/type",keyword:"type",params:{type:"number"}};e===null?e=[s]:e.push(s),t++}}if(i.attributes!==void 0&&u.call(i,"attributes")){let r=i.attributes;if(r&&typeof r=="object"&&!Array.isArray(r)){if(Object.keys(r).length>16){const s={instancePath:a+"/points/"+p+"/attributes",schemaPath:"#/properties/points/items/properties/attributes/maxProperties",keyword:"maxProperties",params:{limit:16}};e===null?e=[s]:e.push(s),t++}for(const s of Object.keys(r)){const m=t;if(typeof s=="string"&&b(s)>128){const h={instancePath:a+"/points/"+p+"/attributes",schemaPath:"#/properties/points/items/properties/attributes/propertyNames/maxLength",keyword:"maxLength",params:{limit:128},propertyName:s};e===null?e=[h]:e.push(h),t++}var T=m===t;if(!T){const h={instancePath:a+"/points/"+p+"/attributes",schemaPath:"#/properties/points/items/properties/attributes/propertyNames",keyword:"propertyNames",params:{propertyName:s}};e===null?e=[h]:e.push(h),t++}}for(const s of Object.keys(r)){let m=r[s];const h=t;let d=!1;const g=t;if(typeof m=="string"){if(b(m)>1024){const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf/0/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[f]:e.push(f),t++}}else{const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf/0/type",keyword:"type",params:{type:"string"}};e===null?e=[f]:e.push(f),t++}var P=g===t;d=d||P;const I=t;if(!(typeof m=="number"&&isFinite(m))){const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf/1/type",keyword:"type",params:{type:"number"}};e===null?e=[f]:e.push(f),t++}var P=I===t;d=d||P;const E=t;if(typeof m!="boolean"){const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf/2/type",keyword:"type",params:{type:"boolean"}};e===null?e=[f]:e.push(f),t++}var P=E===t;d=d||P;const R=t;if(m!==null){const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf/3/type",keyword:"type",params:{type:"null"}};e===null?e=[f]:e.push(f),t++}var P=R===t;if(d=d||P,d)t=h,e!==null&&(h?e.length=h:e=null);else{const f={instancePath:a+"/points/"+p+"/attributes/"+s.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/points/items/properties/attributes/additionalProperties/anyOf",keyword:"anyOf",params:Object.assign({},{branchErrors:t-h})};e===null?e=[f]:e.push(f),t++}}}else{const s={instancePath:a+"/points/"+p+"/attributes",schemaPath:"#/properties/points/items/properties/attributes/type",keyword:"type",params:{type:"object"}};e===null?e=[s]:e.push(s),t++}}}else{const r={instancePath:a+"/points/"+p,schemaPath:"#/properties/points/items/type",keyword:"type",params:{type:"object"}};e===null?e=[r]:e.push(r),t++}}}else{const n={instancePath:a+"/points",schemaPath:"#/properties/points/type",keyword:"type",params:{type:"array"}};e===null?e=[n]:e.push(n),t++}}if(l.attributes!==void 0&&u.call(l,"attributes")){let o=l.attributes;if(o&&typeof o=="object"&&!Array.isArray(o)){if(Object.keys(o).length>16){const n={instancePath:a+"/attributes",schemaPath:"#/properties/attributes/maxProperties",keyword:"maxProperties",params:{limit:16}};e===null?e=[n]:e.push(n),t++}for(const n of Object.keys(o)){const p=t;if(typeof n=="string"&&b(n)>128){const i={instancePath:a+"/attributes",schemaPath:"#/properties/attributes/propertyNames/maxLength",keyword:"maxLength",params:{limit:128},propertyName:n};e===null?e=[i]:e.push(i),t++}var F=p===t;if(!F){const i={instancePath:a+"/attributes",schemaPath:"#/properties/attributes/propertyNames",keyword:"propertyNames",params:{propertyName:n}};e===null?e=[i]:e.push(i),t++}}for(const n of Object.keys(o)){let p=o[n];const i=t;let y=!1;const O=t;if(typeof p=="string"){if(b(p)>1024){const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/0/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[c]:e.push(c),t++}}else{const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/0/type",keyword:"type",params:{type:"string"}};e===null?e=[c]:e.push(c),t++}var v=O===t;y=y||v;const N=t;if(!(typeof p=="number"&&isFinite(p))){const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/1/type",keyword:"type",params:{type:"number"}};e===null?e=[c]:e.push(c),t++}var v=N===t;y=y||v;const k=t;if(typeof p!="boolean"){const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/2/type",keyword:"type",params:{type:"boolean"}};e===null?e=[c]:e.push(c),t++}var v=k===t;y=y||v;const _=t;if(p!==null){const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/3/type",keyword:"type",params:{type:"null"}};e===null?e=[c]:e.push(c),t++}var v=_===t;if(y=y||v,y)t=i,e!==null&&(i?e.length=i:e=null);else{const c={instancePath:a+"/attributes/"+n.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf",keyword:"anyOf",params:Object.assign({},{branchErrors:t-i})};e===null?e=[c]:e.push(c),t++}}}else{const n={instancePath:a+"/attributes",schemaPath:"#/properties/attributes/type",keyword:"type",params:{type:"object"}};e===null?e=[n]:e.push(n),t++}}}else{const o={instancePath:a,schemaPath:"#/type",keyword:"type",params:{type:"object"}};e===null?e=[o]:e.push(o),t++}return x.errors=e,t===0}x.evaluated={props:!0,dynamicProps:!1,dynamicItems:!1};export{G as default,B as validate};

package/dist/compiled/0.8.0/temporal-segmentation.js

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-FileCopyrightText: 2015-2021 Evgeny Poberezkin
+// SPDX-License-Identifier: Apache-2.0 AND MIT
+import{FORMATS as O,ucs2length as A}from"../../formats.js";const E=P;var D=P;const j={"x-license":{id:"Apache-2.0",notice:"Copyright 2025-2026 The OATS Authors",url:"https://github.com/oatschema/oats/blob/main/LICENSE"},$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://oatschema.org/0.8.0/temporal-segmentation",title:"Temporal Segmentation","x-version":"0.8.0",description:"Represent labelled time intervals within a media source, such as chapters, scenes, shots, speaker turns or detected events. Segments may overlap, may nest, and need not cover the whole source.",type:"object",properties:{producer:{type:"string",description:"The creator (model, tool or author) of these segments (e.g., 'PySceneDetect', 'pyannote', 'Manual Review').",maxLength:1024},track_id:{type:"string",description:"(Optional) Identifier for the specific audio or video track in the source media. Numeric identifiers are written as strings (e.g., '0').",maxLength:128},duration:{type:"number",description:"The total duration of the source media in seconds. When present, no segment's end_time may exceed it.",minimum:0},vocabulary:{type:"array",description:"A list of the possible segment labels. For more than 100 labels, use 'vocabulary_url'.",maxItems:100,uniqueItems:!0,items:{type:"string",description:"A single valid label from the vocabulary.",maxLength:128}},vocabulary_url:{type:"string",description:"A URL pointing to a more detailed external vocabulary or ontology.",format:"uri",maxLength:2048},score_explanation:{type:"string",description:"Defines the meaning of the 'score' field.",maxLength:256},segments:{type:"array",description:"The labelled time intervals. Can be empty if no segments were found.",maxItems:1e5,items:{type:"object",description:"A single labelled time interval.",properties:{id:{type:"string",description:"An identifier for this segment (e.g., 'scene-12'). Must be unique within the record.",maxLength:128},parent_id:{type:"string",description:"The id of the segment that contains this one (e.g., the chapter containing a scene). Must be the id of another segment in the record, and this segment must lie within its parent's interval.",maxLength:128},group_id:{type:"string",description:"An identifier for the entity this segment belongs to. Segments sharing a group_id belong to the same entity (e.g., all turns of speaker 'SPEAKER_00'). Numeric identifiers, such as diarization cluster numbers, are written as strings (e.g., '0').",maxLength:128},label:{type:"string",description:"The category of the segment (e.g., 'chapter', 'scene', 'speaker', 'explosion'). Must be a member of 'vocabulary' when it is present.",maxLength:128},title:{type:"string",description:"A human-readable name for this segment (e.g., a chapter title).",maxLength:128},description:{type:"string",description:"A description of what happens in this segment.",maxLength:1024},start_time:{type:"number",description:"Segment start time in seconds from the start of the source.",minimum:0},end_time:{type:"number",description:"Segment end time in seconds from the start of the source. Must not be earlier than start_time; equal times mark an instantaneous event.",minimum:0},score:{type:"number",description:"The confidence that the label applies to this interval, ranging from 0.0 (uncertain) to 1.0 (certain).",minimum:0,maximum:1},attributes:{type:"object",description:"Arbitrary metadata relevant to this segment.",maxProperties:16,propertyNames:{maxLength:128},additionalProperties:{anyOf:[{type:"string",maxLength:1024},{type:"number"},{type:"boolean"},{type:"null"}]}}},required:["label","start_time","end_time"],additionalProperties:!1}},attributes:{type:"object",description:"Arbitrary metadata relevant to this record (e.g., annotator, source, job ID).",maxProperties:16,propertyNames:{maxLength:128},additionalProperties:{anyOf:[{type:"string",maxLength:1024},{type:"number"},{type:"boolean"},{type:"null"}]}}},required:["segments"],additionalProperties:!1},m=Object.prototype.hasOwnProperty,y=A,N=O.uri;function P(l,{instancePath:i="",parentData:q,parentDataProperty:I,rootData:S=l,dynamicAnchors:T={}}={}){let e=null,t=0;const k=P.evaluated;if(k.dynamicProps&&(k.props=void 0),k.dynamicItems&&(k.items=void 0),l&&typeof l=="object"&&!Array.isArray(l)){if(l.segments===void 0||!m.call(l,"segments")){const o={instancePath:i,schemaPath:"#/required",keyword:"required",params:{missingProperty:"segments"}};e===null?e=[o]:e.push(o),t++}for(const o of Object.keys(l))if(!(o==="producer"||o==="track_id"||o==="duration"||o==="vocabulary"||o==="vocabulary_url"||o==="score_explanation"||o==="segments"||o==="attributes")){const a={instancePath:i,schemaPath:"#/additionalProperties",keyword:"additionalProperties",params:{additionalProperty:o}};e===null?e=[a]:e.push(a),t++}if(l.producer!==void 0&&m.call(l,"producer")){let o=l.producer;if(typeof o=="string"){if(y(o)>1024){const a={instancePath:i+"/producer",schemaPath:"#/properties/producer/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[a]:e.push(a),t++}}else{const a={instancePath:i+"/producer",schemaPath:"#/properties/producer/type",keyword:"type",params:{type:"string"}};e===null?e=[a]:e.push(a),t++}}if(l.track_id!==void 0&&m.call(l,"track_id")){let o=l.track_id;if(typeof o=="string"){if(y(o)>128){const a={instancePath:i+"/track_id",schemaPath:"#/properties/track_id/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[a]:e.push(a),t++}}else{const a={instancePath:i+"/track_id",schemaPath:"#/properties/track_id/type",keyword:"type",params:{type:"string"}};e===null?e=[a]:e.push(a),t++}}if(l.duration!==void 0&&m.call(l,"duration")){let o=l.duration;if(typeof o=="number"&&isFinite(o)){if(o<0||isNaN(o)){const a={instancePath:i+"/duration",schemaPath:"#/properties/duration/minimum",keyword:"minimum",params:{comparison:">=",limit:0}};e===null?e=[a]:e.push(a),t++}}else{const a={instancePath:i+"/duration",schemaPath:"#/properties/duration/type",keyword:"type",params:{type:"number"}};e===null?e=[a]:e.push(a),t++}}if(l.vocabulary!==void 0&&m.call(l,"vocabulary")){let o=l.vocabulary;if(Array.isArray(o)){if(o.length>100){const s={instancePath:i+"/vocabulary",schemaPath:"#/properties/vocabulary/maxItems",keyword:"maxItems",params:{limit:100}};e===null?e=[s]:e.push(s),t++}const a=o.length;for(let s=0;s<a;s++){let r=o[s];if(typeof r=="string"){if(y(r)>128){const c={instancePath:i+"/vocabulary/"+s,schemaPath:"#/properties/vocabulary/items/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[c]:e.push(c),t++}}else{const c={instancePath:i+"/vocabulary/"+s,schemaPath:"#/properties/vocabulary/items/type",keyword:"type",params:{type:"string"}};e===null?e=[c]:e.push(c),t++}}let n=o.length,p;if(n>1){const s={};for(;n--;){let r=o[n];if(typeof r=="string"){if(typeof s[r]=="number"){p=s[r];const c={instancePath:i+"/vocabulary",schemaPath:"#/properties/vocabulary/uniqueItems",keyword:"uniqueItems",params:{i:n,j:p}};e===null?e=[c]:e.push(c),t++;break}s[r]=n}}}}else{const a={instancePath:i+"/vocabulary",schemaPath:"#/properties/vocabulary/type",keyword:"type",params:{type:"array"}};e===null?e=[a]:e.push(a),t++}}if(l.vocabulary_url!==void 0&&m.call(l,"vocabulary_url")){let o=l.vocabulary_url;if(typeof o=="string"){if(y(o)>2048){const a={instancePath:i+"/vocabulary_url",schemaPath:"#/properties/vocabulary_url/maxLength",keyword:"maxLength",params:{limit:2048}};e===null?e=[a]:e.push(a),t++}if(!N(o)){const a={instancePath:i+"/vocabulary_url",schemaPath:"#/properties/vocabulary_url/format",keyword:"format",params:{format:"uri"}};e===null?e=[a]:e.push(a),t++}}else{const a={instancePath:i+"/vocabulary_url",schemaPath:"#/properties/vocabulary_url/type",keyword:"type",params:{type:"string"}};e===null?e=[a]:e.push(a),t++}}if(l.score_explanation!==void 0&&m.call(l,"score_explanation")){let o=l.score_explanation;if(typeof o=="string"){if(y(o)>256){const a={instancePath:i+"/score_explanation",schemaPath:"#/properties/score_explanation/maxLength",keyword:"maxLength",params:{limit:256}};e===null?e=[a]:e.push(a),t++}}else{const a={instancePath:i+"/score_explanation",schemaPath:"#/properties/score_explanation/type",keyword:"type",params:{type:"string"}};e===null?e=[a]:e.push(a),t++}}if(l.segments!==void 0&&m.call(l,"segments")){let o=l.segments;if(Array.isArray(o)){if(o.length>1e5){const n={instancePath:i+"/segments",schemaPath:"#/properties/segments/maxItems",keyword:"maxItems",params:{limit:1e5}};e===null?e=[n]:e.push(n),t++}const a=o.length;for(let n=0;n<a;n++){let p=o[n];if(p&&typeof p=="object"&&!Array.isArray(p)){if(p.label===void 0||!m.call(p,"label")){const s={instancePath:i+"/segments/"+n,schemaPath:"#/properties/segments/items/required",keyword:"required",params:{missingProperty:"label"}};e===null?e=[s]:e.push(s),t++}if(p.start_time===void 0||!m.call(p,"start_time")){const s={instancePath:i+"/segments/"+n,schemaPath:"#/properties/segments/items/required",keyword:"required",params:{missingProperty:"start_time"}};e===null?e=[s]:e.push(s),t++}if(p.end_time===void 0||!m.call(p,"end_time")){const s={instancePath:i+"/segments/"+n,schemaPath:"#/properties/segments/items/required",keyword:"required",params:{missingProperty:"end_time"}};e===null?e=[s]:e.push(s),t++}for(const s of Object.keys(p))if(!m.call(j.properties.segments.items.properties,s)){const r={instancePath:i+"/segments/"+n,schemaPath:"#/properties/segments/items/additionalProperties",keyword:"additionalProperties",params:{additionalProperty:s}};e===null?e=[r]:e.push(r),t++}if(p.id!==void 0&&m.call(p,"id")){let s=p.id;if(typeof s=="string"){if(y(s)>128){const r={instancePath:i+"/segments/"+n+"/id",schemaPath:"#/properties/segments/items/properties/id/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/id",schemaPath:"#/properties/segments/items/properties/id/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.parent_id!==void 0&&m.call(p,"parent_id")){let s=p.parent_id;if(typeof s=="string"){if(y(s)>128){const r={instancePath:i+"/segments/"+n+"/parent_id",schemaPath:"#/properties/segments/items/properties/parent_id/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/parent_id",schemaPath:"#/properties/segments/items/properties/parent_id/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.group_id!==void 0&&m.call(p,"group_id")){let s=p.group_id;if(typeof s=="string"){if(y(s)>128){const r={instancePath:i+"/segments/"+n+"/group_id",schemaPath:"#/properties/segments/items/properties/group_id/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/group_id",schemaPath:"#/properties/segments/items/properties/group_id/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.label!==void 0&&m.call(p,"label")){let s=p.label;if(typeof s=="string"){if(y(s)>128){const r={instancePath:i+"/segments/"+n+"/label",schemaPath:"#/properties/segments/items/properties/label/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/label",schemaPath:"#/properties/segments/items/properties/label/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.title!==void 0&&m.call(p,"title")){let s=p.title;if(typeof s=="string"){if(y(s)>128){const r={instancePath:i+"/segments/"+n+"/title",schemaPath:"#/properties/segments/items/properties/title/maxLength",keyword:"maxLength",params:{limit:128}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/title",schemaPath:"#/properties/segments/items/properties/title/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.description!==void 0&&m.call(p,"description")){let s=p.description;if(typeof s=="string"){if(y(s)>1024){const r={instancePath:i+"/segments/"+n+"/description",schemaPath:"#/properties/segments/items/properties/description/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/description",schemaPath:"#/properties/segments/items/properties/description/type",keyword:"type",params:{type:"string"}};e===null?e=[r]:e.push(r),t++}}if(p.start_time!==void 0&&m.call(p,"start_time")){let s=p.start_time;if(typeof s=="number"&&isFinite(s)){if(s<0||isNaN(s)){const r={instancePath:i+"/segments/"+n+"/start_time",schemaPath:"#/properties/segments/items/properties/start_time/minimum",keyword:"minimum",params:{comparison:">=",limit:0}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/start_time",schemaPath:"#/properties/segments/items/properties/start_time/type",keyword:"type",params:{type:"number"}};e===null?e=[r]:e.push(r),t++}}if(p.end_time!==void 0&&m.call(p,"end_time")){let s=p.end_time;if(typeof s=="number"&&isFinite(s)){if(s<0||isNaN(s)){const r={instancePath:i+"/segments/"+n+"/end_time",schemaPath:"#/properties/segments/items/properties/end_time/minimum",keyword:"minimum",params:{comparison:">=",limit:0}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/end_time",schemaPath:"#/properties/segments/items/properties/end_time/type",keyword:"type",params:{type:"number"}};e===null?e=[r]:e.push(r),t++}}if(p.score!==void 0&&m.call(p,"score")){let s=p.score;if(typeof s=="number"&&isFinite(s)){if(s>1||isNaN(s)){const r={instancePath:i+"/segments/"+n+"/score",schemaPath:"#/properties/segments/items/properties/score/maximum",keyword:"maximum",params:{comparison:"<=",limit:1}};e===null?e=[r]:e.push(r),t++}if(s<0||isNaN(s)){const r={instancePath:i+"/segments/"+n+"/score",schemaPath:"#/properties/segments/items/properties/score/minimum",keyword:"minimum",params:{comparison:">=",limit:0}};e===null?e=[r]:e.push(r),t++}}else{const r={instancePath:i+"/segments/"+n+"/score",schemaPath:"#/properties/segments/items/properties/score/type",keyword:"type",params:{type:"number"}};e===null?e=[r]:e.push(r),t++}}if(p.attributes!==void 0&&m.call(p,"attributes")){let s=p.attributes;if(s&&typeof s=="object"&&!Array.isArray(s)){if(Object.keys(s).length>16){const r={instancePath:i+"/segments/"+n+"/attributes",schemaPath:"#/properties/segments/items/properties/attributes/maxProperties",keyword:"maxProperties",params:{limit:16}};e===null?e=[r]:e.push(r),t++}for(const r of Object.keys(s)){const c=t;if(typeof r=="string"&&y(r)>128){const d={instancePath:i+"/segments/"+n+"/attributes",schemaPath:"#/properties/segments/items/properties/attributes/propertyNames/maxLength",keyword:"maxLength",params:{limit:128},propertyName:r};e===null?e=[d]:e.push(d),t++}var _=c===t;if(!_){const d={instancePath:i+"/segments/"+n+"/attributes",schemaPath:"#/properties/segments/items/properties/attributes/propertyNames",keyword:"propertyNames",params:{propertyName:r}};e===null?e=[d]:e.push(d),t++}}for(const r of Object.keys(s)){let c=s[r];const d=t;let f=!1;const u=t;if(typeof c=="string"){if(y(c)>1024){const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf/0/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[h]:e.push(h),t++}}else{const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf/0/type",keyword:"type",params:{type:"string"}};e===null?e=[h]:e.push(h),t++}var g=u===t;f=f||g;const x=t;if(!(typeof c=="number"&&isFinite(c))){const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf/1/type",keyword:"type",params:{type:"number"}};e===null?e=[h]:e.push(h),t++}var g=x===t;f=f||g;const v=t;if(typeof c!="boolean"){const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf/2/type",keyword:"type",params:{type:"boolean"}};e===null?e=[h]:e.push(h),t++}var g=v===t;f=f||g;const L=t;if(c!==null){const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf/3/type",keyword:"type",params:{type:"null"}};e===null?e=[h]:e.push(h),t++}var g=L===t;if(f=f||g,f)t=d,e!==null&&(d?e.length=d:e=null);else{const h={instancePath:i+"/segments/"+n+"/attributes/"+r.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/segments/items/properties/attributes/additionalProperties/anyOf",keyword:"anyOf",params:Object.assign({},{branchErrors:t-d})};e===null?e=[h]:e.push(h),t++}}}else{const r={instancePath:i+"/segments/"+n+"/attributes",schemaPath:"#/properties/segments/items/properties/attributes/type",keyword:"type",params:{type:"object"}};e===null?e=[r]:e.push(r),t++}}}else{const s={instancePath:i+"/segments/"+n,schemaPath:"#/properties/segments/items/type",keyword:"type",params:{type:"object"}};e===null?e=[s]:e.push(s),t++}}}else{const a={instancePath:i+"/segments",schemaPath:"#/properties/segments/type",keyword:"type",params:{type:"array"}};e===null?e=[a]:e.push(a),t++}}if(l.attributes!==void 0&&m.call(l,"attributes")){let o=l.attributes;if(o&&typeof o=="object"&&!Array.isArray(o)){if(Object.keys(o).length>16){const a={instancePath:i+"/attributes",schemaPath:"#/properties/attributes/maxProperties",keyword:"maxProperties",params:{limit:16}};e===null?e=[a]:e.push(a),t++}for(const a of Object.keys(o)){const n=t;if(typeof a=="string"&&y(a)>128){const p={instancePath:i+"/attributes",schemaPath:"#/properties/attributes/propertyNames/maxLength",keyword:"maxLength",params:{limit:128},propertyName:a};e===null?e=[p]:e.push(p),t++}var w=n===t;if(!w){const p={instancePath:i+"/attributes",schemaPath:"#/properties/attributes/propertyNames",keyword:"propertyNames",params:{propertyName:a}};e===null?e=[p]:e.push(p),t++}}for(const a of Object.keys(o)){let n=o[a];const p=t;let s=!1;const r=t;if(typeof n=="string"){if(y(n)>1024){const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/0/maxLength",keyword:"maxLength",params:{limit:1024}};e===null?e=[u]:e.push(u),t++}}else{const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/0/type",keyword:"type",params:{type:"string"}};e===null?e=[u]:e.push(u),t++}var b=r===t;s=s||b;const c=t;if(!(typeof n=="number"&&isFinite(n))){const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/1/type",keyword:"type",params:{type:"number"}};e===null?e=[u]:e.push(u),t++}var b=c===t;s=s||b;const d=t;if(typeof n!="boolean"){const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/2/type",keyword:"type",params:{type:"boolean"}};e===null?e=[u]:e.push(u),t++}var b=d===t;s=s||b;const f=t;if(n!==null){const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf/3/type",keyword:"type",params:{type:"null"}};e===null?e=[u]:e.push(u),t++}var b=f===t;if(s=s||b,s)t=p,e!==null&&(p?e.length=p:e=null);else{const u={instancePath:i+"/attributes/"+a.replace(/~/g,"~0").replace(/\//g,"~1"),schemaPath:"#/properties/attributes/additionalProperties/anyOf",keyword:"anyOf",params:Object.assign({},{branchErrors:t-p})};e===null?e=[u]:e.push(u),t++}}}else{const a={instancePath:i+"/attributes",schemaPath:"#/properties/attributes/type",keyword:"type",params:{type:"object"}};e===null?e=[a]:e.push(a),t++}}}else{const o={instancePath:i,schemaPath:"#/type",keyword:"type",params:{type:"object"}};e===null?e=[o]:e.push(o),t++}return P.errors=e,t===0}P.evaluated={props:!0,dynamicProps:!1,dynamicItems:!1};export{D as default,E as validate};

package/dist/compiled/index.js

@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+
+import v0 from "./0.8.0/audio-transcription.js";
+import v1 from "./0.8.0/classification.js";
+import v2 from "./0.8.0/document-extraction.js";
+import v3 from "./0.8.0/embedding.js";
+import v4 from "./0.8.0/entity-extraction.js";
+import v5 from "./0.8.0/generic.js";
+import v6 from "./0.8.0/geolocation.js";
+import v7 from "./0.8.0/llm-output.js";
+import v8 from "./0.8.0/object-detection.js";
+import v9 from "./0.8.0/ranking.js";
+import v10 from "./0.8.0/regression.js";
+import v11 from "./0.8.0/temporal-segmentation.js";
+
+export const COMPILED = new Map([
+  ["audio-transcription", new Map([["0.8.0", v0]])],
+  ["classification", new Map([["0.8.0", v1]])],
+  ["document-extraction", new Map([["0.8.0", v2]])],
+  ["embedding", new Map([["0.8.0", v3]])],
+  ["entity-extraction", new Map([["0.8.0", v4]])],
+  ["generic", new Map([["0.8.0", v5]])],
+  ["geolocation", new Map([["0.8.0", v6]])],
+  ["llm-output", new Map([["0.8.0", v7]])],
+  ["object-detection", new Map([["0.8.0", v8]])],
+  ["ranking", new Map([["0.8.0", v9]])],
+  ["regression", new Map([["0.8.0", v10]])],
+  ["temporal-segmentation", new Map([["0.8.0", v11]])],
+]);

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/** Return `text`, cut to at most `limit` characters with a trailing `…` if it is longer. */
+export declare function shorten(text: string, limit: number): string;
+/** Return a short, bounded description of a requested name or version, for an error message. */
+export declare function describe(value: unknown): string;
+/** Thrown when a schema name exists in no bundled version. */
+export declare class UnknownSchemaError extends Error {
+    name: string;
+    /** The name that was requested, cut to 100 characters if it is a longer string. */
+    readonly schemaName: unknown;
+    constructor(schemaName: unknown);
+}
+/**
+ * Thrown when a schema version is not bundled, or does not contain the requested schema.
+ * Versions must be exact, such as `"0.8.0"`; `"0.8"` and `"latest"` are not bundled versions.
+ */
+export declare class SchemaLookupError extends Error {
+    name: string;
+    /** The schema name that was requested. */
+    readonly schemaName: string;
+    /** The schema version that was requested, cut to 100 characters if it is a longer string. */
+    readonly schemaVersion: unknown;
+    constructor(schemaName: string, schemaVersion: unknown, message: string);
+}
+/** Return the error for a version that is not bundled. */
+export declare function unbundledVersion(name: string, version: unknown): SchemaLookupError;
+/** Return the error for a bundled version that does not contain the schema. */
+export declare function missingFromVersion(name: string, version: string): SchemaLookupError;

package/dist/errors.js

@@ -0,0 +1,63 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+import { SCHEMA_NAMES, SCHEMA_VERSIONS } from "./names.js";
+const DESCRIBE_LIMIT = 100;
+/** Return `text`, cut to at most `limit` characters with a trailing `…` if it is longer. */
+export function shorten(text, limit) {
+    if (text.length <= limit) {
+        return text;
+    }
+    let end = limit - 1;
+    const last = text.charCodeAt(end - 1);
+    if (last >= 0xd800 && last <= 0xdbff) {
+        end -= 1;
+    }
+    return `${text.slice(0, end)}…`;
+}
+/** Return a short, bounded description of a requested name or version, for an error message. */
+export function describe(value) {
+    if (typeof value === "string") {
+        return JSON.stringify(shorten(value, DESCRIBE_LIMIT));
+    }
+    if (value === null || ["undefined", "number", "boolean", "bigint"].includes(typeof value)) {
+        return shorten(String(value), DESCRIBE_LIMIT);
+    }
+    return `a value of type ${typeof value}`;
+}
+function bounded(value) {
+    return typeof value === "string" ? shorten(value, DESCRIBE_LIMIT) : value;
+}
+/** Thrown when a schema name exists in no bundled version. */
+export class UnknownSchemaError extends Error {
+    name = "UnknownSchemaError";
+    /** The name that was requested, cut to 100 characters if it is a longer string. */
+    schemaName;
+    constructor(schemaName) {
+        super(`unknown schema name ${describe(schemaName)}; expected one of ${[...SCHEMA_NAMES].sort().join(", ")}`);
+        this.schemaName = bounded(schemaName);
+    }
+}
+/**
+ * Thrown when a schema version is not bundled, or does not contain the requested schema.
+ * Versions must be exact, such as `"0.8.0"`; `"0.8"` and `"latest"` are not bundled versions.
+ */
+export class SchemaLookupError extends Error {
+    name = "SchemaLookupError";
+    /** The schema name that was requested. */
+    schemaName;
+    /** The schema version that was requested, cut to 100 characters if it is a longer string. */
+    schemaVersion;
+    constructor(schemaName, schemaVersion, message) {
+        super(message);
+        this.schemaName = bounded(schemaName);
+        this.schemaVersion = bounded(schemaVersion);
+    }
+}
+/** Return the error for a version that is not bundled. */
+export function unbundledVersion(name, version) {
+    return new SchemaLookupError(name, version, `schema version ${describe(version)} is not bundled; available: ${SCHEMA_VERSIONS.join(", ")}`);
+}
+/** Return the error for a bundled version that does not contain the schema. */
+export function missingFromVersion(name, version) {
+    return new SchemaLookupError(name, version, `schema ${describe(name)} is not in schema version ${version}`);
+}

package/dist/formats.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return whether `value` is an RFC 3339 `date-time`, as JSON Schema's `date-time` format requires.
+ *
+ * The date and time are separated by `T` (or `t`), the offset is `Z` (or `z`) or `±hh:mm`, and the date must exist.
+ * A leap second (`:60`) is accepted only at 23:59 UTC, after applying the offset.
+ */
+export declare function isDateTime(value: string): boolean;
+/**
+ * Return whether `value` is an absolute RFC 3986 URI, as JSON Schema's `uri` format requires.
+ *
+ * Only ASCII is accepted, so an IRI or a URI with an unencoded space is not a `uri`. An empty path, as in `x:`, is.
+ */
+export declare function isUri(value: string): boolean;

package/dist/formats.js

@@ -0,0 +1,106 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+const DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:[Zz]|([+-])(\d{2}):(\d{2}))$/;
+const DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+const UNRESERVED = "A-Za-z0-9\\-._~";
+const SUB_DELIMS = "!$&'()*+,;=";
+const PCT = "%[0-9A-Fa-f]{2}";
+const PCHAR = `(?:[${UNRESERVED}${SUB_DELIMS}:@]|${PCT})`;
+const SEGMENT = `${PCHAR}*`;
+const SEGMENT_NZ = `${PCHAR}+`;
+const H16 = "[0-9A-Fa-f]{1,4}";
+const DEC_OCTET = "(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])";
+const IPV4 = `${DEC_OCTET}(?:\\.${DEC_OCTET}){3}`;
+const LS32 = `(?:${H16}:${H16}|${IPV4})`;
+const IPV6 = [
+    `(?:${H16}:){6}${LS32}`,
+    `::(?:${H16}:){5}${LS32}`,
+    `(?:${H16})?::(?:${H16}:){4}${LS32}`,
+    `(?:(?:${H16}:){0,1}${H16})?::(?:${H16}:){3}${LS32}`,
+    `(?:(?:${H16}:){0,2}${H16})?::(?:${H16}:){2}${LS32}`,
+    `(?:(?:${H16}:){0,3}${H16})?::${H16}:${LS32}`,
+    `(?:(?:${H16}:){0,4}${H16})?::${LS32}`,
+    `(?:(?:${H16}:){0,5}${H16})?::${H16}`,
+    `(?:(?:${H16}:){0,6}${H16})?::`,
+].join("|");
+const IP_FUTURE = `[vV][0-9A-Fa-f]+\\.[${UNRESERVED}${SUB_DELIMS}:]+`;
+const HOST = `(?:\\[(?:${IPV6}|${IP_FUTURE})\\]|(?:[${UNRESERVED}${SUB_DELIMS}]|${PCT})*)`;
+const AUTHORITY = `(?:(?:[${UNRESERVED}${SUB_DELIMS}:]|${PCT})*@)?${HOST}(?::[0-9]*)?`;
+const HIER_PART = `(?:\\/\\/${AUTHORITY}(?:\\/${SEGMENT})*|\\/(?:${SEGMENT_NZ}(?:\\/${SEGMENT})*)?|${SEGMENT_NZ}(?:\\/${SEGMENT})*)?`;
+const QUERY = `(?:${PCHAR}|[/?])*`;
+const URI = new RegExp(`^[A-Za-z][A-Za-z0-9+\\-.]*:${HIER_PART}(?:\\?${QUERY})?(?:#${QUERY})?$`);
+let checking = true;
+function isLeapYear(year) {
+    return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+}
+/**
+ * Return whether `value` is an RFC 3339 `date-time`, as JSON Schema's `date-time` format requires.
+ *
+ * The date and time are separated by `T` (or `t`), the offset is `Z` (or `z`) or `±hh:mm`, and the date must exist.
+ * A leap second (`:60`) is accepted only at 23:59 UTC, after applying the offset.
+ */
+export function isDateTime(value) {
+    const match = DATE_TIME.exec(value);
+    if (match === null) {
+        return false;
+    }
+    const [year, month, day, hour, minute, second] = match.slice(1, 7).map(Number);
+    if (month < 1 || month > 12 || day < 1) {
+        return false;
+    }
+    const days = month === 2 && isLeapYear(year) ? 29 : (DAYS_IN_MONTH[month - 1] ?? 0);
+    if (day > days || hour > 23 || minute > 59 || second > 60) {
+        return false;
+    }
+    const offsetHour = match[8] === undefined ? 0 : Number(match[8]);
+    const offsetMinute = match[9] === undefined ? 0 : Number(match[9]);
+    if (offsetHour > 23 || offsetMinute > 59) {
+        return false;
+    }
+    if (second === 60) {
+        const sign = match[7] === "-" ? -1 : 1;
+        const utc = (((hour * 60 + minute - sign * (offsetHour * 60 + offsetMinute)) % 1440) + 1440) % 1440;
+        return utc === 23 * 60 + 59;
+    }
+    return true;
+}
+/**
+ * Return whether `value` is an absolute RFC 3986 URI, as JSON Schema's `uri` format requires.
+ *
+ * Only ASCII is accepted, so an IRI or a URI with an unencoded space is not a `uri`. An empty path, as in `x:`, is.
+ */
+export function isUri(value) {
+    return URI.test(value);
+}
+/** @internal */
+export function ucs2length(value) {
+    const length = value.length;
+    let count = 0;
+    for (let index = 0; index < length; index++) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff && index + 1 < length) {
+            const next = value.charCodeAt(index + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                index++;
+            }
+        }
+        count++;
+    }
+    return count;
+}
+/** @internal */
+export const FORMATS = Object.freeze({
+    "date-time": (value) => !checking || isDateTime(value),
+    uri: (value) => !checking || isUri(value),
+});
+/** @internal */
+export function withFormats(check, action) {
+    const previous = checking;
+    checking = check;
+    try {
+        return action();
+    }
+    finally {
+        checking = previous;
+    }
+}

package/dist/index.d.ts

@@ -1,26 +1,6 @@
-/** The names of the schemas in {@link SCHEMA_VERSION}. Older bundled versions contain a subset of them. */
-export declare const SCHEMA_NAMES: readonly [
-    "audio-transcription",
-    "classification",
-    "document-extraction",
-    "embedding",
-    "entity-extraction",
-    "generic",
-    "geolocation",
-    "llm-output",
-    "object-detection",
-    "ranking",
-    "regression",
-    "temporal-segmentation"
-];
-/** The name of an OATS schema, such as `"classification"`. */
-export type SchemaName = (typeof SCHEMA_NAMES)[number];
-/**
- * The newest bundled OATS schema version, used when no version is given.
- *
- * A schema's own version is in its `x-version` keyword.
- */
-export declare const SCHEMA_VERSION = "0.8.0";
+import { type SchemaName, type SchemaVersion } from "./names.ts";
+export { SchemaLookupError, UnknownSchemaError } from "./errors.ts";
+export { isSchemaVersion, SCHEMA_NAMES, SCHEMA_VERSION, type SchemaName, type SchemaVersion } from "./names.ts";
 /** A JSON value, as parsed from a schema file. */
 export type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
@@ -29,27 +9,8 @@ export type JsonValue = string | number | boolean | null | JsonValue[] | {
 export type Schema = {
     [key: string]: JsonValue;
 };
-/** Thrown when a schema name exists in no bundled version. */
-export declare class UnknownSchemaError extends Error {
-    name: string;
-    /** The name that was requested. */
-    readonly schemaName: unknown;
-    constructor(schemaName: unknown);
-}
-/**
- * Thrown when a schema version is not bundled, or does not contain the requested schema.
- * Versions must be exact, such as `"0.8.0"`; `"0.8"` and `"latest"` are not bundled versions.
- */
-export declare class SchemaLookupError extends Error {
-    name: string;
-    /** The schema name that was requested. */
-    readonly schemaName: string;
-    /** The schema version that was requested. */
-    readonly schemaVersion: unknown;
-    constructor(schemaName: string, schemaVersion: unknown, message: string);
-}
 /** Return every bundled schema version, oldest first. */
-export declare function availableVersions(): string[];
+export declare function availableVersions(): SchemaVersion[];
 /**
  * Return the schema `name` from schema version `version`, or from {@link SCHEMA_VERSION} if it is omitted.
  *
@@ -60,7 +21,7 @@ export declare function availableVersions(): string[];
  * @throws {UnknownSchemaError} `name` is not a schema in any bundled version.
  * @throws {SchemaLookupError} `version` is not bundled, or does not contain `name`.
  */
-export declare function getSchema(name: SchemaName, version?: string): Schema;
+export declare function getSchema(name: SchemaName, version?: SchemaVersion): Schema;
 /**
  * Return the text of the schema `name` from schema version `version` exactly as released, or from
  * {@link SCHEMA_VERSION} if `version` is omitted.
@@ -70,4 +31,4 @@ export declare function getSchema(name: SchemaName, version?: string): Schema;
  * @throws {UnknownSchemaError} `name` is not a schema in any bundled version.
  * @throws {SchemaLookupError} `version` is not bundled, or does not contain `name`.
  */
-export declare function getSchemaJson(name: SchemaName, version?: string): string;
+export declare function getSchemaJson(name: SchemaName, version?: SchemaVersion): string;

package/dist/index.js

@@ -3,79 +3,33 @@
 /**
  * The OATS (Open Annotation Task Schemas) JSON schemas, bundled for JavaScript and TypeScript.
  *
+ * Validation is in `oatschema/validate`, and in `oatschema/validate/<name>` for a single schema.
+ *
  * @module
  */
 import { BUNDLED } from "./bundled.js";
-/** The names of the schemas in {@link SCHEMA_VERSION}. Older bundled versions contain a subset of them. */
-export const SCHEMA_NAMES = Object.freeze([
-    "audio-transcription",
-    "classification",
-    "document-extraction",
-    "embedding",
-    "entity-extraction",
-    "generic",
-    "geolocation",
-    "llm-output",
-    "object-detection",
-    "ranking",
-    "regression",
-    "temporal-segmentation",
-]);
-/**
- * The newest bundled OATS schema version, used when no version is given.
- *
- * A schema's own version is in its `x-version` keyword.
- */
-export const SCHEMA_VERSION = "0.8.0";
-/** Thrown when a schema name exists in no bundled version. */
-export class UnknownSchemaError extends Error {
-    name = "UnknownSchemaError";
-    /** The name that was requested. */
-    schemaName;
-    constructor(schemaName) {
-        const known = [...new Set([...BUNDLED.values()].flatMap((names) => [...names.keys()]))].sort();
-        super(`unknown schema name ${describe(schemaName)}; expected one of ${known.join(", ")}`);
-        this.schemaName = schemaName;
-    }
-}
-/**
- * Thrown when a schema version is not bundled, or does not contain the requested schema.
- * Versions must be exact, such as `"0.8.0"`; `"0.8"` and `"latest"` are not bundled versions.
- */
-export class SchemaLookupError extends Error {
-    name = "SchemaLookupError";
-    /** The schema name that was requested. */
-    schemaName;
-    /** The schema version that was requested. */
-    schemaVersion;
-    constructor(schemaName, schemaVersion, message) {
-        super(message);
-        this.schemaName = schemaName;
-        this.schemaVersion = schemaVersion;
-    }
-}
-function describe(value) {
-    return typeof value === "string" ? JSON.stringify(value) : String(value);
-}
+import { missingFromVersion, UnknownSchemaError, unbundledVersion } from "./errors.js";
+import { SCHEMA_NAMES, SCHEMA_VERSION, SCHEMA_VERSIONS } from "./names.js";
+export { SchemaLookupError, UnknownSchemaError } from "./errors.js";
+export { isSchemaVersion, SCHEMA_NAMES, SCHEMA_VERSION } from "./names.js";
 function lookup(name, version) {
-    const names = [...BUNDLED.values()];
-    if (typeof name !== "string" || !names.some((schemas) => schemas.has(name))) {
+    if (typeof name !== "string" || !SCHEMA_NAMES.includes(name)) {
         throw new UnknownSchemaError(name);
     }
     const resolved = version === undefined ? SCHEMA_VERSION : version;
     const schemas = typeof resolved === "string" ? BUNDLED.get(resolved) : undefined;
     if (schemas === undefined) {
-        throw new SchemaLookupError(name, resolved, `schema version ${describe(resolved)} is not bundled; available: ${[...BUNDLED.keys()].join(", ")}`);
+        throw unbundledVersion(name, resolved);
     }
     const text = schemas.get(name);
     if (text === undefined) {
-        throw new SchemaLookupError(name, resolved, `schema ${describe(name)} is not in schema version ${resolved}`);
+        throw missingFromVersion(name, resolved);
     }
     return text;
 }
 /** Return every bundled schema version, oldest first. */
 export function availableVersions() {
-    return [...BUNDLED.keys()];
+    return [...SCHEMA_VERSIONS];
 }
 /**
  * Return the schema `name` from schema version `version`, or from {@link SCHEMA_VERSION} if it is omitted.

package/dist/names.d.ts

@@ -0,0 +1,33 @@
+/** The names of the schemas in {@link SCHEMA_VERSION}. Older bundled versions contain a subset of them. */
+export declare const SCHEMA_NAMES: readonly [
+    "audio-transcription",
+    "classification",
+    "document-extraction",
+    "embedding",
+    "entity-extraction",
+    "generic",
+    "geolocation",
+    "llm-output",
+    "object-detection",
+    "ranking",
+    "regression",
+    "temporal-segmentation"
+];
+/** The name of an OATS schema, such as `"classification"`. */
+export type SchemaName = (typeof SCHEMA_NAMES)[number];
+/** Every bundled schema version, oldest first. */
+export declare const SCHEMA_VERSIONS: readonly ["0.8.0"];
+/** A bundled OATS schema version, such as `"0.8.0"`. */
+export type SchemaVersion = (typeof SCHEMA_VERSIONS)[number];
+/**
+ * The newest bundled OATS schema version, used when no version is given.
+ *
+ * A schema's own version is in its `x-version` keyword.
+ */
+export declare const SCHEMA_VERSION: SchemaVersion;
+/**
+ * Return whether `value` is a bundled schema version, narrowing it to {@link SchemaVersion}.
+ *
+ * Use it on a version read from a record before passing it to `getSchema` or a validator.
+ */
+export declare function isSchemaVersion(value: unknown): value is SchemaVersion;

package/dist/names.js

@@ -0,0 +1,33 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+/** The names of the schemas in {@link SCHEMA_VERSION}. Older bundled versions contain a subset of them. */
+export const SCHEMA_NAMES = Object.freeze([
+    "audio-transcription",
+    "classification",
+    "document-extraction",
+    "embedding",
+    "entity-extraction",
+    "generic",
+    "geolocation",
+    "llm-output",
+    "object-detection",
+    "ranking",
+    "regression",
+    "temporal-segmentation",
+]);
+/** Every bundled schema version, oldest first. */
+export const SCHEMA_VERSIONS = Object.freeze(["0.8.0"]);
+/**
+ * The newest bundled OATS schema version, used when no version is given.
+ *
+ * A schema's own version is in its `x-version` keyword.
+ */
+export const SCHEMA_VERSION = "0.8.0";
+/**
+ * Return whether `value` is a bundled schema version, narrowing it to {@link SchemaVersion}.
+ *
+ * Use it on a version read from a record before passing it to `getSchema` or a validator.
+ */
+export function isSchemaVersion(value) {
+    return typeof value === "string" && SCHEMA_VERSIONS.includes(value);
+}

package/dist/validate/audio-transcription.d.ts

@@ -0,0 +1,27 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Validation of records against the `audio-transcription` OATS schema only, with precompiled validators.
+ *
+ * @module
+ */
+
+import type { SchemaVersion } from "../names.js";
+import type { ValidateOptions, Validator } from "../validation.js";
+
+export { SchemaLookupError } from "../errors.js";
+export { ValidationError, type ValidationErrorDetails, type ValidateOptions, type Validator } from "../validation.js";
+
+/**
+ * Return a cached {@link Validator} for the `audio-transcription` schema in schema version `version`, or in
+ * `SCHEMA_VERSION` if `version` is omitted.
+ *
+ * Formats (`date-time`, `uri`, …) are checked unless `options.checkFormats` is `false`.
+ *
+ * @param version An exact bundled version such as `"0.8.0"`.
+ * @param options Validation options.
+ * @throws {SchemaLookupError} `version` is not bundled, or does not contain `audio-transcription`.
+ * @throws {TypeError} `options` is not an object, has an unknown key, or `checkFormats` is not a boolean.
+ */
+export declare function getValidator(version?: SchemaVersion, options?: ValidateOptions): Validator;

package/dist/validate/audio-transcription.js

@@ -0,0 +1,14 @@
+// SPDX-FileCopyrightText: 2026 The OATS Authors
+// SPDX-License-Identifier: Apache-2.0
+
+import v0 from "../compiled/0.8.0/audio-transcription.js";
+import { versionValidator } from "../validation.js";
+
+export { SchemaLookupError } from "../errors.js";
+export { ValidationError } from "../validation.js";
+
+const VERSIONS = new Map([["0.8.0", v0]]);
+
+export function getValidator(version, options) {
+  return versionValidator("audio-transcription", VERSIONS, version, options);
+}