@powerduck/schema-designer 0.1.0

package/dist/types-D2jEaM9Z.d.cts

@@ -0,0 +1,145 @@
+/** JSON Schema accepts both schema objects and unconditional boolean schemas. */
+interface SchemaObject {
+    [keyword: string]: unknown;
+}
+type SchemaValue = SchemaObject | boolean;
+type SchemaPatch = Partial<SchemaObject>;
+
+type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
+declare const SCHEMA_TYPES: JSONSchemaType[];
+/**
+ * Loose JSON Schema shape. Unknown keywords are preserved untouched,
+ * the editor never strips fields it does not understand.
+ */
+interface JSONSchema {
+    $ref?: string;
+    $id?: string;
+    $schema?: string;
+    $defs?: Record<string, JSONSchema | boolean>;
+    definitions?: Record<string, JSONSchema | boolean>;
+    components?: {
+        schemas?: Record<string, JSONSchema | boolean>;
+    };
+    type?: JSONSchemaType | JSONSchemaType[];
+    title?: string;
+    description?: string;
+    default?: unknown;
+    examples?: unknown[];
+    enum?: unknown[];
+    const?: unknown;
+    format?: string;
+    properties?: Record<string, JSONSchema | boolean>;
+    patternProperties?: Record<string, JSONSchema | boolean>;
+    additionalProperties?: boolean | JSONSchema;
+    required?: string[];
+    items?: JSONSchema | boolean;
+    prefixItems?: (JSONSchema | boolean)[];
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    allOf?: (JSONSchema | boolean)[];
+    anyOf?: (JSONSchema | boolean)[];
+    oneOf?: (JSONSchema | boolean)[];
+    not?: JSONSchema | boolean;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    [keyword: string]: unknown;
+}
+/** Where a row lives relative to its parent container. */
+type NodeKind = "property" | "items" | "root";
+/** Visual role of a row inside a resolved $ref block. */
+type RefSegment = "none" | "head" | "body" | "tail" | "single";
+/** One rendered line of the flattened tree. */
+interface FlatNode {
+    /** Stable identity, built from the schema path. */
+    id: string;
+    /** Property key, or a synthetic label for array items. */
+    key: string;
+    /** Path from the root schema down to this node's own schema object. */
+    path: string[];
+    /** Path to the parent container that owns `key`. */
+    parentPath: string[];
+    depth: number;
+    kind: NodeKind;
+    /** The raw schema at `path`, possibly just a `$ref` stub. */
+    schema: JSONSchema;
+    value: SchemaValue;
+    /** The dereferenced schema used for rendering, identical to `schema` when no ref. */
+    resolved: JSONSchema;
+    resolvedValue: SchemaValue;
+    required: boolean;
+    expandable: boolean;
+    expanded: boolean;
+    /** Name of the referenced definition, when this node is a `$ref`. */
+    refName?: string;
+    /** True when the ref points at an ancestor and expansion was stopped. */
+    recursive: boolean;
+    /** Position inside the resolved ref block, drives the block border styling. */
+    refSegment: RefSegment;
+    /** Rows inside a ref subtree are read-only to protect shared components. */
+    readOnly: boolean;
+    /** Sortable only among siblings of the same `properties` object. */
+    sortable: boolean;
+}
+/** Insert position requested from the row menu. */
+type AddFieldMode = "sibling" | "child";
+type SchemaEditorErrorScope = "clone" | "resolveRef" | "flatten" | "reorder" | "commit" | "render";
+interface SchemaEditorError {
+    scope: SchemaEditorErrorScope;
+    message: string;
+    /** Original thrown value, kept as-is for logging. */
+    cause?: unknown;
+    /** Schema path where it happened, when known. */
+    path?: string[];
+}
+type SchemaErrorHandler = (error: SchemaEditorError) => void;
+interface AdvancedEditorContext {
+    required?: boolean;
+    onRequiredChange?: (required: boolean) => void;
+    nested: boolean;
+    schema: SchemaValue;
+    schemaName: string;
+    fullSchema: JSONSchema;
+    path: string[];
+    readOnly: boolean;
+    update: (next: SchemaValue) => void;
+}
+interface SchemaTreeEditorProps {
+    /** Controlled schema. Must be treated as immutable by the host. */
+    schema: JSONSchema;
+    onChange: (next: JSONSchema) => void;
+    /** Optional list columns. Hidden attributes remain editable in settings. */
+    showType?: boolean;
+    showRequired?: boolean;
+    showDescription?: boolean;
+    document?: JSONSchema;
+    className?: string;
+    /** Disables every mutating affordance. */
+    readOnly?: boolean;
+    /** Keys expanded on first mount. Uncontrolled afterwards. */
+    defaultExpanded?: string[];
+    /** Max rows rendered before the overflow notice appears. */
+    maxRows?: number;
+    /** Renders the advanced settings popover body for a row. */
+    renderAdvanced?: (context: AdvancedEditorContext) => React.ReactNode;
+    /** Called on any recovered internal failure. The component stays alive. */
+    onError?: SchemaErrorHandler;
+    /** Verify incoming schema identity and shape on every prop change. Default true. */
+    strictExternalSchema?: boolean;
+}
+type SchemaDesignerTreeProps = Omit<SchemaTreeEditorProps, "schema" | "onChange"> & {
+    schema?: SchemaValue;
+    value?: SchemaValue;
+    onChange: (schema: SchemaValue) => void;
+};
+
+export { type AddFieldMode as A, type FlatNode as F, type JSONSchema as J, type NodeKind as N, type RefSegment as R, SCHEMA_TYPES as S, type AdvancedEditorContext as a, type JSONSchemaType as b, type SchemaDesignerTreeProps as c, type SchemaEditorError as d, type SchemaEditorErrorScope as e, type SchemaErrorHandler as f, type SchemaObject as g, type SchemaPatch as h, type SchemaValue as i };

