@ggts-sh/spec 0.43.0

package/dist/schema-decls-scales-guides.js

@@ -0,0 +1,189 @@
+/**
+ * `$defs` partial — style-scale schemas + shared scale helper builders.
+ * Composed by schema-declarations.ts via spread; key insertion order is load-bearing.
+ */
+import Type from "typebox";
+import { MAX_BINNED_BREAKS } from "./schema-names.js";
+import { LINETYPE_NAME_SCHEMAS, POINT_SHAPE_NAME_SCHEMAS } from "./schema-name-schemas.js";
+const forbiddenStyleOption = () => Type.Optional(Type.Never());
+/** Size aesthetic only (#830). Shared onto PositiveStyleScaleSpec (size+linewidth). */
+const sizeUnitField = {
+    /**
+     * Size-only rescaling mode (ignored for linewidth). Default `area` matches
+     * the existing continuous size map (area between range endpoints).
+     * `radius` is linear; `area_zero` forces zero→zero area (ggplot2 scale_size_area).
+     */
+    sizeUnit: Type.Optional(Type.Union([Type.Literal("area"), Type.Literal("radius"), Type.Literal("area_zero")], {
+        description: 'Size encoding unit (size aesthetic only). "area" (default) interpolates by area between range endpoints; "radius" maps linearly to radius; "area_zero" maps value proportionally to area with zero→zero.',
+    })),
+};
+function numericStyleScaleSpec(rangeValue, description, 
+/** Extra optional fields on the base object (e.g. sizeUnit for PositiveStyleScaleSpec). */
+extraFields = {}) {
+    return Type.Intersect([
+        Type.Object({
+            type: Type.Optional(Type.Union([
+                Type.Literal("ordinal"),
+                Type.Literal("sequential"),
+                Type.Literal("binned"),
+                Type.Literal("manual"),
+                Type.Literal("identity"),
+            ])),
+            temporalKind: Type.Optional(Type.Union([Type.Literal("date"), Type.Literal("datetime")])),
+            parse: Type.Optional(Type.Ref("TemporalParserSpec")),
+            parseFailure: Type.Optional(Type.Union([Type.Literal("error"), Type.Literal("censor")])),
+            timezone: Type.Optional(Type.String({ minLength: 1, maxLength: 128 })),
+            disambiguation: Type.Optional(Type.Union([
+                Type.Literal("compatible"),
+                Type.Literal("earlier"),
+                Type.Literal("later"),
+                Type.Literal("reject"),
+            ])),
+            domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), { minItems: 1 })),
+            domainMode: Type.Optional(Type.Union([Type.Literal("grow"), Type.Literal("data")])),
+            breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), { minItems: 2 })),
+            range: Type.Optional(Type.Array(rangeValue, { minItems: 1 })),
+            reverse: Type.Optional(Type.Boolean()),
+            oob: Type.Optional(Type.Union([Type.Literal("censor"), Type.Literal("squish")])),
+            naValue: Type.Optional(rangeValue),
+            unknownValue: Type.Optional(rangeValue),
+            onExhaust: Type.Optional(Type.Union([Type.Literal("cycle"), Type.Literal("error")])),
+            labels: Type.Optional(Type.String()),
+            guide: Type.Optional(Type.Ref("GuideSpec")),
+            ...extraFields,
+        }, { additionalProperties: false, description }),
+        Type.Union([
+            Type.Object({
+                type: Type.Literal("binned"),
+                domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), { minItems: 2, maxItems: 2 })),
+                breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), {
+                    minItems: 2,
+                    maxItems: MAX_BINNED_BREAKS + 1,
+                })),
+                range: Type.Optional(Type.Array(rangeValue, { minItems: 2 })),
+                domainMode: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("manual"),
+                range: Type.Array(rangeValue, { minItems: 1 }),
+                temporalKind: forbiddenStyleOption(),
+                parse: forbiddenStyleOption(),
+                parseFailure: forbiddenStyleOption(),
+                timezone: forbiddenStyleOption(),
+                disambiguation: forbiddenStyleOption(),
+                domainMode: forbiddenStyleOption(),
+                breaks: forbiddenStyleOption(),
+                reverse: forbiddenStyleOption(),
+                oob: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("identity"),
+                temporalKind: forbiddenStyleOption(),
+                parse: forbiddenStyleOption(),
+                parseFailure: forbiddenStyleOption(),
+                timezone: forbiddenStyleOption(),
+                disambiguation: forbiddenStyleOption(),
+                domain: forbiddenStyleOption(),
+                domainMode: forbiddenStyleOption(),
+                breaks: forbiddenStyleOption(),
+                range: forbiddenStyleOption(),
+                reverse: forbiddenStyleOption(),
+                oob: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("ordinal"),
+                temporalKind: forbiddenStyleOption(),
+                parse: forbiddenStyleOption(),
+                parseFailure: forbiddenStyleOption(),
+                timezone: forbiddenStyleOption(),
+                disambiguation: forbiddenStyleOption(),
+                breaks: forbiddenStyleOption(),
+                oob: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("sequential"),
+                domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), { minItems: 2, maxItems: 2 })),
+                range: Type.Optional(Type.Array(rangeValue, { minItems: 2 })),
+                domainMode: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+            }),
+            Type.Object({ type: forbiddenStyleOption() }),
+        ]),
+    ]);
+}
+function finiteStyleScaleSpec(rangeValue, description) {
+    return Type.Intersect([
+        Type.Object({
+            type: Type.Optional(Type.Union([
+                Type.Literal("ordinal"),
+                Type.Literal("binned"),
+                Type.Literal("manual"),
+                Type.Literal("identity"),
+            ])),
+            domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), { minItems: 1 })),
+            domainMode: Type.Optional(Type.Union([Type.Literal("grow"), Type.Literal("data")])),
+            breaks: Type.Optional(Type.Array(Type.Number(), { minItems: 2 })),
+            range: Type.Optional(Type.Array(rangeValue, { minItems: 1 })),
+            reverse: Type.Optional(Type.Boolean()),
+            naValue: Type.Optional(rangeValue),
+            unknownValue: Type.Optional(rangeValue),
+            onExhaust: Type.Optional(Type.Union([Type.Literal("cycle"), Type.Literal("error")])),
+            labels: Type.Optional(Type.String()),
+            guide: Type.Optional(Type.Ref("GuideSpec")),
+        }, { additionalProperties: false, description }),
+        Type.Union([
+            Type.Object({
+                type: Type.Literal("binned"),
+                domain: Type.Optional(Type.Array(Type.Number(), { minItems: 2, maxItems: 2 })),
+                breaks: Type.Optional(Type.Array(Type.Number(), { minItems: 2, maxItems: MAX_BINNED_BREAKS + 1 })),
+                domainMode: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("manual"),
+                range: Type.Array(rangeValue, { minItems: 1 }),
+                domainMode: forbiddenStyleOption(),
+                breaks: forbiddenStyleOption(),
+                reverse: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("identity"),
+                domain: forbiddenStyleOption(),
+                domainMode: forbiddenStyleOption(),
+                breaks: forbiddenStyleOption(),
+                range: forbiddenStyleOption(),
+                reverse: forbiddenStyleOption(),
+                onExhaust: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("ordinal"),
+                breaks: forbiddenStyleOption(),
+                labels: forbiddenStyleOption(),
+            }),
+            Type.Object({ type: forbiddenStyleOption() }),
+        ]),
+    ]);
+}
+export const StyleScaleDecls = {
+    /**
+     * Size + linewidth share this schema. `sizeUnit` is size-only at runtime
+     * (ignored for linewidth); alpha uses AlphaScaleSpec without sizeUnit so
+     * the option cannot validate as a silent no-op (#830).
+     */
+    PositiveStyleScaleSpec: numericStyleScaleSpec(
+    // minimum 0 allows scale_size_area zero-area radii; linewidth 0 is also valid.
+    Type.Number({ minimum: 0 }), "Configuration for a non-negative numeric size or linewidth scale.", sizeUnitField),
+    AlphaScaleSpec: numericStyleScaleSpec(Type.Number({ minimum: 0, maximum: 1 }), "Configuration for an opacity scale constrained to [0, 1]."),
+    ShapeScaleSpec: finiteStyleScaleSpec(Type.Union(POINT_SHAPE_NAME_SCHEMAS), "Configuration for a finite point-shape scale."),
+    LinetypeScaleSpec: finiteStyleScaleSpec(Type.Union(LINETYPE_NAME_SCHEMAS), "Configuration for a finite line-pattern scale."),
+};
+//# sourceMappingURL=schema-decls-scales-guides.js.map

