@deck.gl-community/graph-layers 9.1.1 → 9.2.0-beta.3

package/dist/style/graph-style-engine.js

@@ -0,0 +1,164 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable no-continue */
+import { ZodError } from 'zod';
+import { StylesheetEngine } from './stylesheet-engine';
+import { GraphStylesheetSchema } from './graph-stylesheet.schema';
+import { GRAPH_DECKGL_ACCESSOR_MAP } from './graph-style-accessor-map';
+import { warn } from '../utils/log';
+const GRAPH_DECKGL_UPDATE_TRIGGERS = {
+    circle: ['getFillColor', 'getRadius', 'getLineColor', 'getLineWidth'],
+    rectangle: ['getFillColor', 'getLineColor', 'getLineWidth'],
+    'rounded-rectangle': ['getFillColor', 'getLineColor', 'getLineWidth', 'getCornerRadius'],
+    'path-rounded-rectangle': ['getFillColor', 'getLineColor', 'getLineWidth', 'getCornerRadius'],
+    label: ['getColor', 'getText', 'getSize', 'getTextAnchor', 'getAlignmentBaseline', 'getAngle'],
+    marker: ['getColor', 'getSize', 'getMarker'],
+    Edge: ['getColor', 'getWidth'],
+    edge: ['getColor', 'getWidth'],
+    'edge-label': ['getColor', 'getText', 'getSize', 'getTextAnchor', 'getAlignmentBaseline'],
+    flow: ['getColor', 'getWidth', 'getSpeed', 'getTailLength'],
+    arrow: ['getColor', 'getSize', 'getOffset']
+};
+function formatStylesheetError(error) {
+    const details = error.issues
+        .map((issue) => {
+        const path = issue.path.length ? issue.path.join('.') : 'root';
+        return `  • ${path}: ${issue.message}`;
+    })
+        .join('\n');
+    return `Invalid graph stylesheet:\n${details}`;
+}
+export class GraphStylesheetEngine extends StylesheetEngine {
+    constructor(style, { stateUpdateTrigger } = {}) {
+        const result = GraphStylesheetSchema.safeParse(style);
+        const parsedStyle = result.success
+            ? result.data
+            : sanitizeStylesheet(style, result.error.issues);
+        super(parsedStyle, {
+            deckglAccessorMap: GRAPH_DECKGL_ACCESSOR_MAP,
+            deckglUpdateTriggers: GRAPH_DECKGL_UPDATE_TRIGGERS,
+            stateUpdateTrigger
+        });
+    }
+}
+export const GraphStyleEngine = GraphStylesheetEngine;
+export { GraphStyleScaleTypeEnum, GraphStyleScaleSchema, GraphStyleAttributeReferenceSchema, GraphStyleLeafValueSchema, GraphStyleStateMapSchema, GraphStyleValueSchema, GraphStylesheetSchema } from './graph-stylesheet.schema';
+export { GRAPH_DECKGL_ACCESSOR_MAP } from './graph-style-accessor-map';
+// eslint-disable-next-line max-statements, complexity
+function sanitizeStylesheet(style, issues) {
+    if (issues.length) {
+        const details = issues
+            .map((issue) => {
+            const path = issue.path.length ? issue.path.join('.') : 'root';
+            return `${path}: ${issue.message}`;
+        })
+            .join('\n  • ');
+        warn(`GraphStyleEngine: stylesheet issues detected:\n  • ${details}`);
+    }
+    const fallbackTypeCandidate = typeof style.type === 'string' ? style.type : undefined;
+    const fallbackCandidates = Array.from(new Set([fallbackTypeCandidate, 'edge'].filter((value) => typeof value === 'string' && value.length > 0)));
+    for (const candidate of fallbackCandidates) {
+        const sanitized = cloneValue(style);
+        sanitized.type = candidate;
+        for (const issue of issues) {
+            if (!Array.isArray(issue.path) || issue.path.length === 0) {
+                continue;
+            }
+            const path = issue.path.filter((segment) => typeof segment === 'string' || typeof segment === 'number');
+            if (path.length === 0) {
+                continue;
+            }
+            const [rootKey] = path;
+            if (rootKey === undefined || rootKey === 'type') {
+                continue;
+            }
+            if (typeof rootKey === 'string' && rootKey.startsWith(':')) {
+                removeNestedProperty(sanitized, path);
+                continue;
+            }
+            if (typeof rootKey !== 'string') {
+                continue;
+            }
+            delete sanitized[rootKey];
+        }
+        const result = GraphStylesheetSchema.safeParse(sanitized);
+        if (result.success) {
+            return result.data;
+        }
+    }
+    // If every fallback failed, rethrow the detailed error so callers know parsing was impossible.
+    throw new Error(formatStylesheetError(new ZodError(issues)));
+}
+function cloneValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => cloneValue(item));
+    }
+    if (value && typeof value === 'object') {
+        if (value instanceof Date) {
+            return new Date(value);
+        }
+        if (value instanceof RegExp) {
+            return new RegExp(value.source, value.flags);
+        }
+        const cloned = {};
+        for (const [key, entryValue] of Object.entries(value)) {
+            cloned[key] = cloneValue(entryValue);
+        }
+        return cloned;
+    }
+    return value;
+}
+// eslint-disable-next-line max-statements, complexity
+function removeNestedProperty(target, path) {
+    if (path.length === 0) {
+        return;
+    }
+    const [head, ...rest] = path;
+    if (head === undefined) {
+        return;
+    }
+    if (Array.isArray(target)) {
+        const index = typeof head === 'number' ? head : Number(head);
+        if (!Number.isInteger(index) || index < 0 || index >= target.length) {
+            return;
+        }
+        if (rest.length === 0) {
+            target.splice(index, 1);
+            return;
+        }
+        const child = target[index];
+        if (!child || typeof child !== 'object') {
+            target.splice(index, 1);
+            return;
+        }
+        removeNestedProperty(child, rest);
+        if (isEmptyObject(child)) {
+            target.splice(index, 1);
+        }
+        return;
+    }
+    const recordTarget = target;
+    if (rest.length === 0) {
+        delete recordTarget[head];
+        return;
+    }
+    const child = recordTarget[head];
+    if (!child || typeof child !== 'object') {
+        delete recordTarget[head];
+        return;
+    }
+    removeNestedProperty(child, rest);
+    if (isEmptyObject(child)) {
+        delete recordTarget[head];
+    }
+}
+function isEmptyObject(value) {
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    return Object.keys(value).length === 0;
+}