package/dist/types-D2jEaM9Z.d.ts

@@ -0,0 +1,145 @@
+/** JSON Schema accepts both schema objects and unconditional boolean schemas. */
+interface SchemaObject {
+    [keyword: string]: unknown;
+}
+type SchemaValue = SchemaObject | boolean;
+type SchemaPatch = Partial<SchemaObject>;
+
+type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
+declare const SCHEMA_TYPES: JSONSchemaType[];
+/**
+ * Loose JSON Schema shape. Unknown keywords are preserved untouched,
+ * the editor never strips fields it does not understand.
+ */
+interface JSONSchema {
+    $ref?: string;
+    $id?: string;
+    $schema?: string;
+    $defs?: Record<string, JSONSchema | boolean>;
+    definitions?: Record<string, JSONSchema | boolean>;
+    components?: {
+        schemas?: Record<string, JSONSchema | boolean>;
+    };
+    type?: JSONSchemaType | JSONSchemaType[];
+    title?: string;
+    description?: string;
+    default?: unknown;
+    examples?: unknown[];
+    enum?: unknown[];
+    const?: unknown;
+    format?: string;
+    properties?: Record<string, JSONSchema | boolean>;
+    patternProperties?: Record<string, JSONSchema | boolean>;
+    additionalProperties?: boolean | JSONSchema;
+    required?: string[];
+    items?: JSONSchema | boolean;
+    prefixItems?: (JSONSchema | boolean)[];
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    allOf?: (JSONSchema | boolean)[];
+    anyOf?: (JSONSchema | boolean)[];
+    oneOf?: (JSONSchema | boolean)[];
+    not?: JSONSchema | boolean;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    [keyword: string]: unknown;
+}
+/** Where a row lives relative to its parent container. */
+type NodeKind = "property" | "items" | "root";
+/** Visual role of a row inside a resolved $ref block. */
+type RefSegment = "none" | "head" | "body" | "tail" | "single";
+/** One rendered line of the flattened tree. */
+interface FlatNode {
+    /** Stable identity, built from the schema path. */
+    id: string;
+    /** Property key, or a synthetic label for array items. */
+    key: string;
+    /** Path from the root schema down to this node's own schema object. */
+    path: string[];
+    /** Path to the parent container that owns `key`. */
+    parentPath: string[];
+    depth: number;
+    kind: NodeKind;
+    /** The raw schema at `path`, possibly just a `$ref` stub. */
+    schema: JSONSchema;
+    value: SchemaValue;
+    /** The dereferenced schema used for rendering, identical to `schema` when no ref. */
+    resolved: JSONSchema;
+    resolvedValue: SchemaValue;
+    required: boolean;
+    expandable: boolean;
+    expanded: boolean;
+    /** Name of the referenced definition, when this node is a `$ref`. */
+    refName?: string;
+    /** True when the ref points at an ancestor and expansion was stopped. */
+    recursive: boolean;
+    /** Position inside the resolved ref block, drives the block border styling. */
+    refSegment: RefSegment;
+    /** Rows inside a ref subtree are read-only to protect shared components. */
+    readOnly: boolean;
+    /** Sortable only among siblings of the same `properties` object. */
+    sortable: boolean;
+}
+/** Insert position requested from the row menu. */
+type AddFieldMode = "sibling" | "child";
+type SchemaEditorErrorScope = "clone" | "resolveRef" | "flatten" | "reorder" | "commit" | "render";
+interface SchemaEditorError {
+    scope: SchemaEditorErrorScope;
+    message: string;
+    /** Original thrown value, kept as-is for logging. */
+    cause?: unknown;
+    /** Schema path where it happened, when known. */
+    path?: string[];
+}
+type SchemaErrorHandler = (error: SchemaEditorError) => void;
+interface AdvancedEditorContext {
+    required?: boolean;
+    onRequiredChange?: (required: boolean) => void;
+    nested: boolean;
+    schema: SchemaValue;
+    schemaName: string;
+    fullSchema: JSONSchema;
+    path: string[];
+    readOnly: boolean;
+    update: (next: SchemaValue) => void;
+}
+interface SchemaTreeEditorProps {
+    /** Controlled schema. Must be treated as immutable by the host. */
+    schema: JSONSchema;
+    onChange: (next: JSONSchema) => void;
+    /** Optional list columns. Hidden attributes remain editable in settings. */
+    showType?: boolean;
+    showRequired?: boolean;
+    showDescription?: boolean;
+    document?: JSONSchema;
+    className?: string;
+    /** Disables every mutating affordance. */
+    readOnly?: boolean;
+    /** Keys expanded on first mount. Uncontrolled afterwards. */
+    defaultExpanded?: string[];
+    /** Max rows rendered before the overflow notice appears. */
+    maxRows?: number;
+    /** Renders the advanced settings popover body for a row. */
+    renderAdvanced?: (context: AdvancedEditorContext) => React.ReactNode;
+    /** Called on any recovered internal failure. The component stays alive. */
+    onError?: SchemaErrorHandler;
+    /** Verify incoming schema identity and shape on every prop change. Default true. */
+    strictExternalSchema?: boolean;
+}
+type SchemaDesignerTreeProps = Omit<SchemaTreeEditorProps, "schema" | "onChange"> & {
+    schema?: SchemaValue;
+    value?: SchemaValue;
+    onChange: (schema: SchemaValue) => void;
+};
+
+export { type AddFieldMode as A, type FlatNode as F, type JSONSchema as J, type NodeKind as N, type RefSegment as R, SCHEMA_TYPES as S, type AdvancedEditorContext as a, type JSONSchemaType as b, type SchemaDesignerTreeProps as c, type SchemaEditorError as d, type SchemaEditorErrorScope as e, type SchemaErrorHandler as f, type SchemaObject as g, type SchemaPatch as h, type SchemaValue as i };