package/dist/schema-decls-scales-guides.js.map

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

package/dist/schema-decls-scales.d.ts

@@ -0,0 +1,124 @@
+/**
+ * `$defs` partial — scale base schemas (DomainValue…ColorScaleSpec).
+ * Composed by schema-declarations.ts via spread; key insertion order is load-bearing.
+ */
+import Type from "typebox";
+export declare const ScaleDecls: {
+    DomainValue: Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>;
+    TemporalParserSpec: Type.TUnion<[Type.TUnion<[Type.TLiteral<"iso" | "year" | "ym" | "my" | "yq" | "md" | "ymd" | "ydm" | "mdy" | "myd" | "dmy" | "dym" | "ymd_hm" | "ymd_hms" | "ydm_hm" | "ydm_hms" | "mdy_hm" | "mdy_hms" | "myd_hm" | "myd_hms" | "dmy_hm" | "dmy_hms" | "dym_hm" | "dym_hms">, ...Type.TLiteral<"iso" | "year" | "ym" | "my" | "yq" | "md" | "ymd" | "ydm" | "mdy" | "myd" | "dmy" | "dym" | "ymd_hm" | "ymd_hms" | "ydm_hm" | "ydm_hms" | "mdy_hm" | "mdy_hms" | "myd_hm" | "myd_hms" | "dmy_hm" | "dmy_hms" | "dym_hm" | "dym_hms">[]]>, Type.TObject<{
+        format: Type.TString;
+    }>, Type.TObject<{
+        epoch: Type.TUnion<[Type.TLiteral<"seconds">, Type.TLiteral<"milliseconds">]>;
+    }>]>;
+    ScaleExpansion: Type.TObject<{
+        mult: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TArray<Type.TNumber>]>>;
+        add: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TArray<Type.TNumber>]>>;
+    }>;
+    PositionScaleSpec: Type.TIntersect<[Type.TObject<{
+        type: Type.TOptional<Type.TUnion<[Type.TLiteral<"linear">, Type.TLiteral<"log">, Type.TLiteral<"time">, Type.TLiteral<"band">, Type.TLiteral<"binned">]>>;
+        transform: Type.TOptional<Type.TUnion<[Type.TLiteral<"identity">, Type.TLiteral<"log10">, Type.TLiteral<"sqrt">]>>;
+        temporalKind: Type.TOptional<Type.TUnion<[Type.TLiteral<"date">, Type.TLiteral<"datetime">, Type.TLiteral<"time">, Type.TLiteral<"monthDay">]>>;
+        parse: Type.TOptional<Type.TRef<"TemporalParserSpec">>;
+        parseFailure: Type.TOptional<Type.TUnion<[Type.TLiteral<"error">, Type.TLiteral<"censor">]>>;
+        timezone: Type.TOptional<Type.TString>;
+        disambiguation: Type.TOptional<Type.TUnion<[Type.TLiteral<"compatible">, Type.TLiteral<"earlier">, Type.TLiteral<"later">, Type.TLiteral<"reject">]>>;
+        dateBreaks: Type.TOptional<Type.TString>;
+        dateMinorBreaks: Type.TOptional<Type.TString>;
+        dateLabels: Type.TOptional<Type.TString>;
+        locale: Type.TOptional<Type.TString>;
+        weekStart: Type.TOptional<Type.TUnion<[Type.TLiteral<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday">, ...Type.TLiteral<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday">[]]>>;
+        domain: Type.TOptional<Type.TArray<Type.TRef<"DomainValue">>>;
+        nice: Type.TOptional<Type.TBoolean>;
+        zero: Type.TOptional<Type.TBoolean>;
+        reverse: Type.TOptional<Type.TBoolean>;
+        breaks: Type.TOptional<Type.TArray<Type.TUnion<[Type.TNumber, Type.TString]>>>;
+        labels: Type.TOptional<Type.TString>;
+        expand: Type.TOptional<Type.TRef<"ScaleExpansion">>;
+        oob: Type.TOptional<Type.TUnion<[Type.TLiteral<"censor">, Type.TLiteral<"squish">]>>;
+        naValue: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TNull]>>;
+        minorBreaks: Type.TOptional<Type.TArray<Type.TNumber>>;
+        guide: Type.TOptional<Type.TUnion<[Type.TRef<"GuideSpec">, Type.TRef<"BandAxisGuideSpec">]>>;
+    }>, Type.TUnion<[Type.TObject<{
+        type: Type.TLiteral<"binned">;
+        breaks: Type.TOptional<Type.TArray<Type.TUnion<[Type.TNumber, Type.TString]>>>;
+    }>, Type.TObject<{
+        type: Type.TOptional<Type.TUnion<[Type.TLiteral<"linear">, Type.TLiteral<"log">, Type.TLiteral<"time">, Type.TLiteral<"band">]>>;
+    }>]>]>;
+    ColorScaleSpec: Type.TIntersect<[Type.TObject<{
+        type: Type.TOptional<Type.TUnion<[Type.TLiteral<"ordinal">, Type.TLiteral<"sequential">, Type.TLiteral<"binned">, Type.TLiteral<"manual">, Type.TLiteral<"identity">]>>;
+        transform: Type.TOptional<Type.TUnion<[Type.TLiteral<"identity">, Type.TLiteral<"log10">, Type.TLiteral<"sqrt">]>>;
+        temporalKind: Type.TOptional<Type.TUnion<[Type.TLiteral<"date">, Type.TLiteral<"datetime">]>>;
+        parse: Type.TOptional<Type.TRef<"TemporalParserSpec">>;
+        parseFailure: Type.TOptional<Type.TUnion<[Type.TLiteral<"error">, Type.TLiteral<"censor">]>>;
+        timezone: Type.TOptional<Type.TString>;
+        disambiguation: Type.TOptional<Type.TUnion<[Type.TLiteral<"compatible">, Type.TLiteral<"earlier">, Type.TLiteral<"later">, Type.TLiteral<"reject">]>>;
+        domain: Type.TOptional<Type.TArray<Type.TRef<"DomainValue">>>;
+        domainMode: Type.TOptional<Type.TUnion<[Type.TLiteral<"grow">, Type.TLiteral<"data">]>>;
+        breaks: Type.TOptional<Type.TArray<Type.TUnion<[Type.TNumber, Type.TString]>>>;
+        range: Type.TOptional<Type.TArray<Type.TString>>;
+        scheme: Type.TOptional<Type.TUnion<[Type.TLiteral<"observable10" | "ipsum" | "flexoki" | "colorblind" | "stata" | "economist" | "solarized" | "few" | "few_light" | "few_dark" | "fivethirtyeight" | "ptol" | "canva" | "wsj" | "wsj_rgby" | "wsj_red_green" | "wsj_black_green" | "wsj_dem_rep" | "tableau20" | "tableau_colorblind" | "tableau_seattle_grays" | "tableau_jewel_bright" | "tableau_hue_circle" | "pander" | "Dark2" | "hue" | "actonS" | "bamakoS" | "batlowS" | "batlowWS" | "batlowKS" | "bilbaoS" | "budaS" | "davosS" | "devonS" | "glasgowS" | "grayCS" | "hawaiiS" | "imolaS" | "lajollaS" | "lapazS" | "lipariS" | "naviaS" | "nuukS" | "osloS" | "tokyoS" | "turkuS" | "viridis" | "magma" | "plasma" | "inferno" | "cividis" | "turbo" | "Blues" | "Greens" | "Reds" | "Oranges" | "Purples" | "Greys" | "YlOrRd" | "YlGnBu" | "BuPu" | "RdYlBu" | "RdBu" | "BrBG" | "Spectral" | "PuOr" | "acton" | "bamako" | "batlow" | "batlowW" | "batlowK" | "bilbao" | "buda" | "davos" | "devon" | "glasgow" | "grayC" | "hawaii" | "imola" | "lajolla" | "lapaz" | "lipari" | "navia" | "naviaW" | "nuuk" | "oslo" | "tokyo" | "turku" | "bam" | "berlin" | "broc" | "cork" | "lisbon" | "managua" | "roma" | "tofino" | "vanimo" | "vik" | "bukavu" | "fes" | "oleron" | "bamO" | "brocO" | "corkO" | "romaO" | "vikO">, ...Type.TLiteral<"observable10" | "ipsum" | "flexoki" | "colorblind" | "stata" | "economist" | "solarized" | "few" | "few_light" | "few_dark" | "fivethirtyeight" | "ptol" | "canva" | "wsj" | "wsj_rgby" | "wsj_red_green" | "wsj_black_green" | "wsj_dem_rep" | "tableau20" | "tableau_colorblind" | "tableau_seattle_grays" | "tableau_jewel_bright" | "tableau_hue_circle" | "pander" | "Dark2" | "hue" | "actonS" | "bamakoS" | "batlowS" | "batlowWS" | "batlowKS" | "bilbaoS" | "budaS" | "davosS" | "devonS" | "glasgowS" | "grayCS" | "hawaiiS" | "imolaS" | "lajollaS" | "lapazS" | "lipariS" | "naviaS" | "nuukS" | "osloS" | "tokyoS" | "turkuS" | "viridis" | "magma" | "plasma" | "inferno" | "cividis" | "turbo" | "Blues" | "Greens" | "Reds" | "Oranges" | "Purples" | "Greys" | "YlOrRd" | "YlGnBu" | "BuPu" | "RdYlBu" | "RdBu" | "BrBG" | "Spectral" | "PuOr" | "acton" | "bamako" | "batlow" | "batlowW" | "batlowK" | "bilbao" | "buda" | "davos" | "devon" | "glasgow" | "grayC" | "hawaii" | "imola" | "lajolla" | "lapaz" | "lipari" | "navia" | "naviaW" | "nuuk" | "oslo" | "tokyo" | "turku" | "bam" | "berlin" | "broc" | "cork" | "lisbon" | "managua" | "roma" | "tofino" | "vanimo" | "vik" | "bukavu" | "fes" | "oleron" | "bamO" | "brocO" | "corkO" | "romaO" | "vikO">[]]>>;
+        reverse: Type.TOptional<Type.TBoolean>;
+        oob: Type.TOptional<Type.TUnion<[Type.TLiteral<"censor">, Type.TLiteral<"squish">, Type.TLiteral<"wrap">]>>;
+        naValue: Type.TOptional<Type.TString>;
+        unknownValue: Type.TOptional<Type.TString>;
+        onExhaust: Type.TOptional<Type.TUnion<[Type.TLiteral<"cycle">, Type.TLiteral<"error">]>>;
+        labels: Type.TOptional<Type.TString>;
+        guide: Type.TOptional<Type.TRef<"GuideSpec">>;
+    }>, Type.TUnion<[Type.TObject<{
+        type: Type.TLiteral<"binned">;
+        breaks: Type.TOptional<Type.TArray<Type.TUnion<[Type.TNumber, Type.TString]>>>;
+        domainMode: Type.TOptional<Type.TNever>;
+        onExhaust: Type.TOptional<Type.TNever>;
+    }>, Type.TObject<{
+        type: Type.TLiteral<"manual">;
+        range: Type.TArray<Type.TString>;
+        transform: Type.TOptional<Type.TNever>;
+        temporalKind: Type.TOptional<Type.TNever>;
+        parse: Type.TOptional<Type.TNever>;
+        parseFailure: Type.TOptional<Type.TNever>;
+        timezone: Type.TOptional<Type.TNever>;
+        disambiguation: Type.TOptional<Type.TNever>;
+        domainMode: Type.TOptional<Type.TNever>;
+        breaks: Type.TOptional<Type.TNever>;
+        scheme: Type.TOptional<Type.TNever>;
+        reverse: Type.TOptional<Type.TNever>;
+        oob: Type.TOptional<Type.TNever>;
+        onExhaust: Type.TOptional<Type.TNever>;
+        labels: Type.TOptional<Type.TNever>;
+    }>, Type.TObject<{
+        type: Type.TLiteral<"identity">;
+        transform: Type.TOptional<Type.TNever>;
+        temporalKind: Type.TOptional<Type.TNever>;
+        parse: Type.TOptional<Type.TNever>;
+        parseFailure: Type.TOptional<Type.TNever>;
+        timezone: Type.TOptional<Type.TNever>;
+        disambiguation: Type.TOptional<Type.TNever>;
+        domain: Type.TOptional<Type.TNever>;
+        domainMode: Type.TOptional<Type.TNever>;
+        breaks: Type.TOptional<Type.TNever>;
+        range: Type.TOptional<Type.TNever>;
+        scheme: Type.TOptional<Type.TNever>;
+        reverse: Type.TOptional<Type.TNever>;
+        oob: Type.TOptional<Type.TNever>;
+        onExhaust: Type.TOptional<Type.TNever>;
+        labels: Type.TOptional<Type.TNever>;
+    }>, Type.TObject<{
+        type: Type.TLiteral<"ordinal">;
+        transform: Type.TOptional<Type.TNever>;
+        temporalKind: Type.TOptional<Type.TNever>;
+        parse: Type.TOptional<Type.TNever>;
+        parseFailure: Type.TOptional<Type.TNever>;
+        timezone: Type.TOptional<Type.TNever>;
+        disambiguation: Type.TOptional<Type.TNever>;
+        breaks: Type.TOptional<Type.TNever>;
+        oob: Type.TOptional<Type.TNever>;
+        labels: Type.TOptional<Type.TNever>;
+    }>, Type.TObject<{
+        type: Type.TLiteral<"sequential">;
+        domainMode: Type.TOptional<Type.TNever>;
+        onExhaust: Type.TOptional<Type.TNever>;
+    }>, Type.TObject<{
+        type: Type.TOptional<Type.TNever>;
+    }>]>]>;
+};
+//# sourceMappingURL=schema-decls-scales.d.ts.map

