anyvali 0.3.1

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+export type SchemaKind = "any" | "unknown" | "never" | "null" | "bool" | "string" | "number" | "int" | "float32" | "float64" | "int8" | "int16" | "int32" | "int64" | "uint8" | "uint16" | "uint32" | "uint64" | "literal" | "enum" | "array" | "tuple" | "object" | "record" | "union" | "intersection" | "optional" | "nullable" | "ref";
+export interface MetadataOptions {
+    replace?: boolean;
+}
+export interface DescribeOptions {
+    title?: string;
+    deprecated?: boolean;
+    deprecatedMessage?: string;
+    notStable?: boolean;
+    since?: string;
+    sensitive?: boolean;
+    readonly?: boolean;
+    writeonly?: boolean;
+    examples?: unknown[];
+}
+export interface SchemaNodeBase {
+    kind: SchemaKind;
+    default?: unknown;
+    coerce?: CoercionConfig | string | string[];
+    metadata?: Record<string, unknown>;
+}
+export interface CoercionConfig {
+    from?: string;
+    trim?: boolean;
+    lower?: boolean;
+    upper?: boolean;
+}
+export interface StringSchemaNode extends SchemaNodeBase {
+    kind: "string";
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    startsWith?: string;
+    endsWith?: string;
+    includes?: string;
+    format?: StringFormat;
+}
+export type StringFormat = "email" | "url" | "uuid" | "ipv4" | "ipv6" | "date" | "date-time";
+export interface NumericSchemaNode extends SchemaNodeBase {
+    kind: "number" | "int" | "float32" | "float64" | "int8" | "int16" | "int32" | "int64" | "uint8" | "uint16" | "uint32" | "uint64";
+    min?: number;
+    max?: number;
+    exclusiveMin?: number;
+    exclusiveMax?: number;
+    multipleOf?: number;
+}
+export interface SimpleSchemaNode extends SchemaNodeBase {
+    kind: "any" | "unknown" | "never" | "null" | "bool";
+}
+export interface LiteralSchemaNode extends SchemaNodeBase {
+    kind: "literal";
+    value: string | number | boolean | null;
+}
+export interface EnumSchemaNode extends SchemaNodeBase {
+    kind: "enum";
+    values: (string | number)[];
+}
+export interface ArraySchemaNode extends SchemaNodeBase {
+    kind: "array";
+    items: SchemaNode;
+    minItems?: number;
+    maxItems?: number;
+}
+export interface TupleSchemaNode extends SchemaNodeBase {
+    kind: "tuple";
+    items: SchemaNode[];
+}
+export interface ObjectSchemaNode extends SchemaNodeBase {
+    kind: "object";
+    properties: Record<string, SchemaNode>;
+    required: string[];
+    unknownKeys?: UnknownKeyMode;
+}
+export interface RecordSchemaNode extends SchemaNodeBase {
+    kind: "record";
+    valueSchema: SchemaNode;
+}
+export interface UnionSchemaNode extends SchemaNodeBase {
+    kind: "union";
+    variants: SchemaNode[];
+}
+export interface IntersectionSchemaNode extends SchemaNodeBase {
+    kind: "intersection";
+    allOf: SchemaNode[];
+}
+export interface OptionalSchemaNode extends SchemaNodeBase {
+    kind: "optional";
+    inner: SchemaNode;
+}
+export interface NullableSchemaNode extends SchemaNodeBase {
+    kind: "nullable";
+    inner: SchemaNode;
+}
+export interface RefSchemaNode extends SchemaNodeBase {
+    kind: "ref";
+    ref: string;
+}
+export type SchemaNode = StringSchemaNode | NumericSchemaNode | SimpleSchemaNode | LiteralSchemaNode | EnumSchemaNode | ArraySchemaNode | TupleSchemaNode | ObjectSchemaNode | RecordSchemaNode | UnionSchemaNode | IntersectionSchemaNode | OptionalSchemaNode | NullableSchemaNode | RefSchemaNode;
+export type ParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: ValidationIssue[];
+};
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    path: (string | number)[];
+    expected?: string;
+    received?: string;
+    meta?: Record<string, unknown>;
+}
+export interface AnyValiDocument {
+    anyvaliVersion: string;
+    schemaVersion: string;
+    root: SchemaNode;
+    definitions: Record<string, SchemaNode>;
+    extensions: Record<string, Record<string, unknown>>;
+}
+export type ExportMode = "portable" | "extended";
+export type UnknownKeyMode = "reject" | "strip" | "allow";
+export interface ParseContext {
+    path: (string | number)[];
+    issues: ValidationIssue[];
+    definitions?: Record<string, SchemaNode>;
+    /** Tracks objects already being validated to detect circular references. */
+    seen?: WeakSet<object>;
+    /** Current recursion depth, used to bound unbounded recursion (DoS guard). */
+    depth?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ---- Schema Node (interchange JSON representation) ----
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0DAA0D"}

package/dist/util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Describe the type of a value for error messages, matching the corpus expectations.
+ * null -> "null", array -> "array", otherwise typeof.
+ */
+export declare function describeType(value: unknown): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAInD"}

package/dist/util.js

@@ -0,0 +1,12 @@
+/**
+ * Describe the type of a value for error messages, matching the corpus expectations.
+ * null -> "null", array -> "array", otherwise typeof.
+ */
+export function describeType(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "anyvali",
+  "version": "0.3.1",
+  "description": "Native validation with portable schema interchange",
+  "homepage": "https://anyvali.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BetterCorp/AnyVali",
+    "directory": "sdk/js"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./forms": {
+      "import": "./dist/forms/index.js",
+      "types": "./dist/forms/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "node -e \"require('fs').copyFileSync('../../README.md','README.md')\"",
+    "postpack": "node -e \"try{require('fs').unlinkSync('README.md')}catch{}\""
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.2",
+    "jsdom": "^29.1.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT"
+}

package/sdk/js/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [0.1.0](https://github.com/BetterCorp/AnyVali/compare/js-v0.0.1...js-v0.1.0) (2026-03-30)
+
+
+### Features
+
+* **js:** add forms bindings and DOM enhancement tests ([1cb7fa1](https://github.com/BetterCorp/AnyVali/commit/1cb7fa1493282c5db3207f1e552d86ac3c57b4b0))
+
+
+### Bug Fixes
+
+* update CI for Node 22/24 and fix CLI test runner ([43938a4](https://github.com/BetterCorp/AnyVali/commit/43938a4fb8f2e4867784b6729b71581e9e0dc8bf))

package/src/errors.ts

@@ -0,0 +1,17 @@
+import type { ValidationIssue } from "./types.js";
+
+export class ValidationError extends Error {
+  public readonly issues: ValidationIssue[];
+
+  constructor(issues: ValidationIssue[]) {
+    const message = issues
+      .map(
+        (i) =>
+          `[${i.code}] ${i.path.length > 0 ? i.path.join(".") + ": " : ""}${i.message}`
+      )
+      .join("\n");
+    super(message);
+    this.name = "ValidationError";
+    this.issues = issues;
+  }
+}

package/src/format/validators.ts

@@ -0,0 +1,71 @@
+import type { StringFormat } from "../types.js";
+
+// Email must have at least one dot after the @
+const EMAIL_RE =
+  /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$/;
+
+const UUID_RE =
+  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+
+const IPV4_RE =
+  /^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/;
+
+const IPV6_RE =
+  /^(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)$/;
+
+// ISO 8601 date: YYYY-MM-DD
+const DATE_RE = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/;
+
+// ISO 8601 date-time: YYYY-MM-DDTHH:MM:SS with optional fractional seconds and timezone
+const DATETIME_RE =
+  /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
+
+function isValidDate(str: string): boolean {
+  if (!DATE_RE.test(str)) return false;
+  const [y, m, d] = str.split("-").map(Number);
+  const date = new Date(y, m - 1, d);
+  // new Date() maps years 0-99 to 1900-1999; undo that so early ISO years
+  // (e.g. 0050-01-01) are not falsely rejected.
+  date.setFullYear(y);
+  return (
+    date.getFullYear() === y &&
+    date.getMonth() === m - 1 &&
+    date.getDate() === d
+  );
+}
+
+function isValidDateTime(str: string): boolean {
+  if (!DATETIME_RE.test(str)) return false;
+  // Validate the date portion
+  const datePart = str.substring(0, 10);
+  return isValidDate(datePart);
+}
+
+function isValidUrl(str: string): boolean {
+  try {
+    const url = new URL(str);
+    // Only accept http and https protocols
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+const FORMAT_VALIDATORS: Record<StringFormat, (val: string) => boolean> = {
+  email: (val) => EMAIL_RE.test(val),
+  url: isValidUrl,
+  uuid: (val) => UUID_RE.test(val),
+  ipv4: (val) => IPV4_RE.test(val),
+  ipv6: (val) => IPV6_RE.test(val),
+  date: isValidDate,
+  "date-time": isValidDateTime,
+};
+
+const FORMAT_NAME_RE = /^[A-Za-z][A-Za-z0-9-]*$/;
+
+export function validateFormat(value: string, format: string): boolean {
+  if (!FORMAT_NAME_RE.test(format)) return false;
+  const validator = FORMAT_VALIDATORS[format as StringFormat];
+  if (!validator) return true; // valid custom formats pass
+  return validator(value);
+}