package/dist/types-xAihO_KW.d.ts

@@ -0,0 +1,48 @@
+import { i as SchemaValue } from './types-D2jEaM9Z.js';
+
+type InlineSchemaType = "string" | "number" | "integer" | "boolean" | "array" | "object" | "null" | "any";
+type SchemaFormatOptions = readonly string[];
+type SchemaRecord = Record<string, unknown>;
+interface OpenApiSchema extends SchemaRecord {
+}
+type CompositionKey = "allOf" | "anyOf" | "oneOf";
+interface InlineSchemaEditorProps {
+    schema?: SchemaValue;
+    value?: SchemaValue;
+    onChange?: (value: SchemaValue) => void;
+    schemaType?: InlineSchemaType;
+    schemaName?: string;
+    fullSchema?: OpenApiSchema;
+    required?: boolean;
+    disabled?: boolean;
+    showAdvanced?: boolean;
+    showComposition?: boolean;
+    showLiveJson?: boolean;
+    formatOptions?: SchemaFormatOptions;
+    path?: string[];
+    nested?: boolean;
+    onTypeChange?: (type: InlineSchemaType) => void;
+    onRequiredChange?: (required: boolean) => void;
+    update?: (patch: Partial<OpenApiSchema>) => void;
+    onExampleChange?: (value: unknown) => void;
+    onDefaultChange?: (value: unknown) => void;
+    onNameChange?: (name: string) => void;
+}
+interface SchemaPropertyItem {
+    name: string;
+    schema: OpenApiSchema;
+    required: boolean;
+}
+interface SchemaBuilderNode {
+    id: string;
+    name?: string;
+    schema: OpenApiSchema;
+    required?: boolean;
+    depth: number;
+}
+interface SchemaEditorState {
+    schema: OpenApiSchema;
+    type: InlineSchemaType;
+}
+
+export type { CompositionKey as C, InlineSchemaEditorProps as I, OpenApiSchema as O, SchemaFormatOptions as S, InlineSchemaType as a, SchemaPropertyItem as b, SchemaBuilderNode as c, SchemaEditorState as d, SchemaRecord as e };