package/dist/schema-decls-scales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-decls-scales.d.ts","sourceRoot":"","sources":["../src/schema-decls-scales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,SAAS,CAAC;AAY3B,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ZtB,CAAC"}

package/dist/schema-decls-scales.js

@@ -0,0 +1,279 @@
+/**
+ * `$defs` partial — scale base schemas (DomainValue…ColorScaleSpec).
+ * Composed by schema-declarations.ts via spread; key insertion order is load-bearing.
+ */
+import Type from "typebox";
+import { COLOR_SCHEME_NAME_SCHEMAS } from "./schema-name-schemas.js";
+import { MAX_BINNED_BREAKS } from "./schema-names.js";
+import { TemporalIntervalSpecSchema, TemporalLabelSpecSchema, TemporalWeekStartSchema, } from "./temporal-interval-schema.js";
+import { TemporalParserSpecSchema } from "./temporal-parse-schema.js";
+const forbiddenColorOption = () => Type.Optional(Type.Never());
+export const ScaleDecls = {
+    DomainValue: Type.Union([Type.String(), Type.Number(), Type.Boolean(), Type.Null()], {
+        description: "One domain entry: a number (linear/log), an ISO 8601 date string (time), or a category value (band/ordinal).",
+    }),
+    TemporalParserSpec: TemporalParserSpecSchema,
+    ScaleExpansion: Type.Object({
+        mult: Type.Optional(Type.Union([
+            Type.Number({ minimum: 0 }),
+            Type.Array(Type.Number({ minimum: 0 }), { minItems: 2, maxItems: 2 }),
+        ], {
+            description: "Multiplicative display padding as a fraction of the (transformed) domain span. A scalar pads both ends; a [lower, upper] tuple pads each end. Non-negative and finite.",
+        })),
+        add: Type.Optional(Type.Union([
+            Type.Number({ minimum: 0 }),
+            Type.Array(Type.Number({ minimum: 0 }), { minItems: 2, maxItems: 2 }),
+        ], {
+            description: "Additive display padding in (transformed) scale units. A scalar pads both ends; a [lower, upper] tuple pads each end. Non-negative and finite.",
+        })),
+    }, {
+        additionalProperties: false,
+        description: "Display-domain expansion. Padding is applied after nice in transformed space and never widens the OOB limits. `{ mult: 0, add: 0 }` disables padding.",
+    }),
+    PositionScaleSpec: Type.Intersect([
+        Type.Object({
+            type: Type.Optional(Type.Union([
+                Type.Literal("linear"),
+                Type.Literal("log"),
+                Type.Literal("time"),
+                Type.Literal("band"),
+                Type.Literal("binned"),
+            ], {
+                description: 'Scale type: "linear" (default for numbers), "time" (temporal fields; ISO strings or Date values), "band" (discrete categories), "binned" (quantitative values assigned to ordered bins). "log" is an accepted authored alias that canonicalizes to { type: "linear", transform: "log10" }. Omit to infer from the field type.',
+            })),
+            transform: Type.Optional(Type.Union([Type.Literal("identity"), Type.Literal("log10"), Type.Literal("sqrt")], {
+                description: 'Pre-stat position transform applied after parsing and before grouping-sensitive stats/positions. "identity" (default), "log10" (base-10; source values must be > 0), "sqrt" (source values must be >= 0). Only "identity" is permitted on time scales.',
+            })),
+            temporalKind: Type.Optional(Type.Union([
+                Type.Literal("date"),
+                Type.Literal("datetime"),
+                Type.Literal("time"),
+                Type.Literal("monthDay"),
+            ], {
+                description: 'Temporal precision intent. "date" uses calendar dates; "datetime" uses instants; "time" is time-of-day (portable numbers are seconds since midnight); "monthDay" collapses the year, so the same calendar day from any year shares one position — values parse with the "md" parser and resolve into a fixed leap reference year, and year, clock, weekday and zone label tokens are rejected. A month-day window cannot cross the year boundary. Supplying this option requests a time scale.',
+            })),
+            parse: Type.Optional(Type.Ref("TemporalParserSpec", {
+                description: "Explicit deterministic parser for temporal source values. Omit for value-driven inference.",
+            })),
+            parseFailure: Type.Optional(Type.Union([Type.Literal("error"), Type.Literal("censor")], {
+                description: 'Explicit parser failure policy: "error" (default) stops with bounded evidence; "censor" converts invalid values to missing and emits a warning.',
+            })),
+            timezone: Type.Optional(Type.String({
+                minLength: 1,
+                maxLength: 128,
+                description: 'IANA timezone used for timezone-less temporal input. Default "UTC". Invalid zones fail with an actionable diagnostic.',
+            })),
+            disambiguation: Type.Optional(Type.Union([
+                Type.Literal("compatible"),
+                Type.Literal("earlier"),
+                Type.Literal("later"),
+                Type.Literal("reject"),
+            ], {
+                description: 'DST gap/fold policy for IANA local times. Default "reject"; choose "earlier", "later", or Temporal-compatible behavior explicitly.',
+            })),
+            dateBreaks: Type.Optional(TemporalIntervalSpecSchema),
+            dateMinorBreaks: Type.Optional(TemporalIntervalSpecSchema),
+            dateLabels: Type.Optional(TemporalLabelSpecSchema),
+            locale: Type.Optional(Type.String({
+                minLength: 1,
+                maxLength: 128,
+                description: 'BCP 47 locale for temporal labels. Default "en-US". JSON Schema bounds the portable string shape; runtime validation canonicalizes the tag and verifies Intl support before rendering.',
+            })),
+            weekStart: Type.Optional(TemporalWeekStartSchema),
+            domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), {
+                minItems: 1,
+                description: "Explicit domain, PINNING the scale: [min, max] for continuous scales (numbers, or temporal strings for time); the full category list for band scales. Data outside the domain is dropped with a warning.",
+            })),
+            nice: Type.Optional(Type.Boolean({
+                description: "Round the inferred domain to tick-friendly bounds. Default true. Ignored when `domain` is set.",
+            })),
+            zero: Type.Optional(Type.Boolean({
+                description: "Force the domain to include zero. Bars, columns, and areas force this to true on the measure axis; set false explicitly to override. Ignored when `domain` is set.",
+            })),
+            reverse: Type.Optional(Type.Boolean({ description: "Reverse the scale's output direction. Default false." })),
+            breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), {
+                minItems: 1,
+                description: "Explicit tick positions in data units (numbers, or ISO date strings for time scales); for binned scales these are the bin boundaries. Omit for automatic ticks. Binned scales allow at most 65 boundaries (64 bins); non-binned explicit ticks are not capped.",
+            })),
+            labels: Type.Optional(Type.String({
+                description: 'Tick label format string. Time scales: strftime-style ("%Y-%m", "%b %d", "%H:%M"). Numeric scales: ",d" (grouped integer), ".1f" (fixed decimals), ".0%" (percent), "~s" (SI prefix). Omit for automatic formatting.',
+            })),
+            expand: Type.Optional(Type.Ref("ScaleExpansion", {
+                description: "Display-domain padding. Non-temporal continuous/binned axes default to { mult: 0.05, add: 0 }; time axes default to zero. Pinned domains still receive display expansion.",
+            })),
+            oob: Type.Optional(Type.Union([Type.Literal("censor"), Type.Literal("squish")], {
+                description: 'Out-of-bounds policy for values outside explicit source limits, applied before stats. "censor" (default) drops them to missing; "squish" clamps them to the nearest source limit before transform.',
+            })),
+            naValue: Type.Optional(Type.Union([Type.Number(), Type.Null()], {
+                description: "Replacement for missing/censored positional values, resolved after OOB and before transform. A finite number substitutes; null (default) keeps them missing. The replacement is itself checked against the transform/domain rules.",
+            })),
+            minorBreaks: Type.Optional(Type.Array(Type.Number(), {
+                minItems: 1,
+                description: "Explicit minor gridline positions in semantic source units. Coincident major/minor values render only the major tick. Time scales use dateMinorBreaks instead.",
+            })),
+            guide: Type.Optional(Type.Union([Type.Ref("GuideSpec"), Type.Ref("BandAxisGuideSpec")])),
+        }, {
+            additionalProperties: false,
+            description: "Configuration for a positional (x or y) scale.",
+        }),
+        Type.Union([
+            Type.Object({
+                type: Type.Literal("binned"),
+                breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), {
+                    maxItems: MAX_BINNED_BREAKS + 1,
+                })),
+            }),
+            Type.Object({
+                type: Type.Optional(Type.Union([
+                    Type.Literal("linear"),
+                    Type.Literal("log"),
+                    Type.Literal("time"),
+                    Type.Literal("band"),
+                ])),
+            }),
+        ]),
+    ]),
+    ColorScaleSpec: Type.Intersect([
+        Type.Object({
+            type: Type.Optional(Type.Union([
+                Type.Literal("ordinal"),
+                Type.Literal("sequential"),
+                Type.Literal("binned"),
+                Type.Literal("manual"),
+                Type.Literal("identity"),
+            ], {
+                description: 'Color scale family: "ordinal" for categories, "sequential" for a continuous ramp, "binned" for color steps, "manual" for an explicit domain/range mapping, or "identity" for validated source colors.',
+            })),
+            transform: Type.Optional(Type.Union([Type.Literal("identity"), Type.Literal("log10"), Type.Literal("sqrt")], {
+                description: "Pre-training quantitative transform for sequential/binned color values. log10/sqrt require non-temporal values; ordinal, manual, and identity families do not accept a transform.",
+            })),
+            temporalKind: Type.Optional(Type.Union([Type.Literal("date"), Type.Literal("datetime")], {
+                description: 'Temporal precision intent for sequential/binned colors. "date" uses calendar labels; "datetime" uses instant labels.',
+            })),
+            parse: Type.Optional(Type.Ref("TemporalParserSpec", {
+                description: "Explicit deterministic parser for temporal color/fill source values. Omit for value-driven inference.",
+            })),
+            parseFailure: Type.Optional(Type.Union([Type.Literal("error"), Type.Literal("censor")], {
+                description: 'Explicit temporal parser failure policy: "error" (default) or "censor" with a bounded warning.',
+            })),
+            timezone: Type.Optional(Type.String({
+                minLength: 1,
+                maxLength: 128,
+                description: 'IANA timezone for temporal color/fill input. Default "UTC".',
+            })),
+            disambiguation: Type.Optional(Type.Union([
+                Type.Literal("compatible"),
+                Type.Literal("earlier"),
+                Type.Literal("later"),
+                Type.Literal("reject"),
+            ])),
+            domain: Type.Optional(Type.Array(Type.Ref("DomainValue"), {
+                minItems: 1,
+                description: "Explicit semantic domain. Manual/ordinal scales use ordered values; sequential/binned scales use [min, max].",
+            })),
+            domainMode: Type.Optional(Type.Union([Type.Literal("grow"), Type.Literal("data")], {
+                description: 'Ordinal domain stability: "grow" (default) preserves assignments across filters; "data" rebuilds from current data.',
+            })),
+            breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), {
+                minItems: 2,
+                description: "Explicit semantic reference ticks for sequential colorbars or ordered boundaries for binned colorsteps.",
+            })),
+            range: Type.Optional(Type.Array(Type.String({ pattern: "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$" }), {
+                minItems: 1,
+                description: "Explicit #rgb/#rrggbb colors. Manual pairs them with domain values; sequential/binned interpolate or sample them.",
+            })),
+            scheme: Type.Optional(Type.Union(COLOR_SCHEME_NAME_SCHEMAS, {
+                description: 'Named color scheme: categorical "observable10" (default), "ipsum", "flexoki", "colorblind", "hue", and ColorBrewer qualitative (Dark2); or sequential family "viridis" (default), "magma", "plasma", "inferno", "cividis", "turbo", plus ColorBrewer sequential/diverging (Blues, RdYlBu, …). Sequential-family names may also be used with ordinal scales (discrete sampling). When type is omitted, the named scheme selects its ordinal or sequential scale family.',
+            })),
+            reverse: Type.Optional(Type.Boolean({ description: "Reverse the output color range. Default false." })),
+            oob: Type.Optional(Type.Union([Type.Literal("censor"), Type.Literal("squish"), Type.Literal("wrap")], {
+                description: 'Out-of-bounds policy for an explicit continuous domain: "censor" (default), "squish", or "wrap" (periodic; required for cyclic *O schemes). Not valid on binned color scales.',
+            })),
+            naValue: Type.Optional(Type.String({
+                pattern: "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+                description: "Color for null/missing values. Default9.",
+            })),
+            unknownValue: Type.Optional(Type.String({
+                pattern: "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+                description: "Color for invalid, out-of-domain, or unmapped values. Default9.",
+            })),
+            onExhaust: Type.Optional(Type.Union([Type.Literal("cycle"), Type.Literal("error")], {
+                description: 'Ordinal palette exhaustion policy: "cycle" (default) with a warning, or "error".',
+            })),
+            labels: Type.Optional(Type.String({
+                description: 'Guide label format: numeric (".1f", ",d", ".0%") or temporal strftime-style text.',
+            })),
+            guide: Type.Optional(Type.Ref("GuideSpec")),
+        }, {
+            additionalProperties: false,
+            description: "Configuration for a color or fill scale.",
+        }),
+        Type.Union([
+            Type.Object({
+                type: Type.Literal("binned"),
+                breaks: Type.Optional(Type.Array(Type.Union([Type.Number(), Type.String()]), {
+                    minItems: 2,
+                    maxItems: MAX_BINNED_BREAKS + 1,
+                })),
+                domainMode: forbiddenColorOption(),
+                onExhaust: forbiddenColorOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("manual"),
+                range: Type.Array(Type.String({ pattern: "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$" }), {
+                    minItems: 1,
+                }),
+                transform: forbiddenColorOption(),
+                temporalKind: forbiddenColorOption(),
+                parse: forbiddenColorOption(),
+                parseFailure: forbiddenColorOption(),
+                timezone: forbiddenColorOption(),
+                disambiguation: forbiddenColorOption(),
+                domainMode: forbiddenColorOption(),
+                breaks: forbiddenColorOption(),
+                scheme: forbiddenColorOption(),
+                reverse: forbiddenColorOption(),
+                oob: forbiddenColorOption(),
+                onExhaust: forbiddenColorOption(),
+                labels: forbiddenColorOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("identity"),
+                transform: forbiddenColorOption(),
+                temporalKind: forbiddenColorOption(),
+                parse: forbiddenColorOption(),
+                parseFailure: forbiddenColorOption(),
+                timezone: forbiddenColorOption(),
+                disambiguation: forbiddenColorOption(),
+                domain: forbiddenColorOption(),
+                domainMode: forbiddenColorOption(),
+                breaks: forbiddenColorOption(),
+                range: forbiddenColorOption(),
+                scheme: forbiddenColorOption(),
+                reverse: forbiddenColorOption(),
+                oob: forbiddenColorOption(),
+                onExhaust: forbiddenColorOption(),
+                labels: forbiddenColorOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("ordinal"),
+                transform: forbiddenColorOption(),
+                temporalKind: forbiddenColorOption(),
+                parse: forbiddenColorOption(),
+                parseFailure: forbiddenColorOption(),
+                timezone: forbiddenColorOption(),
+                disambiguation: forbiddenColorOption(),
+                breaks: forbiddenColorOption(),
+                oob: forbiddenColorOption(),
+                labels: forbiddenColorOption(),
+            }),
+            Type.Object({
+                type: Type.Literal("sequential"),
+                domainMode: forbiddenColorOption(),
+                onExhaust: forbiddenColorOption(),
+            }),
+            Type.Object({ type: forbiddenColorOption() }),
+        ]),
+    ]),
+};
+//# sourceMappingURL=schema-decls-scales.js.map