@fulmenhq/tsfulmen 0.2.0 → 0.2.3

package/schemas/crucible-ts/library/fulencode/v1.0.0/fulencode-error.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/library/fulencode/v1.0.0/fulencode-error.schema.json",
+  "title": "Fulencode Error",
+  "description": "Canonical error envelope for Fulencode operations",
+  "type": "object",
+  "properties": {
+    "code": {
+      "type": "string"
+    },
+    "message": {
+      "type": "string"
+    },
+    "operation": {
+      "type": "string"
+    },
+    "input_format": {
+      "type": "string"
+    },
+    "output_format": {
+      "type": "string"
+    },
+    "details": {
+      "type": "object",
+      "properties": {
+        "byte_offset": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "codepoint_offset": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "detected_encoding": {
+          "type": "string"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0.0,
+          "maximum": 1.0
+        },
+        "invalid_bytes": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 255
+          }
+        },
+        "expected": {
+          "type": "string"
+        },
+        "actual": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "code",
+    "message",
+    "operation"
+  ],
+  "additionalProperties": false
+}

package/schemas/crucible-ts/library/fulencode/v1.0.0/normalization-result.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/library/fulencode/v1.0.0/normalization-result.schema.json",
+  "title": "Fulencode Normalization Result",
+  "description": "Result payload for fulencode normalize()",
+  "type": "object",
+  "properties": {
+    "text": {
+      "type": "string"
+    },
+    "profile": {
+      "type": "string"
+    },
+    "input_length": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "output_length": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "transformations_applied": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "semantic_changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "position": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "original": {
+            "type": "string"
+          },
+          "normalized": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "position",
+          "original",
+          "normalized",
+          "reason"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "text",
+    "profile",
+    "input_length",
+    "output_length",
+    "transformations_applied",
+    "semantic_changes",
+    "warnings"
+  ],
+  "additionalProperties": false
+}