package/dist/variableTextEditor.types-ClzvARvK.d.cts

@@ -0,0 +1,49 @@
+interface EndpointVariable {
+    name: string;
+    value?: string;
+    description?: string;
+    type?: string;
+    color?: string;
+    backgroundColor?: string;
+}
+interface VariableTokenMatch {
+    token: string;
+    name: string;
+    from: number;
+    to: number;
+    variable?: EndpointVariable;
+}
+interface VariableTextPart {
+    key: string;
+    text: string;
+    token?: VariableTokenMatch;
+}
+interface VariableTokenPresentation {
+    className: string;
+    tokenColor?: string;
+    tokenBgColor?: string;
+}
+interface VariableTextEditorProps {
+    value: string;
+    variables?: readonly EndpointVariable[] | null;
+    disabled?: boolean;
+    readOnly?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    className?: string;
+    autoFocus?: boolean;
+    allowLineBreaks?: boolean;
+    submitOnEnter?: boolean;
+    minHeight?: number;
+    /** Expand over neighboring content while preserving the original row height. */
+    expansionMode?: "inline" | "overlay";
+    safePadding?: number;
+    maxFocusedHeight?: number;
+    maxLength?: number;
+    onChange?: (value: string) => void;
+    onSubmit?: (value: string) => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+}
+
+export type { EndpointVariable as E, VariableTextEditorProps as V, VariableTextPart as a, VariableTokenMatch as b, VariableTokenPresentation as c };

package/dist/variableTextEditor.types-ClzvARvK.d.ts

