@jigging/jig 0.0.0 → 0.1.0-alpha.2

package/dist/json.d.ts

@@ -0,0 +1,21 @@
+export type JsonScalar = null | boolean | number | string;
+export type JsonValue = JsonScalar | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = Readonly<Record<string, JsonValue>>;
+export declare const JSON_1_LIMITS: Readonly<{
+    bytes: 16777216;
+    depth: 128;
+    nodes: 262144;
+    containerEntries: 65536;
+    stringBytes: 8388608;
+    memberNameBytes: 1024;
+    numberTokenBytes: 128;
+}>;
+export declare class Json1Error extends Error {
+    constructor(message: string);
+}
+export declare function decodeJson1(bytes: Uint8Array): JsonValue;
+export declare function validateJson1(value: unknown): asserts value is JsonValue;
+/** RFC 8785 canonical bytes for an already validated JSON/1 value. */
+export declare function canonicalJson(value: JsonValue): Uint8Array;

package/dist/project/author.d.ts

@@ -0,0 +1,47 @@
+import type { JsonObject } from "../json.js";
+export interface DiscoverySource {
+    readonly kind: "discover";
+    readonly roots: readonly string[];
+}
+export interface MembersSource {
+    readonly kind: "members";
+    readonly paths: readonly string[];
+}
+export type ProjectSource = DiscoverySource | MembersSource;
+export type ProjectSourceInput = DiscoverySource | readonly string[];
+export interface JigDefinition {
+    readonly flows?: ProjectSource;
+    readonly bindings?: ProjectSource;
+}
+export interface JigDefinitionInput {
+    readonly flows?: ProjectSourceInput;
+    readonly bindings?: ProjectSourceInput;
+}
+export interface FlowRef {
+    readonly kind: "flow";
+    readonly path: string;
+}
+export interface BindingRef {
+    readonly kind: "binding";
+    readonly id: string;
+}
+export type RunTargetRef = FlowRef | BindingRef;
+export interface PackageBindingDefinition {
+    readonly kind: "package";
+    readonly package: string;
+    readonly settings: JsonObject;
+}
+export interface PackageBindingInput {
+    readonly package: string;
+    readonly settings?: JsonObject;
+}
+export type BindingDefinition = PackageBindingDefinition;
+export declare function discover(roots: string | readonly string[]): DiscoverySource;
+export declare function defineJig(input: JigDefinitionInput): JigDefinition;
+/** Evaluator-only canonical re-normalization; absent from the package root. */
+export declare function normalizeJigDefinition(input: unknown): JigDefinition;
+export declare function defineBinding(input: PackageBindingInput): PackageBindingDefinition;
+export declare function flowRef(path: string): FlowRef;
+export declare function bindingRef(id: string): BindingRef;
+/** Evaluator-only canonical re-normalization; absent from the package root. */
+export declare function normalizePackageBindingDefinition(input: unknown): PackageBindingDefinition;

package/libexec/evaluator/project-authoring-1.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://flow.jig.md/schemas/schema-1.json",
+  "title": "Jig project authoring value/1",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/project"
+    },
+    {
+      "$ref": "#/$defs/bindingDefinition"
+    }
+  ],
+  "$defs": {
+    "localName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "projectPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024
+    },
+    "discoverSource": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "discover"
+        },
+        "roots": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/projectPath"
+          },
+          "minItems": 1,
+          "maxItems": 65536
+        }
+      },
+      "required": [
+        "kind",
+        "roots"
+      ],
+      "additionalProperties": false
+    },
+    "membersSource": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "members"
+        },
+        "paths": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/projectPath"
+          },
+          "maxItems": 65536
+        }
+      },
+      "required": [
+        "kind",
+        "paths"
+      ],
+      "additionalProperties": false
+    },
+    "source": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/discoverSource"
+        },
+        {
+          "$ref": "#/$defs/membersSource"
+        }
+      ]
+    },
+    "project": {
+      "type": "object",
+      "properties": {
+        "flows": {
+          "$ref": "#/$defs/source"
+        },
+        "bindings": {
+          "$ref": "#/$defs/source"
+        }
+      },
+      "additionalProperties": false
+    },
+    "packageBinding": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "package"
+        },
+        "package": {
+          "$ref": "#/$defs/projectPath"
+        },
+        "settings": {
+          "type": "object",
+          "maxProperties": 65536
+        }
+      },
+      "required": [
+        "kind",
+        "package",
+        "settings"
+      ],
+      "additionalProperties": false
+    },
+    "bindingDefinition": {
+      "$ref": "#/$defs/packageBinding"
+    }
+  }
+}