package/dist/style/graph-style-engine.js.map

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

package/dist/style/graph-stylesheet.schema.d.ts

@@ -0,0 +1,310 @@
+import { z } from 'zod';
+/**
+ * Supported scale identifiers for mapping data values to visual encodings.
+ */
+export declare const GraphStyleScaleTypeEnum: z.ZodEnum<{
+    linear: "linear";
+    log: "log";
+    pow: "pow";
+    sqrt: "sqrt";
+    quantize: "quantize";
+    quantile: "quantile";
+    ordinal: "ordinal";
+}>;
+/**
+ * TypeScript union of {@link GraphStyleScaleTypeEnum} values.
+ */
+export type GraphStyleScaleType = z.infer<typeof GraphStyleScaleTypeEnum>;
+/**
+ * Configuration for data-driven style scaling. Supports deck.gl compatible numeric and
+ * categorical scaling with optional d3-scale like parameters.
+ */
+export declare const GraphStyleScaleSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        linear: "linear";
+        log: "log";
+        pow: "pow";
+        sqrt: "sqrt";
+        quantize: "quantize";
+        quantile: "quantile";
+        ordinal: "ordinal";
+    }>>;
+    domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    clamp: z.ZodOptional<z.ZodBoolean>;
+    nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+    base: z.ZodOptional<z.ZodNumber>;
+    exponent: z.ZodOptional<z.ZodNumber>;
+    unknown: z.ZodOptional<z.ZodAny>;
+}, z.core.$strict>;
+/**
+ * TypeScript view of {@link GraphStyleScaleSchema} after parsing.
+ */
+export type GraphStyleScale = z.infer<typeof GraphStyleScaleSchema>;
+/**
+ * Reference to node/edge attributes, optionally including fallback values and scale
+ * configuration for data-driven styling.
+ */
+export declare const GraphStyleAttributeReferenceSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    attribute: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    scale: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            log: "log";
+            pow: "pow";
+            sqrt: "sqrt";
+            quantize: "quantize";
+            quantile: "quantile";
+            ordinal: "ordinal";
+        }>>;
+        domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        clamp: z.ZodOptional<z.ZodBoolean>;
+        nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+        base: z.ZodOptional<z.ZodNumber>;
+        exponent: z.ZodOptional<z.ZodNumber>;
+        unknown: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+}, z.core.$strict>]>;
+/**
+ * Parsed value produced by {@link GraphStyleAttributeReferenceSchema}.
+ */
+export type GraphStyleAttributeReference = z.infer<typeof GraphStyleAttributeReferenceSchema>;
+/**
+ * Primitive value allowed in stylesheet definitions. Supports literal values, attribute
+ * references and imperative resolver functions.
+ */
+export declare const GraphStyleLeafValueSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    attribute: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    scale: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            log: "log";
+            pow: "pow";
+            sqrt: "sqrt";
+            quantize: "quantize";
+            quantile: "quantile";
+            ordinal: "ordinal";
+        }>>;
+        domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        clamp: z.ZodOptional<z.ZodBoolean>;
+        nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+        base: z.ZodOptional<z.ZodNumber>;
+        exponent: z.ZodOptional<z.ZodNumber>;
+        unknown: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+}, z.core.$strict>]>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>;
+/**
+ * Union of literal, attribute-driven and functional style values.
+ */
+export type GraphStyleLeafValue = z.infer<typeof GraphStyleLeafValueSchema>;
+/**
+ * Mapping of interaction or application state keys to leaf style values.
+ */
+export declare const GraphStyleStateMapSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    attribute: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    scale: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            log: "log";
+            pow: "pow";
+            sqrt: "sqrt";
+            quantize: "quantize";
+            quantile: "quantile";
+            ordinal: "ordinal";
+        }>>;
+        domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        clamp: z.ZodOptional<z.ZodBoolean>;
+        nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+        base: z.ZodOptional<z.ZodNumber>;
+        exponent: z.ZodOptional<z.ZodNumber>;
+        unknown: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+}, z.core.$strict>]>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+/**
+ * Style value that may be either a simple leaf value or a keyed map of overrides.
+ */
+export declare const GraphStyleValueSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    attribute: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    scale: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            log: "log";
+            pow: "pow";
+            sqrt: "sqrt";
+            quantize: "quantize";
+            quantile: "quantile";
+            ordinal: "ordinal";
+        }>>;
+        domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        clamp: z.ZodOptional<z.ZodBoolean>;
+        nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+        base: z.ZodOptional<z.ZodNumber>;
+        exponent: z.ZodOptional<z.ZodNumber>;
+        unknown: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+}, z.core.$strict>]>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    attribute: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    scale: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            log: "log";
+            pow: "pow";
+            sqrt: "sqrt";
+            quantize: "quantize";
+            quantile: "quantile";
+            ordinal: "ordinal";
+        }>>;
+        domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        range: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        clamp: z.ZodOptional<z.ZodBoolean>;
+        nice: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber]>>;
+        base: z.ZodOptional<z.ZodNumber>;
+        exponent: z.ZodOptional<z.ZodNumber>;
+        unknown: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>;
+}, z.core.$strict>]>, z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>]>>]>;
+/**
+ * Parsed style property value that may include state overrides.
+ */
+export type GraphStyleValue = z.infer<typeof GraphStyleValueSchema>;
+/**
+ * Translation table between graph style properties and the underlying deck.gl accessors for
+ * each supported style primitive type.
+ */
+export declare const GRAPH_DECKGL_ACCESSOR_MAP: {
+    readonly circle: {
+        readonly getFillColor: "fill";
+        readonly getLineColor: "stroke";
+        readonly getLineWidth: "strokeWidth";
+        readonly getRadius: "radius";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly rectangle: {
+        readonly getWidth: "width";
+        readonly getHeight: "height";
+        readonly getFillColor: "fill";
+        readonly getLineColor: "stroke";
+        readonly getLineWidth: "strokeWidth";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly 'rounded-rectangle': {
+        readonly getCornerRadius: "cornerRadius";
+        readonly getRadius: "radius";
+        readonly getWidth: "width";
+        readonly getHeight: "height";
+        readonly getFillColor: "fill";
+        readonly getLineColor: "stroke";
+        readonly getLineWidth: "strokeWidth";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly 'path-rounded-rectangle': {
+        readonly getWidth: "width";
+        readonly getHeight: "height";
+        readonly getFillColor: "fill";
+        readonly getLineColor: "stroke";
+        readonly getLineWidth: "strokeWidth";
+        readonly getCornerRadius: "cornerRadius";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly label: {
+        readonly getColor: "color";
+        readonly getText: "text";
+        readonly getSize: "fontSize";
+        readonly getTextAnchor: "textAnchor";
+        readonly getAlignmentBaseline: "alignmentBaseline";
+        readonly getAngle: "angle";
+        readonly scaleWithZoom: "scaleWithZoom";
+        readonly textMaxWidth: "textMaxWidth";
+        readonly textWordBreak: "textWordBreak";
+        readonly textSizeMinPixels: "textSizeMinPixels";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly marker: {
+        readonly getColor: "fill";
+        readonly getSize: "size";
+        readonly getMarker: "marker";
+        readonly scaleWithZoom: "scaleWithZoom";
+        readonly getOffset: "offset";
+        readonly opacity: "opacity";
+    };
+    readonly Edge: {
+        readonly getColor: "stroke";
+        readonly getWidth: "strokeWidth";
+    };
+    readonly edge: {
+        readonly getColor: "stroke";
+        readonly getWidth: "strokeWidth";
+    };
+    readonly 'edge-label': {
+        readonly getColor: "color";
+        readonly getText: "text";
+        readonly getSize: "fontSize";
+        readonly getTextAnchor: "textAnchor";
+        readonly getAlignmentBaseline: "alignmentBaseline";
+        readonly scaleWithZoom: "scaleWithZoom";
+        readonly textMaxWidth: "textMaxWidth";
+        readonly textWordBreak: "textWordBreak";
+        readonly textSizeMinPixels: "textSizeMinPixels";
+    };
+    readonly flow: {
+        readonly getColor: "color";
+        readonly getWidth: "width";
+        readonly getSpeed: "speed";
+        readonly getTailLength: "tailLength";
+    };
+    readonly arrow: {
+        readonly getColor: "color";
+        readonly getSize: "size";
+        readonly getOffset: "offset";
+    };
+};
+/**
+ * Supported graph style primitive identifiers (e.g. `circle`, `edge`).
+ */
+export type GraphStyleType = keyof typeof GRAPH_DECKGL_ACCESSOR_MAP;
+/**
+ * CSS-like pseudo selector supported by the stylesheet for state overrides.
+ */
+export type GraphStyleSelector = `:${string}`;
+type GraphStylePropertyKey<TType extends GraphStyleType> = Extract<(typeof GRAPH_DECKGL_ACCESSOR_MAP)[TType][keyof (typeof GRAPH_DECKGL_ACCESSOR_MAP)[TType]], PropertyKey>;
+type GraphStyleStatefulValue<TValue> = TValue | {
+    [state: string]: TValue;
+};
+type GraphStylePropertyMap<TType extends GraphStyleType, TValue> = Partial<Record<GraphStylePropertyKey<TType>, GraphStyleStatefulValue<TValue>>>;
+/**
+ * Typed representation of a stylesheet definition for a specific graph primitive.
+ */
+export type GraphStylesheet<TType extends GraphStyleType = GraphStyleType, TValue = GraphStyleLeafValue> = {
+    type: TType;
+} & GraphStylePropertyMap<TType, TValue> & Partial<Record<GraphStyleSelector, GraphStylePropertyMap<TType, TValue>>>;
+/**
+ * Schema that validates stylesheet definitions for all graph style primitives.
+ */
+export declare const GraphStylesheetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, ...z.ZodObject<{
+    [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>[]], "type">;
+/**
+ * Runtime type accepted by {@link GraphStylesheetSchema} before validation.
+ */
+export type GraphStylesheetInput = z.input<typeof GraphStylesheetSchema>;
+/**
+ * Type returned by {@link GraphStylesheetSchema} after successful parsing.
+ */
+export type GraphStylesheetParsed = z.infer<typeof GraphStylesheetSchema>;
+export {};

package/dist/style/graph-stylesheet.schema.d.ts.map

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