package/schemas/crucible-ts/library/fulencode/v1.0.0/normalize-options.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/library/fulencode/v1.0.0/normalize-options.schema.json",
+  "title": "Fulencode Normalize Options",
+  "description": "Options for fulencode normalize() operation",
+  "type": "object",
+  "properties": {
+    "warn_semantic_change": {
+      "type": "boolean",
+      "description": "Warn when normalization performs semantic-changing transforms (NFKC/NFKD)."
+    },
+    "reject_zero_width": {
+      "type": "boolean",
+      "description": "Reject zero-width characters when true."
+    },
+    "reject_bidi_controls": {
+      "type": "boolean",
+      "description": "Reject bidi control characters (override/isolate) when true."
+    },
+    "max_combining_marks": {
+      "type": "integer",
+      "description": "Maximum combining marks per base character.",
+      "minimum": 1,
+      "maximum": 100
+    },
+    "strip_accents": {
+      "type": "boolean",
+      "description": "Remove combining marks/diacritics when true."
+    },
+    "case_fold": {
+      "type": "boolean",
+      "description": "Apply Unicode case folding when true."
+    },
+    "remove_punctuation": {
+      "type": "boolean",
+      "description": "Remove punctuation and symbol categories when true."
+    },
+    "compress_whitespace": {
+      "type": "boolean",
+      "description": "Collapse consecutive whitespace to a single space when true."
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/crucible-ts/meta/README.md

@@ -2,15 +2,47 @@
 
 This directory stores the curated JSON Schema meta-schemas that FulmenHQ tools need for
 offline validation. Directory names mirror the signature tags defined in
-schema signatures (e.g., `draft-07`, `draft-2020-12`) so downstream automation can reason about available drafts.
+schema signatures (e.g., `draft-04`, `draft-06`, `draft-07`, `draft-2019-09`, `draft-2020-12`) so downstream automation can reason about available drafts.
 
 ## Contents
 
+- `draft-04/` – canonical Draft-04 meta-schema (`schema.json`).
+  - Single-file, self-contained meta-schema.
+  - Uses `id` instead of `$id` (pre-Draft-06 convention).
+  - Common in SchemaStore and legacy tooling.
+
+- `draft-06/` – canonical Draft-06 meta-schema (`schema.json`).
+  - Single-file, self-contained meta-schema.
+  - Introduced `$id`, `const`, `contains`, `propertyNames`.
+  - Boolean schemas allowed (`true`/`false` as schemas).
+
 - `draft-07/` – canonical Draft-07 meta-schema (`schema.json`).
+  - Single-file, self-contained meta-schema.
+  - Added `if`/`then`/`else`, `readOnly`, `writeOnly`, `$comment`.
+
+- `draft-2019-09/` – canonical Draft 2019-09 meta-schema plus offline helpers.
+  - `schema.json` – raw meta-schema with `$ref` to modular vocabularies.
+  - `offline.schema.json` – reduced subset for offline validation (no external refs).
+  - `meta/` – modular vocabularies (`core.json`, `validation.json`, `applicator.json`, etc.).
+  - Uses `$recursiveAnchor`/`$recursiveRef` (replaced by `$dynamicAnchor` in 2020-12).
+  - Introduced `$vocabulary`, `$anchor`, `unevaluatedProperties`, `unevaluatedItems`.
+
 - `draft-2020-12/` – canonical Draft 2020-12 meta-schema plus offline helpers.
   - `schema.json` – raw meta-schema fetched from json-schema.org.
   - `offline.schema.json` – reduced subset used when offline validation is needed.
-  - `meta/` – reserved for additional vocabularies (`core.json`, `validation.json`, etc.).
+  - `meta/` – modular vocabularies (`core.json`, `validation.json`, `applicator.json`, etc.).
+  - Uses `$dynamicAnchor`/`$dynamicRef` (replacing recursive anchor from 2019-09).
+  - Recommended default for new schemas.
+
+## Draft Selection Guidance
+
+| Draft         | When to Use                                                     |
+| ------------- | --------------------------------------------------------------- |
+| Draft-04      | Legacy schema compatibility (SchemaStore, older tools)          |
+| Draft-06      | Transitional schemas needing `const` but not `if`/`then`/`else` |
+| Draft-07      | Stable choice with conditional keywords, wide tool support      |
+| Draft 2019-09 | Advanced features without 2020-12's dynamic refs                |
+| Draft 2020-12 | **Recommended** for new schemas, latest features                |
 
 ## Refresh Workflow
 
@@ -21,3 +53,7 @@ Meta-schemas are treated as curated assets. Refresh them from upstream when netw
 ## Offline Subset
 
 `draft-2020-12/offline.schema.json` is a minimal schema that covers the portions of the spec needed for validation. It avoids `$ref` chains to `meta/*` so the validator can operate without network access. Keep it in sync with upstream changes as needed.
+
+## Fixtures
+
+`fixtures/` contains minimal sample schemas for each draft. These are intended for cross-language parity tests and for validating that the embedded meta-schemas load correctly.

package/schemas/crucible-ts/meta/draft-04/schema.json

@@ -0,0 +1,222 @@
+{
+  "id": "http://json-schema.org/draft-04/schema#",
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "description": "Core schema meta-schema",
+  "definitions": {
+    "schemaArray": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#"
+      }
+    },
+    "positiveInteger": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "positiveIntegerDefault0": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/positiveInteger"
+        },
+        {
+          "default": 0
+        }
+      ]
+    },
+    "simpleTypes": {
+      "enum": [
+        "array",
+        "boolean",
+        "integer",
+        "null",
+        "number",
+        "object",
+        "string"
+      ]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  },
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "$schema": {
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "default": {},
+    "multipleOf": {
+      "type": "number",
+      "minimum": 0,
+      "exclusiveMinimum": true
+    },
+    "maximum": {
+      "type": "number"
+    },
+    "exclusiveMaximum": {
+      "type": "boolean",
+      "default": false
+    },
+    "minimum": {
+      "type": "number"
+    },
+    "exclusiveMinimum": {
+      "type": "boolean",
+      "default": false
+    },
+    "maxLength": {
+      "$ref": "#/definitions/positiveInteger"
+    },
+    "minLength": {
+      "$ref": "#/definitions/positiveIntegerDefault0"
+    },
+    "pattern": {
+      "type": "string",
+      "format": "regex"
+    },
+    "additionalItems": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "$ref": "#"
+        }
+      ],
+      "default": {}
+    },
+    "items": {
+      "anyOf": [
+        {
+          "$ref": "#"
+        },
+        {
+          "$ref": "#/definitions/schemaArray"
+        }
+      ],
+      "default": {}
+    },
+    "maxItems": {
+      "$ref": "#/definitions/positiveInteger"
+    },
+    "minItems": {
+      "$ref": "#/definitions/positiveIntegerDefault0"
+    },
+    "uniqueItems": {
+      "type": "boolean",
+      "default": false
+    },
+    "maxProperties": {
+      "$ref": "#/definitions/positiveInteger"
+    },
+    "minProperties": {
+      "$ref": "#/definitions/positiveIntegerDefault0"
+    },
+    "required": {
+      "$ref": "#/definitions/stringArray"
+    },
+    "additionalProperties": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "$ref": "#"
+        }
+      ],
+      "default": {}
+    },
+    "definitions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "default": {}
+    },
+    "properties": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "default": {}
+    },
+    "patternProperties": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "default": {}
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "$ref": "#"
+          },
+          {
+            "$ref": "#/definitions/stringArray"
+          }
+        ]
+      }
+    },
+    "enum": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "type": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/simpleTypes"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/simpleTypes"
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      ]
+    },
+    "format": {
+      "type": "string"
+    },
+    "allOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "anyOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "oneOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "not": {
+      "$ref": "#"
+    }
+  },
+  "dependencies": {
+    "exclusiveMaximum": [
+      "maximum"
+    ],
+    "exclusiveMinimum": [
+      "minimum"
+    ]
+  },
+  "default": {}
+}

