@beehexa/hexasync-template-context 2608.20.18 → 2608.20.32

package/dist/environment.js

@@ -0,0 +1,239 @@
+import { POSITION_LABEL } from './position.js';
+import { stepOutputs } from './stepOutputs.js';
+import { arrayShape, field, objectShape, scalarShape, unknownShape, } from './shape.js';
+/** One unix-ms stamp per run. ⚠️ Never spelled `_pull` — that name appears in no runtime. */
+const RUN_START = field('runStart', scalarShape('number'), {
+    kind: 'builtin',
+    note: 'One unix-millisecond stamp taken once per run. Never spelled `_pull`.',
+});
+const RELATED_TASKS = field('__related_tasks', unknownShape('The associated tasks, resolved at run time from the project — not declared in this document.'), { kind: 'builtin' });
+const ENV_ROOT = (name) => field(name, unknownShape('Environment values come from the connection at run time, so their keys are not in this document. Read the ' +
+    "connector's declared options to find out which exist."), { kind: 'builtin' });
+/**
+ * A step's own namespace. `__this.outputs` is refreshed BEFORE `next` is resolved, so a `next` expression can read
+ * the step it belongs to — which is why this is not simply an alias of `_outputs.<own key>`.
+ */
+const THIS_ROOT = (ownArguments) => field('__this', objectShape([
+    field('arguments', objectShape(ownArguments), { kind: 'builtin' }, "This step's own arguments."),
+    field('outputs', unknownShape("This step's own outputs, refreshed before `next` is resolved."), { kind: 'builtin' }),
+    field('definition', unknownShape("This step's definition, as the platform holds it."), {
+        kind: 'builtin',
+    }),
+]), { kind: 'builtin' });
+/**
+ * `_outputs`, plus the two namespaces an author cannot guess and cannot find.
+ *
+ * `_outputs.__error.chain` and `_history` exist to be read by `onErrorSteps`, `finalSteps` and `LOOKUP_STEP`, and
+ * they appear in no authoring surface at all — which is exactly why they are here.
+ */
+const outputsRoot = (steps, phase) => {
+    const perStep = steps.map((step) => field(step.key, step.outputs ??
+        unknownShape(`\`${step.key}\` declares no response filters, so its output keys are not in this document.`), {
+        kind: 'step',
+        stepKey: step.key,
+        ...(phase === undefined ? {} : { phase }),
+    }));
+    return field('_outputs', objectShape([
+        ...perStep,
+        field('__error', objectShape([
+            field('type', scalarShape('string'), { kind: 'builtin' }),
+            field('message', scalarShape('string'), { kind: 'builtin' }),
+            field('stepKey', scalarShape('string'), { kind: 'builtin' }),
+            field('__flow', scalarShape('string'), { kind: 'builtin' }),
+            field('handled', scalarShape('boolean'), { kind: 'builtin' }),
+            field('chain', arrayShape(unknownShape('Each failure in the chain, oldest first.')), {
+                kind: 'builtin',
+            }),
+            field('previous', unknownShape("An earlier flow's failure, nested."), { kind: 'builtin' }),
+        ]), {
+            kind: 'builtin',
+            note: 'Run-level failure. Read by onErrorSteps and finalSteps.',
+        }),
+    ]), { kind: 'builtin' });
+};
+/**
+ * Read a step's facts straight from the authored step, so a caller never has to derive the output shape itself.
+ *
+ * ⚠️ The whole point of `stepOutputs` living beside this is that `…current.STEP_X.<field>` is EXACT — the union of
+ * the step's response-filter keys, written twenty lines above the caret — rather than a guess. A caller that built
+ * `StepFacts` by hand would be re-deriving that, which is how two surfaces start disagreeing.
+ */
+export function stepFactsFrom(step) {
+    const key = String(step?.key ?? '');
+    return { key, outputs: stepOutputs(step).shape };
+}
+/**
+ * ⛔ **Earlier steps in the phase, plus the step itself.**
+ *
+ * `StepIterator` calls the context handler in each step's success path with the accumulated outputs, so after
+ * `STEP_A` the phase holds `{STEP_A}` and after `STEP_B` it holds `{STEP_A, STEP_B}`. A forward reference resolves
+ * to nothing — no error, no diagnostic, an empty string in a URL or a body.
+ *
+ * The step ITSELF is included, and that is not an off-by-one: each pagination iteration calls `ExecuteSteps` afresh
+ * with an empty outputs dict, so at the top of page 2 `puller.current` still holds page 1's values. Reading
+ * `puller.lastToken.PULL_DATA.offset` from inside `PULL_DATA` is the pagination idiom, not a mistake — it is why the
+ * alias is called `lastToken`.
+ */
+export function visibleSteps(steps, stepIndex) {
+    if (stepIndex === undefined)
+        return steps;
+    return steps.slice(0, stepIndex + 1);
+}
+function pullerRoot(request) {
+    const component = request.component;
+    const phases = component?.phases ?? {};
+    const forPhase = (name) => name === request.phase
+        ? visibleSteps(phases[name] ?? [], request.stepIndex)
+        : (phases[name] ?? []);
+    /**
+     * ⛔ `sourcePhase` is the point. `history` and `lastToken` are not phases — they are ALIASES, written by
+     * `LegacyStepContextHandler.UpdateContext` as THE SAME OBJECT as `before` and `current`. Reading them from a phase
+     * of their own name produced two permanently empty roots, which is exactly how an alias silently becomes a store:
+     * the completion list is empty, nothing errors, and 1,695 corpus uses of `puller.lastToken` get no help at all.
+     */
+    const phaseField = (name, note, sourcePhase = name) => field(name, objectShape(forPhase(sourcePhase).map((step) => field(step.key, step.outputs ??
+        unknownShape(`\`${step.key}\` declares no response filters, so its output keys are not in this document.`), { kind: 'step', stepKey: step.key, phase: sourcePhase }))), { kind: 'builtin', note });
+    return field('puller', objectShape([
+        field('options', objectShape((component?.optionKeys ?? []).map((key) => field(key, unknownShape('An option value, supplied per connection.'), {
+            kind: 'builtin',
+        }))), { kind: 'builtin', note: 'The options declared on THIS puller.' }),
+        field('arguments', objectShape((component?.argumentKeys ?? []).map((key) => field(key, unknownShape('An argument the host passed.'), {
+            kind: 'builtin',
+        }))), { kind: 'builtin' }),
+        field('definition', unknownShape("The puller's own definition object."), {
+            kind: 'builtin',
+        }),
+        phaseField('before', 'The beforePullSteps phase.'),
+        phaseField('current', 'The pullSteps phase.'),
+        phaseField('after', 'The afterPullSteps phase.'),
+        phaseField('final', 'The finalSteps phase.'),
+        /**
+         * ⛔ Aliases, not stores. `LegacyStepContextHandler.UpdateContext` writes the phase's outputs to the phase key
+         * and then writes THE SAME OBJECT to `history` (for `before`) and to `lastToken` (for `current`, puller only).
+         * Corpus: `puller.lastToken` 1,695 uses, `puller.history` 1,085 — this is the alphabet the corpus is written
+         * in, and offering them from one resolved set is why hover has to explain which is which.
+         */
+        phaseField('history', 'An ALIAS of `before` — the same object, not a separate store.', 'before'),
+        phaseField('lastToken', 'An ALIAS of `current` — the same object. Read from inside a step it holds the PREVIOUS iteration, which is ' +
+            'the pagination idiom.', 'current'),
+    ]), { kind: 'builtin' });
+}
+function pusherRoot(request) {
+    const component = request.component;
+    const phases = component?.phases ?? {};
+    const phaseField = (name) => field(name, objectShape((name === request.phase
+        ? visibleSteps(phases[name] ?? [], request.stepIndex)
+        : (phases[name] ?? [])).map((step) => field(step.key, step.outputs ??
+        unknownShape(`\`${step.key}\` declares no response filters.`), {
+        kind: 'step',
+        stepKey: step.key,
+        phase: name,
+    }))), { kind: 'builtin' });
+    // ⛔ NO `lastToken`. The handler gates that write on `root == "puller"`, so `pusher.lastToken` does not exist —
+    // and because it reads exactly like the puller idiom, it is worth a diagnostic rather than an empty completion.
+    return field('pusher', objectShape([
+        field('definition', unknownShape("The pusher's own definition object."), {
+            kind: 'builtin',
+        }),
+        /**
+         * ⛔ `options` and `arguments` exist on a PUSHER too, and omitting them cost 134 false findings.
+         *
+         * `CONTEXT-MODEL.md` §4 lists what `Pusher.PushItem` adds at ROOT level and says which phase keys exist; it
+         * does not enumerate what `ParametersBuilder.SetRoot` contributes, which is the same `definition` / `options`
+         * / `arguments` trio it contributes for a puller. I read the silence as absence and the corpus measurement
+         * said otherwise on its first run — 134 reports, every one of them `pusher.options.*`, which the corpus uses
+         * 62 times deliberately. Measuring BEFORE choosing a severity is exactly what caught it (Story 8.6 AC-7).
+         */
+        field('options', objectShape((component?.optionKeys ?? []).map((key) => field(key, unknownShape('An option value, supplied per connection.'), {
+            kind: 'builtin',
+        }))), { kind: 'builtin', note: 'The options declared on THIS pusher.' }),
+        field('arguments', objectShape((component?.argumentKeys ?? []).map((key) => field(key, unknownShape('An argument the host passed.'), {
+            kind: 'builtin',
+        }))), { kind: 'builtin' }),
+        phaseField('before'),
+        phaseField('current'),
+        phaseField('after'),
+        phaseField('final'),
+        phaseField('history'),
+    ]), { kind: 'builtin' });
+}
+/**
+ * Resolve one caret into one environment.
+ *
+ * ⛔ Pure. It reads no file, spawns nothing and imports nothing from an editor — Story 8.1 AC-5, and the reason the
+ * CLI and the extension cannot disagree: there is one function and they both call it. A test asserting "the editor
+ * and the CLI produce the same environment" is only worth writing because it could otherwise have been two engines.
+ */
+export function resolveEnvironment(request) {
+    const { position } = request;
+    const roots = [];
+    let note = `Completing in ${POSITION_LABEL[position]}.`;
+    if (position === 'validation-field') {
+        /**
+         * ⛔ Columns only, and FLAT. The value is interpolated into SQL, so a nested path is not "unresolved" — it is a
+         * column name that does not exist and a query that fails at run time. A transformation-produced field is equally
+         * illegal here: it exists on the item, never on the table.
+         */
+        for (const column of request.columns ?? [])
+            roots.push(column);
+        return {
+            position,
+            roots: new Map(roots.map((each) => [each.name, each])),
+            note: "A validation's field takes a task COLUMN, flat. It is interpolated into SQL, so a nested path or a " +
+                'transformation-produced field names a column that does not exist.',
+        };
+    }
+    if (position === 'transformation-expression') {
+        /**
+         * ⛔ The item's fields BARE. The context object IS the item here, so `{{ item.sku }}` — correct one position
+         * away, in a pusher step — resolves to nothing, silently. That single confusion is most of why this engine
+         * exists.
+         */
+        const item = request.item;
+        if (item?.kind === 'object' && item.fields) {
+            for (const each of item.fields.values())
+                roots.push(each);
+        }
+        roots.push(THIS_ROOT(request.ownArguments ?? []));
+        return {
+            position,
+            roots: new Map(roots.map((each) => [each.name, each])),
+            note: "A transformation expression is evaluated WITH THE ITEM AS ITS CONTEXT, so the item's fields are referenced " +
+                'bare — `sku`, not `item.sku`.',
+        };
+    }
+    const component = request.component;
+    const steps = component?.phases?.[request.phase ?? ''] ?? [];
+    if (position === 'new-kind-puller-step') {
+        // ⛔ No `puller.*` at all. `Puller.RunWorkflow` builds this context by hand and the comment states the intent.
+        roots.push(field('_inputs', objectShape((component?.argumentKeys ?? []).map((key) => field(key, unknownShape('A workflow input, supplied when the flow is invoked.'), {
+            kind: 'builtin',
+        }))), {
+            kind: 'builtin',
+            note: "The workflow's inputs — the generic replacement for `puller.arguments`.",
+        }), outputsRoot(visibleSteps(steps, request.stepIndex), request.phase), THIS_ROOT(request.ownArguments ?? []), ENV_ROOT('_env'), field('_history', unknownShape('A newest-first ring per step key, depth from `retain`. Read by LOOKUP_STEP.'), { kind: 'builtin' }), RUN_START, RELATED_TASKS);
+        note =
+            'This puller declares a `steps` array, so it is a NEW-KIND puller. It shares no context root with a legacy ' +
+                'puller: `puller.*` resolves to nothing here.';
+    }
+    else if (position === 'legacy-puller-step') {
+        roots.push(pullerRoot(request), ENV_ROOT('env'), outputsRoot(visibleSteps(steps, request.stepIndex), request.phase), THIS_ROOT(request.ownArguments ?? []), RUN_START, RELATED_TASKS);
+        note =
+            'This puller declares no `steps` array, so it is a LEGACY puller. It shares no context root with a new-kind ' +
+                'puller: `_inputs` resolves to nothing here.';
+    }
+    else {
+        roots.push(field('item', request.item ??
+            unknownShape('The item could not be resolved from this document.'), { kind: 'builtin' }), field('task', unknownShape('The task this pusher writes, as the platform holds it.'), {
+            kind: 'builtin',
+        }), field('dependencies', unknownShape('The resolved dependencies of this item.'), { kind: 'builtin' }), pusherRoot(request), ENV_ROOT('env'), outputsRoot(visibleSteps(steps, request.stepIndex), request.phase), THIS_ROOT(request.ownArguments ?? []), RUN_START, RELATED_TASKS);
+        note =
+            'A pusher step. ⚠️ `pusher.lastToken` does not exist — that alias is written only for a puller.';
+    }
+    return {
+        position,
+        roots: new Map(roots.map((each) => [each.name, each])),
+        note,
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,UAAU,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,YAAY,GAGb,MAAM,YAAY,CAAC;AAsBpB,6FAA6F;AAC7F,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE;IACzD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,uEAAuE;CAC9E,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,KAAK,CACzB,iBAAiB,EACjB,YAAY,CACV,8FAA8F,CAC/F,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAS,EAAE,CACvC,KAAK,CACH,IAAI,EACJ,YAAY,CACV,4GAA4G;IAC1G,uDAAuD,CAC1D,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AAEJ;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,YAA8B,EAAS,EAAE,CAC1D,KAAK,CACH,QAAQ,EACR,WAAW,CAAC;IACV,KAAK,CACH,WAAW,EACX,WAAW,CAAC,YAAY,CAAC,EACzB,EAAE,IAAI,EAAE,SAAS,EAAE,EACnB,4BAA4B,CAC7B;IACD,KAAK,CACH,SAAS,EACT,YAAY,CACV,+DAA+D,CAChE,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB;IACD,KAAK,CACH,YAAY,EACZ,YAAY,CAAC,mDAAmD,CAAC,EACjE;QACE,IAAI,EAAE,SAAS;KAChB,CACF;CACF,CAAC,EACF,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,KAA2B,EAAE,KAAc,EAAS,EAAE;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,KAAK,CACH,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,OAAO;QACV,YAAY,CACV,KAAK,IAAI,CAAC,GAAG,+EAA+E,CAC7F,EACH;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CACF,CACF,CAAC;IACF,OAAO,KAAK,CACV,UAAU,EACV,WAAW,CAAC;QACV,GAAG,OAAO;QACV,KAAK,CACH,SAAS,EACT,WAAW,CAAC;YACV,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YACzD,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC5D,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC5D,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC3D,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7D,KAAK,CACH,OAAO,EACP,UAAU,CACR,YAAY,CAAC,0CAA0C,CAAC,CACzD,EACD;gBACE,IAAI,EAAE,SAAS;aAChB,CACF;YACD,KAAK,CACH,UAAU,EACV,YAAY,CAAC,oCAAoC,CAAC,EAClD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB;SACF,CAAC,EACF;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,yDAAyD;SAChE,CACF;KACF,CAAC,EACF,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AACJ,CAAC,CAAC;AASF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,GAAG,GAAG,MAAM,CAAE,IAAsC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AACnD,CAAC;AA0BD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA2B,EAC3B,SAA6B;IAE7B,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,OAAuB;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAwB,EAAE,CACtD,IAAI,KAAK,OAAO,CAAC,KAAK;QACpB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC;QACrD,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,WAAW,GAAG,IAAI,EAAS,EAAE,CAC3E,KAAK,CACH,IAAI,EACJ,WAAW,CACT,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,KAAK,CACH,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,OAAO;QACV,YAAY,CACV,KAAK,IAAI,CAAC,GAAG,+EAA+E,CAC7F,EACH,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CACxD,CACF,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAC1B,CAAC;IAEJ,OAAO,KAAK,CACV,QAAQ,EACR,WAAW,CAAC;QACV,KAAK,CACH,SAAS,EACT,WAAW,CACT,CAAC,SAAS,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACxC,KAAK,CACH,GAAG,EACH,YAAY,CAAC,2CAA2C,CAAC,EACzD;YACE,IAAI,EAAE,SAAS;SAChB,CACF,CACF,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAClE;QACD,KAAK,CACH,WAAW,EACX,WAAW,CACT,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1C,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,8BAA8B,CAAC,EAAE;YACvD,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB;QACD,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,qCAAqC,CAAC,EAAE;YACvE,IAAI,EAAE,SAAS;SAChB,CAAC;QACF,UAAU,CAAC,QAAQ,EAAE,4BAA4B,CAAC;QAClD,UAAU,CAAC,SAAS,EAAE,sBAAsB,CAAC;QAC7C,UAAU,CAAC,OAAO,EAAE,2BAA2B,CAAC;QAChD,UAAU,CAAC,OAAO,EAAE,uBAAuB,CAAC;QAC5C;;;;;WAKG;QACH,UAAU,CACR,SAAS,EACT,+DAA+D,EAC/D,QAAQ,CACT;QACD,UAAU,CACR,WAAW,EACX,6GAA6G;YAC3G,uBAAuB,EACzB,SAAS,CACV;KACF,CAAC,EACF,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAuB;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAS,EAAE,CACzC,KAAK,CACH,IAAI,EACJ,WAAW,CACT,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK;QACrB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC;QACrD,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CACvB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACb,KAAK,CACH,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,OAAO;QACV,YAAY,CAAC,KAAK,IAAI,CAAC,GAAG,kCAAkC,CAAC,EAC/D;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,KAAK,EAAE,IAAI;KACZ,CACF,CACF,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;IAEJ,+GAA+G;IAC/G,gHAAgH;IAChH,OAAO,KAAK,CACV,QAAQ,EACR,WAAW,CAAC;QACV,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,qCAAqC,CAAC,EAAE;YACvE,IAAI,EAAE,SAAS;SAChB,CAAC;QACF;;;;;;;;WAQG;QACH,KAAK,CACH,SAAS,EACT,WAAW,CACT,CAAC,SAAS,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACxC,KAAK,CACH,GAAG,EACH,YAAY,CAAC,2CAA2C,CAAC,EACzD;YACE,IAAI,EAAE,SAAS;SAChB,CACF,CACF,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAClE;QACD,KAAK,CACH,WAAW,EACX,WAAW,CACT,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1C,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,8BAA8B,CAAC,EAAE;YACvD,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CACF,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB;QACD,UAAU,CAAC,QAAQ,CAAC;QACpB,UAAU,CAAC,SAAS,CAAC;QACrB,UAAU,CAAC,OAAO,CAAC;QACnB,UAAU,CAAC,OAAO,CAAC;QACnB,UAAU,CAAC,SAAS,CAAC;KACtB,CAAC,EACF,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,IAAI,IAAI,GAAG,iBAAiB,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;IAExD,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;QACpC;;;;WAIG;QACH,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACtD,IAAI,EACF,qGAAqG;gBACrG,mEAAmE;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,2BAA2B,EAAE,CAAC;QAC7C;;;;WAIG;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACtD,IAAI,EACF,6GAA6G;gBAC7G,+BAA+B;SAClC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,KAAK,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAE7D,IAAI,QAAQ,KAAK,sBAAsB,EAAE,CAAC;QACxC,8GAA8G;QAC9G,KAAK,CAAC,IAAI,CACR,KAAK,CACH,SAAS,EACT,WAAW,CACT,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1C,KAAK,CACH,GAAG,EACH,YAAY,CACV,sDAAsD,CACvD,EACD;YACE,IAAI,EAAE,SAAS;SAChB,CACF,CACF,CACF,EACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,yEAAyE;SAChF,CACF,EACD,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAClE,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EACrC,QAAQ,CAAC,MAAM,CAAC,EAChB,KAAK,CACH,UAAU,EACV,YAAY,CACV,6EAA6E,CAC9E,EACD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,EACD,SAAS,EACT,aAAa,CACd,CAAC;QACF,IAAI;YACF,4GAA4G;gBAC5G,8CAA8C,CAAC;IACnD,CAAC;SAAM,IAAI,QAAQ,KAAK,oBAAoB,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CACR,UAAU,CAAC,OAAO,CAAC,EACnB,QAAQ,CAAC,KAAK,CAAC,EACf,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAClE,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EACrC,SAAS,EACT,aAAa,CACd,CAAC;QACF,IAAI;YACF,6GAA6G;gBAC7G,6CAA6C,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,KAAK,CACH,MAAM,EACN,OAAO,CAAC,IAAI;YACV,YAAY,CAAC,oDAAoD,CAAC,EACpE,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,EACD,KAAK,CACH,MAAM,EACN,YAAY,CAAC,wDAAwD,CAAC,EACtE;YACE,IAAI,EAAE,SAAS;SAChB,CACF,EACD,KAAK,CACH,cAAc,EACd,YAAY,CAAC,yCAAyC,CAAC,EACvD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,EACD,UAAU,CAAC,OAAO,CAAC,EACnB,QAAQ,CAAC,KAAK,CAAC,EACf,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAClE,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EACrC,SAAS,EACT,aAAa,CACd,CAAC;QACF,IAAI;YACF,gGAAgG,CAAC;IACrG,CAAC;IAED,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/hints.d.ts

@@ -0,0 +1,62 @@
+import { type Field, type Shape } from './shape.js';
+/**
+ * `dataHints` — declaring the shape the platform cannot know (Stories 8.8 and 8.12).
+ *
+ * Layer 2 of the item is the decoded `__raw`, and **nothing in the project declares it**: it is the source system's
+ * payload. Yet the corpus references it constantly — `item.line_items[0].code` works at run time while no document
+ * says `line_items` has a `code`. `dataHints` closes exactly that hole and nothing else.
+ *
+ * ⛔ **Values never survive.** The schema forbids every value-bearing keyword — `example`, `examples`, `default`,
+ * `enum`, `const` — so a payload full of customer names cannot reach a template repository even by accident. This is
+ * the property's one hard rule, and the reason it is safe to paste a real payload into an editor at all.
+ */
+export declare const VALUE_BEARING_KEYWORDS: readonly ['example', 'examples', 'default', 'enum', 'const'];
+/** The JSON-Schema subset a hint may use. Anything else is either a value or a constraint nobody consumes. */
+export declare const ALLOWED_KEYWORDS: readonly ['type', 'properties', 'items', 'description'];
+export interface HintProblem {
+    readonly path: string;
+    readonly reason: string;
+}
+/**
+ * Validate a hints block. Returns every problem, so an author fixes them in one pass rather than one per save.
+ *
+ * ⚠️ A value-bearing keyword is an ERROR rather than a strip-and-continue. Silently removing it would leave the
+ * author believing the tool accepted their input, and the next paste would put the value back.
+ */
+export declare function checkHints(hints: unknown, at?: string): readonly HintProblem[];
+/** Turn a validated hints block into the shape the engine completes against. */
+export declare function shapeFromHints(hints: unknown): Shape;
+/** Every top-level hinted key as a field, for merging into the item. */
+export declare function hintFields(dataHints: unknown): readonly Field[];
+export interface InferOptions {
+    readonly maxDepth?: number;
+    readonly maxProperties?: number;
+}
+export interface InferredHints {
+    readonly hints: Record<string, unknown>;
+    /** ⛔ Every cap that fired, named. A silent cap reads as "that is the whole payload". */
+    readonly truncations: readonly string[];
+}
+/**
+ * Infer a hints block from a real payload — Story 8.12.
+ *
+ * The edge cases are what decide whether the output can be trusted, and each one below is the NON-obvious choice:
+ *
+ * | input | emitted | why not the obvious thing |
+ * | --- | --- | --- |
+ * | array of objects | `items` from the **union of every element** | element 0 is routinely the least complete; an optional field appears on element 7 |
+ * | heterogeneous array | `items` unknown, with the reason | a union of unlike shapes is a lie that completes wrongly |
+ * | empty array / `null` | the key, shape unknown | the key's presence is the useful half; dropping it loses a real field |
+ * | a string containing JSON | `type: string` | the runtime hands the transformation a STRING; guessing structure outruns it |
+ */
+export declare function inferHints(payload: unknown, options?: InferOptions): InferredHints;
+/**
+ * Merge two hint blocks — Story 8.12's "a second paste merges, it does not overwrite".
+ *
+ * ⛔ A thinner payload must not DOWNGRADE what is already declared. Two payloads describe the same entity more
+ * completely than either alone — the optional field that appeared on neither is the whole reason to paste twice.
+ */
+export declare function mergeHint(existing: Record<string, unknown>, incoming: Record<string, unknown>): Record<string, unknown>;
+/** Merge a whole `dataHints` map, path by path. */
+export declare function mergeHints(existing: Record<string, unknown>, incoming: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=hints.d.ts.map

package/dist/hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../src/hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,KAAK,EACV,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,YACjC,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,CACC,CAAC;AAEX,8GAA8G;AAC9G,eAAO,MAAM,gBAAgB,YAC3B,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,CACL,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,SAAK,GAAG,SAAS,WAAW,EAAE,CAoC1E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA+BpD;AAOD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,KAAK,EAAE,CAO/D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,wFAAwF;IACxF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAiB,GACzB,aAAa,CAiEf;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/hints.js

@@ -0,0 +1,198 @@
+import { arrayShape, field, objectShape, scalarShape, unknownShape, } from './shape.js';
+/**
+ * `dataHints` — declaring the shape the platform cannot know (Stories 8.8 and 8.12).
+ *
+ * Layer 2 of the item is the decoded `__raw`, and **nothing in the project declares it**: it is the source system's
+ * payload. Yet the corpus references it constantly — `item.line_items[0].code` works at run time while no document
+ * says `line_items` has a `code`. `dataHints` closes exactly that hole and nothing else.
+ *
+ * ⛔ **Values never survive.** The schema forbids every value-bearing keyword — `example`, `examples`, `default`,
+ * `enum`, `const` — so a payload full of customer names cannot reach a template repository even by accident. This is
+ * the property's one hard rule, and the reason it is safe to paste a real payload into an editor at all.
+ */
+export const VALUE_BEARING_KEYWORDS = [
+    'example',
+    'examples',
+    'default',
+    'enum',
+    'const',
+];
+/** The JSON-Schema subset a hint may use. Anything else is either a value or a constraint nobody consumes. */
+export const ALLOWED_KEYWORDS = [
+    'type',
+    'properties',
+    'items',
+    'description',
+];
+/**
+ * Validate a hints block. Returns every problem, so an author fixes them in one pass rather than one per save.
+ *
+ * ⚠️ A value-bearing keyword is an ERROR rather than a strip-and-continue. Silently removing it would leave the
+ * author believing the tool accepted their input, and the next paste would put the value back.
+ */
+export function checkHints(hints, at = '') {
+    const problems = [];
+    if (!hints || typeof hints !== 'object' || Array.isArray(hints))
+        return problems;
+    for (const [key, value] of Object.entries(hints)) {
+        const path = at ? `${at}.${key}` : key;
+        if (VALUE_BEARING_KEYWORDS.includes(key)) {
+            problems.push({
+                path,
+                reason: `\`${key}\` carries a VALUE, and a hint declares only shape. A template repository is shared, so a value ` +
+                    'pasted from a real payload would be committed with it. Remove it — the shape is the useful half.',
+            });
+            continue;
+        }
+        if (at !== '' &&
+            !ALLOWED_KEYWORDS.includes(key) &&
+            at.endsWith('.properties') === false) {
+            // Keys under `properties` are field names and may be anything; keys elsewhere must be schema keywords.
+            if (/^(type|properties|items|description)$/.test(key) === false &&
+                at.includes('.properties.') === false) {
+                problems.push({
+                    path,
+                    reason: `\`${key}\` is not part of the hint subset. A hint uses only: ${ALLOWED_KEYWORDS.join(', ')}.`,
+                });
+                continue;
+            }
+        }
+        problems.push(...checkHints(value, path));
+    }
+    return problems;
+}
+/** Turn a validated hints block into the shape the engine completes against. */
+export function shapeFromHints(hints) {
+    const node = hints;
+    const type = node?.['type'];
+    const description = typeof node?.['description'] === 'string'
+        ? node['description']
+        : undefined;
+    if (type === 'object') {
+        const properties = (node?.['properties'] ?? {});
+        return objectShape(Object.entries(properties).map(([name, child]) => field(name, shapeFromHints(child), { kind: 'hint' }, describe(child) ?? description)));
+    }
+    if (type === 'array') {
+        const items = node?.['items'];
+        return arrayShape(items === undefined
+            ? unknownShape('The hint declares an array but not its element shape.')
+            : shapeFromHints(items));
+    }
+    if (typeof type === 'string')
+        return scalarShape(type);
+    return unknownShape('The hint does not declare a type for this key.');
+}
+const describe = (node) => {
+    const value = node?.['description'];
+    return typeof value === 'string' ? value : undefined;
+};
+/** Every top-level hinted key as a field, for merging into the item. */
+export function hintFields(dataHints) {
+    if (!dataHints || typeof dataHints !== 'object' || Array.isArray(dataHints))
+        return [];
+    return Object.entries(dataHints).map(([name, hint]) => field(name, shapeFromHints(hint), { kind: 'hint' }, describe(hint)));
+}
+const DEFAULT_DEPTH = 6;
+const DEFAULT_BREADTH = 80;
+/**
+ * Infer a hints block from a real payload — Story 8.12.
+ *
+ * The edge cases are what decide whether the output can be trusted, and each one below is the NON-obvious choice:
+ *
+ * | input | emitted | why not the obvious thing |
+ * | --- | --- | --- |
+ * | array of objects | `items` from the **union of every element** | element 0 is routinely the least complete; an optional field appears on element 7 |
+ * | heterogeneous array | `items` unknown, with the reason | a union of unlike shapes is a lie that completes wrongly |
+ * | empty array / `null` | the key, shape unknown | the key's presence is the useful half; dropping it loses a real field |
+ * | a string containing JSON | `type: string` | the runtime hands the transformation a STRING; guessing structure outruns it |
+ */
+export function inferHints(payload, options = {}) {
+    const maxDepth = options.maxDepth ?? DEFAULT_DEPTH;
+    const maxProperties = options.maxProperties ?? DEFAULT_BREADTH;
+    const truncations = [];
+    const infer = (value, depth, at) => {
+        if (depth > maxDepth) {
+            truncations.push(`\`${at}\` is deeper than the ${maxDepth}-level cap, so its shape stops here.`);
+            return {};
+        }
+        if (value === null)
+            return {}; // The key survives; its type does not (see the table above).
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return { type: 'array' };
+            const kinds = new Set(value.map((element) => kindOf(element)));
+            if (kinds.size > 1) {
+                truncations.push(`\`${at}\` holds elements of more than one kind, so its element shape is not declared.`);
+                return { type: 'array' };
+            }
+            // ⛔ The UNION of every element, not the first.
+            const merged = value.reduce((all, element) => mergeHint(all, infer(element, depth + 1, `${at}[]`)), {});
+            return { type: 'array', items: merged };
+        }
+        if (typeof value === 'object') {
+            const entries = Object.entries(value);
+            const kept = entries.slice(0, maxProperties);
+            if (kept.length < entries.length) {
+                truncations.push(`\`${at}\` has ${entries.length} keys, more than the ${maxProperties}-key cap — ${entries.length - kept.length} are not declared.`);
+            }
+            return {
+                type: 'object',
+                properties: Object.fromEntries(kept.map(([key, child]) => [
+                    key,
+                    infer(child, depth + 1, at ? `${at}.${key}` : key),
+                ])),
+            };
+        }
+        // ⛔ A string stays a string even when its content parses as JSON.
+        return {
+            type: typeof value === 'number'
+                ? 'number'
+                : typeof value === 'boolean'
+                    ? 'boolean'
+                    : 'string',
+        };
+    };
+    const root = infer(payload, 1, '');
+    const properties = (root['properties'] ?? {});
+    return { hints: properties, truncations };
+}
+const kindOf = (value) => value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value;
+/**
+ * Merge two hint blocks — Story 8.12's "a second paste merges, it does not overwrite".
+ *
+ * ⛔ A thinner payload must not DOWNGRADE what is already declared. Two payloads describe the same entity more
+ * completely than either alone — the optional field that appeared on neither is the whole reason to paste twice.
+ */
+export function mergeHint(existing, incoming) {
+    const merged = { ...existing };
+    for (const [key, value] of Object.entries(incoming)) {
+        const current = merged[key];
+        if (key === 'properties' || key === 'items') {
+            merged[key] =
+                current &&
+                    typeof current === 'object' &&
+                    value &&
+                    typeof value === 'object'
+                    ? mergeHint(current, value)
+                    : (current ?? value);
+            continue;
+        }
+        // An existing declaration wins: the first paste may have seen a field this one did not.
+        if (current === undefined)
+            merged[key] = value;
+    }
+    return merged;
+}
+/** Merge a whole `dataHints` map, path by path. */
+export function mergeHints(existing, incoming) {
+    const merged = { ...existing };
+    for (const [key, value] of Object.entries(incoming)) {
+        const current = merged[key];
+        merged[key] =
+            current && typeof current === 'object'
+                ? mergeHint(current, value)
+                : value;
+    }
+    return merged;
+}
+//# sourceMappingURL=hints.js.map

package/dist/hints.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './shape.js';
+export * from './position.js';
+export * from './environment.js';
+export * from './detect.js';
+export * from './completion.js';
+export * from './stepOutputs.js';
+export * from './item.js';
+export * from './references.js';
+export * from './hints.js';
+export * from './survival.js';
+export * from './walk.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from './shape.js';
+export * from './position.js';
+export * from './environment.js';
+export * from './detect.js';
+export * from './completion.js';
+export * from './stepOutputs.js';
+export * from './item.js';
+export * from './references.js';
+export * from './hints.js';
+export * from './survival.js';
+export * from './walk.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}