@@ -0,0 +1,49 @@
+interface EndpointVariable {
+    name: string;
+    value?: string;
+    description?: string;
+    type?: string;
+    color?: string;
+    backgroundColor?: string;
+}
+interface VariableTokenMatch {
+    token: string;
+    name: string;
+    from: number;
+    to: number;
+    variable?: EndpointVariable;
+}
+interface VariableTextPart {
+    key: string;
+    text: string;
+    token?: VariableTokenMatch;
+}
+interface VariableTokenPresentation {
+    className: string;
+    tokenColor?: string;
+    tokenBgColor?: string;
+}
+interface VariableTextEditorProps {
+    value: string;
+    variables?: readonly EndpointVariable[] | null;
+    disabled?: boolean;
+    readOnly?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    className?: string;
+    autoFocus?: boolean;
+    allowLineBreaks?: boolean;
+    submitOnEnter?: boolean;
+    minHeight?: number;
+    /** Expand over neighboring content while preserving the original row height. */
+    expansionMode?: "inline" | "overlay";
+    safePadding?: number;
+    maxFocusedHeight?: number;
+    maxLength?: number;
+    onChange?: (value: string) => void;
+    onSubmit?: (value: string) => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+}
+
+export type { EndpointVariable as E, VariableTextEditorProps as V, VariableTextPart as a, VariableTokenMatch as b, VariableTokenPresentation as c };

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@powerduck/schema-designer",
+  "version": "0.1.0",
+  "description": "Composable JSON Schema and OpenAPI parameter editors for React.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    },
+    "./react/tree": {
+      "types": "./dist/react/schemaTreeEditor/index.d.ts",
+      "import": "./dist/react/schemaTreeEditor/index.js",
+      "require": "./dist/react/schemaTreeEditor/index.cjs"
+    },
+    "./react/inline": {
+      "types": "./dist/react/inlineSchemaEditor/index.d.ts",
+      "import": "./dist/react/inlineSchemaEditor/index.js",
+      "require": "./dist/react/inlineSchemaEditor/index.cjs"
+    },
+    "./react/parameters": {
+      "types": "./dist/react/parametersTable/index.d.ts",
+      "import": "./dist/react/parametersTable/index.js",
+      "require": "./dist/react/parametersTable/index.cjs"
+    },
+    "./adapters/generator": {
+      "types": "./dist/react/parametersTable/libs/generateValue.d.ts",
+      "import": "./dist/react/parametersTable/libs/generateValue.js",
+      "require": "./dist/react/parametersTable/libs/generateValue.cjs"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./package.json": "./package.json",
+    "./compat/inline": {
+      "types": "./dist/compat/inline.d.ts",
+      "import": "./dist/compat/inline.js",
+      "require": "./dist/compat/inline.cjs"
+    },
+    "./compat/tree": {
+      "types": "./dist/compat/tree.d.ts",
+      "import": "./dist/compat/tree.js",
+      "require": "./dist/compat/tree.cjs"
+    },
+    "./compat/parameters": {
+      "types": "./dist/compat/parameters.d.ts",
+      "import": "./dist/compat/parameters.js",
+      "require": "./dist/compat/parameters.cjs"
+    },
+    "./react/variable-editor": {
+      "types": "./dist/react/variableTextEditor/index.d.ts",
+      "import": "./dist/react/variableTextEditor/index.js",
+      "require": "./dist/react/variableTextEditor/index.cjs"
+    },
+    "./compat/variable-editor": {
+      "types": "./dist/compat/variable-editor.d.ts",
+      "import": "./dist/compat/variable-editor.js",
+      "require": "./dist/compat/variable-editor.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "build": "tsup && node scripts/styles.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --pool=forks --maxWorkers=1 --minWorkers=1",
+    "benchmark": "node --import tsx scripts/benchmark.ts",
+    "dev": "vite examples --host 127.0.0.1 --port 4176",
+    "verify:package": "node scripts/verify-package.mjs"
+  },
+  "peerDependencies": {
+    "@chakra-ui/react": "^3.37.0",
+    "@emotion/react": "^11.14.0",
+    "react": ">=18.2.0 <20",
+    "react-dom": ">=18.2.0 <20"
+  },
+  "dependencies": {
+    "@codemirror/autocomplete": "^6.20.3",
+    "@codemirror/commands": "^6.11.0",
+    "@codemirror/language": "^6.12.4",
+    "@codemirror/state": "^6.7.1",
+    "@codemirror/view": "^6.43.9",
+    "@hello-pangea/dnd": "^18.0.1",
+    "nanoid": "^5.1.16",
+    "react-icons": "^5.7.0"
+  },
+  "optionalDependencies": {
+    "@faker-js/faker": "^10.6.0",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "json-schema-faker": "^0.6.3"
+  },
+  "devDependencies": {
+    "@chakra-ui/react": "^3.37.0",
+    "@emotion/react": "^11.14.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^24.1.0",
+    "prettier": "^3.9.7",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0",
+    "vitest": "^1.6.0"
+  },
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}