package/schemas/crucible-ts/meta/draft-06/schema.json

@@ -0,0 +1,218 @@
+{
+  "$schema": "http://json-schema.org/draft-06/schema#",
+  "$id": "http://json-schema.org/draft-06/schema#",
+  "title": "Core schema meta-schema",
+  "definitions": {
+    "schemaArray": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#"
+      }
+    },
+    "nonNegativeInteger": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "nonNegativeIntegerDefault0": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/nonNegativeInteger"
+        },
+        {
+          "default": 0
+        }
+      ]
+    },
+    "simpleTypes": {
+      "enum": [
+        "array",
+        "boolean",
+        "integer",
+        "null",
+        "number",
+        "object",
+        "string"
+      ]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "default": []
+    }
+  },
+  "type": [
+    "object",
+    "boolean"
+  ],
+  "properties": {
+    "$id": {
+      "type": "string",
+      "format": "uri-reference"
+    },
+    "$schema": {
+      "type": "string",
+      "format": "uri"
+    },
+    "$ref": {
+      "type": "string",
+      "format": "uri-reference"
+    },
+    "title": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "default": {},
+    "examples": {
+      "type": "array",
+      "items": {}
+    },
+    "multipleOf": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "maximum": {
+      "type": "number"
+    },
+    "exclusiveMaximum": {
+      "type": "number"
+    },
+    "minimum": {
+      "type": "number"
+    },
+    "exclusiveMinimum": {
+      "type": "number"
+    },
+    "maxLength": {
+      "$ref": "#/definitions/nonNegativeInteger"
+    },
+    "minLength": {
+      "$ref": "#/definitions/nonNegativeIntegerDefault0"
+    },
+    "pattern": {
+      "type": "string",
+      "format": "regex"
+    },
+    "additionalItems": {
+      "$ref": "#"
+    },
+    "items": {
+      "anyOf": [
+        {
+          "$ref": "#"
+        },
+        {
+          "$ref": "#/definitions/schemaArray"
+        }
+      ],
+      "default": {}
+    },
+    "maxItems": {
+      "$ref": "#/definitions/nonNegativeInteger"
+    },
+    "minItems": {
+      "$ref": "#/definitions/nonNegativeIntegerDefault0"
+    },
+    "uniqueItems": {
+      "type": "boolean",
+      "default": false
+    },
+    "contains": {
+      "$ref": "#"
+    },
+    "maxProperties": {
+      "$ref": "#/definitions/nonNegativeInteger"
+    },
+    "minProperties": {
+      "$ref": "#/definitions/nonNegativeIntegerDefault0"
+    },
+    "required": {
+      "$ref": "#/definitions/stringArray"
+    },
+    "additionalProperties": {
+      "$ref": "#"
+    },
+    "definitions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "default": {}
+    },
+    "properties": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "default": {}
+    },
+    "patternProperties": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#"
+      },
+      "propertyNames": {
+        "format": "regex"
+      },
+      "default": {}
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "$ref": "#"
+          },
+          {
+            "$ref": "#/definitions/stringArray"
+          }
+        ]
+      }
+    },
+    "propertyNames": {
+      "$ref": "#"
+    },
+    "const": {},
+    "enum": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "type": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/simpleTypes"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/simpleTypes"
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      ]
+    },
+    "format": {
+      "type": "string"
+    },
+    "allOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "anyOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "oneOf": {
+      "$ref": "#/definitions/schemaArray"
+    },
+    "not": {
+      "$ref": "#"
+    }
+  },
+  "default": {}
+}