footprintjs 0.2.2 → 0.3.0

package/README.md

@@ -21,9 +21,48 @@ FootPrint is a runtime for building **flowchart pipelines** where each node is j
 npm install footprintjs
 ```
 
+## Quick Start
+
+```typescript
+import { flowChart, FlowChartExecutor, ScopeFacade, toScopeFactory } from 'footprintjs';
+
+const chart = flowChart('Greet', (scope) => {
+    scope.setValue('name', 'Alice');
+  })
+  .addFunction('Personalize', (scope) => {
+    const name = scope.getValue('name');
+    scope.setValue('message', `Hello, ${name}!`);
+  })
+  .setEnableNarrative()
+  .build();
+
+const executor = new FlowChartExecutor(chart, toScopeFactory(ScopeFacade));
+const result = await executor.run();
+
+console.log(executor.getNarrative());
+// Stage 1: The process began with Greet.
+//   Step 1: Write name = "Alice"
+// Stage 2: Next, it moved on to Personalize.
+//   Step 1: Read name = "Alice"
+//   Step 2: Write message = "Hello, Alice!"
+```
+
+> **[Try it in the browser](https://footprintjs.github.io/footprint-playground/)** — no install needed
+>
+> **[Browse 20+ examples](https://github.com/footprintjs/footPrint-samples)** — features, flowchart patterns, and a full loan underwriting demo
+
 ---
 
-## Why causal traces?
+## Why FootPrint?
+
+| | Without FootPrint | With FootPrint |
+|---|---|---|
+| **LLM explains a decision** | Reconstruct from scattered logs; expensive, slow, hallucination-prone | Read the causal trace; cheap model, fewer tokens, zero hallucination |
+| **Tool descriptions** | Write and maintain them by hand | Auto-generated from the flowchart structure |
+| **Debugging** | `console.log` + guesswork | Time-travel replay to any stage |
+| **State management** | Global/manual, race-prone | Transactional scope with atomic commits |
+
+### Example: Loan rejection
 
 A loan application pipeline rejects Bob. The user asks: **"Why was I rejected?"**
 
@@ -69,86 +108,81 @@ No one wrote those trace sentences. Stage functions just read and write scope &m
 
 ```typescript
 import {
-  FlowChartBuilder, FlowChartExecutor, ScopeFacade, toScopeFactory,
+  flowChart, FlowChartExecutor, ScopeFacade, toScopeFactory,
 } from 'footprintjs';
 
-// ── The application data ──────────────────────────────────────────────
-
-const app = {
-  applicantName: 'Bob',
-  annualIncome: 42_000,
-  monthlyDebts: 2_100,
-  creditScore: 580,
-  employmentType: 'self-employed',
-  employmentYears: 1,
-};
-
-// ── Stage functions: just do the work, no descriptions needed ──────────
+// ── Stage functions: just read and write scope ─────────────────────────
 
 const receiveApplication = (scope: ScopeFacade) => {
-  scope.setValue('app', app);
+  scope.setValue('app', {
+    applicantName: 'Bob',
+    annualIncome: 42_000,
+    monthlyDebts: 2_100,
+    creditScore: 580,
+    employmentType: 'self-employed',
+    employmentYears: 1,
+  });
 };
 
 const pullCreditReport = (scope: ScopeFacade) => {
   const { creditScore } = scope.getValue('app') as any;
-  const tier = creditScore >= 740 ? 'excellent' : creditScore >= 670 ? 'good'
-             : creditScore >= 580 ? 'fair' : 'poor';
+  const tier = creditScore >= 740 ? 'excellent'
+    : creditScore >= 670 ? 'good'
+    : creditScore >= 580 ? 'fair' : 'poor';
+
   scope.setValue('creditTier', tier);
   scope.setValue('creditFlags', tier === 'fair' ? ['below-average credit'] : []);
 };
 
 const calculateDTI = (scope: ScopeFacade) => {
   const { annualIncome, monthlyDebts } = scope.getValue('app') as any;
-  const dtiRatio = Math.round((monthlyDebts / (annualIncome / 12)) * 100) / 100;
-  scope.setValue('dtiRatio', dtiRatio);
-  scope.setValue('dtiPercent', Math.round(dtiRatio * 100));
-  scope.setValue('dtiStatus', dtiRatio > 0.43 ? 'excessive' : 'healthy');
-  scope.setValue('dtiFlags',
-    dtiRatio > 0.43 ? [`DTI at ${Math.round(dtiRatio * 100)}% exceeds 43%`] : []);
+  const ratio = Math.round((monthlyDebts / (annualIncome / 12)) * 100) / 100;
+
+  scope.setValue('dtiRatio', ratio);
+  scope.setValue('dtiFlags', ratio > 0.43 ? [`DTI at ${Math.round(ratio * 100)}% exceeds 43%`] : []);
 };
 
 const verifyEmployment = (scope: ScopeFacade) => {
   const { employmentType, employmentYears } = scope.getValue('app') as any;
   const verified = employmentType !== 'self-employed' || employmentYears >= 2;
+
   scope.setValue('employmentVerified', verified);
-  scope.setValue('employmentFlags',
-    !verified ? [`${employmentType}, ${employmentYears}yr < 2yr minimum`] : []);
+  scope.setValue('employmentFlags', !verified
+    ? [`${employmentType}, ${employmentYears}yr < 2yr minimum`] : []);
 };
 
 const assessRisk = (scope: ScopeFacade) => {
-  const creditTier = scope.getValue('creditTier') as string;
-  const dtiStatus = scope.getValue('dtiStatus') as string;
+  const tier = scope.getValue('creditTier') as string;
+  const ratio = scope.getValue('dtiRatio') as number;
   const verified = scope.getValue('employmentVerified') as boolean;
-  const riskTier = (!verified || dtiStatus === 'excessive' || creditTier === 'poor')
-    ? 'high' : 'low';
-  scope.setValue('riskTier', riskTier);
-  scope.setValue('riskFactors', [/* collected flags */]);
+
+  scope.setValue('riskTier', (!verified || ratio > 0.43 || tier === 'poor') ? 'high' : 'low');
 };
 
+// Deciders return a branch ID — the only stage that needs a return value
 const loanDecider = (scope: ScopeFacade): string => {
   const tier = scope.getValue('riskTier') as string;
-  return tier === 'low' ? 'approved' : tier === 'high' ? 'rejected' : 'manual-review';
+  if (tier === 'low') return 'approved';
+  if (tier === 'high') return 'rejected';
+  return 'manual-review';
 };
 
-// ── Build the flow ─────────────────────────────────────────────────────
+// ── Build → Run → Narrative (D3-style chaining) ──────────────────────
 
-const chart = new FlowChartBuilder()
+const chart = flowChart('ReceiveApplication', receiveApplication)
   .setEnableNarrative()
-  .start('ReceiveApplication', receiveApplication)
   .addFunction('PullCreditReport', pullCreditReport)
   .addFunction('CalculateDTI', calculateDTI)
   .addFunction('VerifyEmployment', verifyEmployment)
   .addFunction('AssessRisk', assessRisk)
   .addDeciderFunction('LoanDecision', loanDecider as any)
-    .addFunctionBranch('approved', 'ApproveApplication', () => {})
-    .addFunctionBranch('rejected', 'RejectApplication', () => {})
+    .addFunctionBranch('approved', 'Approve', () => {})
+    .addFunctionBranch('rejected', 'Reject', () => {})
     .addFunctionBranch('manual-review', 'ManualReview', () => {})
     .setDefault('manual-review')
     .end()
   .build();
 
-// ── Run and get the narrative ──────────────────────────────────────────
-
 const executor = new FlowChartExecutor(chart, toScopeFactory(ScopeFacade));
 await executor.run();
 
@@ -647,9 +681,70 @@ Measured on Node v22, Apple Silicon. Run `npm run bench` to reproduce.
 
 ---
 
+## Contract & OpenAPI
+
+Define I/O schemas on your flowchart and auto-generate OpenAPI 3.1 specs:
+
+```typescript
+import { flowChart, defineContract } from 'footprintjs';
+import { z } from 'zod';  // optional — raw JSON Schema also works
+
+const chart = flowChart('ProcessLoan', receiveFn)
+  .addFunction('Assess', assessFn)
+  .addDeciderFunction('Decide', deciderFn)
+    .addFunctionBranch('approved', 'Approve', approveFn)
+    .addFunctionBranch('rejected', 'Reject', rejectFn)
+    .end()
+  .build();
+
+// Define the contract — accepts Zod or raw JSON Schema
+const contract = defineContract(chart, {
+  inputSchema: z.object({
+    applicantName: z.string(),
+    creditScore: z.number(),
+  }),
+  outputSchema: z.object({
+    decision: z.enum(['approved', 'rejected']),
+    reason: z.string(),
+  }),
+  outputMapper: (scope) => ({
+    decision: scope.decision as string,
+    reason: scope.reason as string,
+  }),
+});
+
+// Auto-generate OpenAPI 3.1 spec
+const spec = contract.toOpenAPI({ version: '1.0.0', basePath: '/api' });
+// → { openapi: '3.1.0', paths: { '/api/processloan': { post: { ... } } }, ... }
+```
+
+Schemas can also be set at build time:
+
+```typescript
+const chart = flowChart('Greet', greetFn)
+  .setInputSchema(z.object({ name: z.string() }))
+  .setOutputSchema(z.object({ greeting: z.string() }))
+  .setOutputMapper((scope) => ({ greeting: scope.message as string }))
+  .build();
+```
+
+Zod is an **optional peer dependency** — zero bundle impact if not used. Pass raw JSON Schema instead:
+
+```typescript
+const contract = defineContract(chart, {
+  inputSchema: {
+    type: 'object',
+    properties: { name: { type: 'string' } },
+    required: ['name'],
+  },
+});
+```
+
+---
+
 ## Architecture
 
-FootPrint is five independent libraries, each usable standalone:
+FootPrint is six independent libraries, each usable standalone:
 
 ```
 src/lib/
@@ -657,7 +752,8 @@ src/lib/
 ├── builder/   Fluent flowchart DSL (FlowChartBuilder, DeciderList, SelectorFnList)
 ├── scope/     Scope facades, recorders, protection, Zod integration
 ├── engine/    DFS traversal, handlers, narrative generators
-└── runner/    Execution convenience (FlowChartExecutor, ExecutionRuntime)
+├── runner/    Execution convenience (FlowChartExecutor, ExecutionRuntime)
+└── contract/  I/O schemas, Zod→JSON Schema, OpenAPI 3.1 generation
 ```
 
 ---

package/dist/esm/index.js

@@ -24,4 +24,10 @@ export { NarrativeRecorder } from './lib/scope';
 // Zod-based scope definitions
 export { defineScopeFromZod } from './lib/scope';
 export { CombinedNarrativeBuilder } from './lib/engine';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7OztHQVNHO0FBT0gsT0FBTyxFQUFFLFNBQVMsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUU1RCwrRUFBK0U7QUFDL0UsdUNBQXVDO0FBQ3ZDLCtFQUErRTtBQUUvRSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFakQsK0VBQStFO0FBQy9FLDBDQUEwQztBQUMxQywrRUFBK0U7QUFFL0UsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUxQyxZQUFZO0FBQ1osT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM3QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzVDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUtoRCw4QkFBOEI7QUFDOUIsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBT2pELE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGNBQWMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRm9vdFByaW50IOKAlCBQdWJsaWMgQVBJXG4gKlxuICogQ29ubmVjdGVkIGNhdXNhbCB0cmFjZSBsaWJyYXJ5IGZvciBMTE0gcGlwZWxpbmVzLlxuICogQnVpbGRzIGZsb3djaGFydHMsIGV4ZWN1dGVzIHRoZW0gdmlhIERGUyB0cmF2ZXJzYWwsIGFuZCBjYXB0dXJlc1xuICogZXZlcnkgc3RhZ2UncyBjb250ZXh0IChzdGF0ZSwgZGVjaXNpb25zLCBlcnJvcnMpIGluIGFuIGF1ZGl0YWJsZSB0cmFjZS5cbiAqXG4gKiBGb3IgYWR2YW5jZWQvaW50ZXJuYWwgQVBJcyAobWVtb3J5IHByaW1pdGl2ZXMsIGVuZ2luZSBoYW5kbGVycywgcHJvdmlkZXJzKSxcbiAqIGltcG9ydCBmcm9tICdmb290cHJpbnQvYWR2YW5jZWQnLlxuICovXG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEJ1aWxkZXIg4oCUIEZsb3djaGFydCBjb25zdHJ1Y3Rpb25cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHR5cGUgeyBGbG93Q2hhcnQsIFBpcGVsaW5lU3RhZ2VGdW5jdGlvbiBhcyBTdGFnZUhhbmRsZXIsIFN0cmVhbUhhbmRsZXJzIH0gZnJvbSAnLi9saWIvYnVpbGRlcic7XG5leHBvcnQgeyBmbG93Q2hhcnQsIEZsb3dDaGFydEJ1aWxkZXIgfSBmcm9tICcuL2xpYi9idWlsZGVyJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUnVubmVyIOKAlCBFeGVjdXRpb24gY29udmVuaWVuY2UgbGF5ZXJcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHsgRmxvd0NoYXJ0RXhlY3V0b3IgfSBmcm9tICcuL2xpYi9ydW5uZXInO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBTY29wZSDigJQgUGVyLXN0YWdlIGZhY2FkZXMgYW5kIHJlY29yZGVyc1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgeyBTY29wZUZhY2FkZSB9IGZyb20gJy4vbGliL3Njb3BlJztcblxuLy8gUmVjb3JkZXJzXG5leHBvcnQgeyBNZXRyaWNSZWNvcmRlciB9IGZyb20gJy4vbGliL3Njb3BlJztcbmV4cG9ydCB7IERlYnVnUmVjb3JkZXIgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5leHBvcnQgeyBOYXJyYXRpdmVSZWNvcmRlciB9IGZyb20gJy4vbGliL3Njb3BlJztcblxuLy8gUmVjb3JkZXIgaW50ZXJmYWNlIGFuZCBjb3JlIGV2ZW50IHR5cGVzIChuZWVkZWQgdG8gaW1wbGVtZW50IGN1c3RvbSBSZWNvcmRlcilcbmV4cG9ydCB0eXBlIHsgQ29tbWl0RXZlbnQsIEVycm9yRXZlbnQsIFJlYWRFdmVudCwgUmVjb3JkZXIsIFdyaXRlRXZlbnQgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5cbi8vIFpvZC1iYXNlZCBzY29wZSBkZWZpbml0aW9uc1xuZXhwb3J0IHsgZGVmaW5lU2NvcGVGcm9tWm9kIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBFbmdpbmUg4oCUIE5hcnJhdGl2ZSAoY29tbW9ubHkgdXNlZClcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHR5cGUgeyBDb21iaW5lZE5hcnJhdGl2ZUVudHJ5IH0gZnJvbSAnLi9saWIvZW5naW5lJztcbmV4cG9ydCB7IENvbWJpbmVkTmFycmF0aXZlQnVpbGRlciB9IGZyb20gJy4vbGliL2VuZ2luZSc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIE1lbW9yeSDigJQgU2NvcGVGYWN0b3J5IHR5cGUgKG5lZWRlZCBmb3IgRmxvd0NoYXJ0RXhlY3V0b3IgY29uc3RydWN0b3IpXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB0eXBlIHsgUnVuT3B0aW9ucyB9IGZyb20gJy4vbGliL2VuZ2luZSc7XG5leHBvcnQgdHlwZSB7IFNjb3BlRmFjdG9yeSB9IGZyb20gJy4vbGliL21lbW9yeSc7XG4iXX0=
+// ============================================================================
+// Contract — I/O boundary, schemas, and OpenAPI generation
+// ============================================================================
+export { defineContract } from './lib/contract';
+export { normalizeSchema, zodToJsonSchema } from './lib/contract';
+export { generateOpenAPI } from './lib/contract';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7OztHQVNHO0FBT0gsT0FBTyxFQUFFLFNBQVMsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUU1RCwrRUFBK0U7QUFDL0UsdUNBQXVDO0FBQ3ZDLCtFQUErRTtBQUUvRSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFakQsK0VBQStFO0FBQy9FLDBDQUEwQztBQUMxQywrRUFBK0U7QUFFL0UsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUxQyxZQUFZO0FBQ1osT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM3QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzVDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUtoRCw4QkFBOEI7QUFDOUIsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBT2pELE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQVN4RCwrRUFBK0U7QUFDL0UsMkRBQTJEO0FBQzNELCtFQUErRTtBQUUvRSxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDaEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxlQUFlLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNsRSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sZ0JBQWdCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEZvb3RQcmludCDigJQgUHVibGljIEFQSVxuICpcbiAqIENvbm5lY3RlZCBjYXVzYWwgdHJhY2UgbGlicmFyeSBmb3IgTExNIHBpcGVsaW5lcy5cbiAqIEJ1aWxkcyBmbG93Y2hhcnRzLCBleGVjdXRlcyB0aGVtIHZpYSBERlMgdHJhdmVyc2FsLCBhbmQgY2FwdHVyZXNcbiAqIGV2ZXJ5IHN0YWdlJ3MgY29udGV4dCAoc3RhdGUsIGRlY2lzaW9ucywgZXJyb3JzKSBpbiBhbiBhdWRpdGFibGUgdHJhY2UuXG4gKlxuICogRm9yIGFkdmFuY2VkL2ludGVybmFsIEFQSXMgKG1lbW9yeSBwcmltaXRpdmVzLCBlbmdpbmUgaGFuZGxlcnMsIHByb3ZpZGVycyksXG4gKiBpbXBvcnQgZnJvbSAnZm9vdHByaW50L2FkdmFuY2VkJy5cbiAqL1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBCdWlsZGVyIOKAlCBGbG93Y2hhcnQgY29uc3RydWN0aW9uXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB0eXBlIHsgRmxvd0NoYXJ0LCBQaXBlbGluZVN0YWdlRnVuY3Rpb24gYXMgU3RhZ2VIYW5kbGVyLCBTdHJlYW1IYW5kbGVycyB9IGZyb20gJy4vbGliL2J1aWxkZXInO1xuZXhwb3J0IHsgZmxvd0NoYXJ0LCBGbG93Q2hhcnRCdWlsZGVyIH0gZnJvbSAnLi9saWIvYnVpbGRlcic7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFJ1bm5lciDigJQgRXhlY3V0aW9uIGNvbnZlbmllbmNlIGxheWVyXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IEZsb3dDaGFydEV4ZWN1dG9yIH0gZnJvbSAnLi9saWIvcnVubmVyJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gU2NvcGUg4oCUIFBlci1zdGFnZSBmYWNhZGVzIGFuZCByZWNvcmRlcnNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHsgU2NvcGVGYWNhZGUgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5cbi8vIFJlY29yZGVyc1xuZXhwb3J0IHsgTWV0cmljUmVjb3JkZXIgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5leHBvcnQgeyBEZWJ1Z1JlY29yZGVyIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuZXhwb3J0IHsgTmFycmF0aXZlUmVjb3JkZXIgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5cbi8vIFJlY29yZGVyIGludGVyZmFjZSBhbmQgY29yZSBldmVudCB0eXBlcyAobmVlZGVkIHRvIGltcGxlbWVudCBjdXN0b20gUmVjb3JkZXIpXG5leHBvcnQgdHlwZSB7IENvbW1pdEV2ZW50LCBFcnJvckV2ZW50LCBSZWFkRXZlbnQsIFJlY29yZGVyLCBXcml0ZUV2ZW50IH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyBab2QtYmFzZWQgc2NvcGUgZGVmaW5pdGlvbnNcbmV4cG9ydCB7IGRlZmluZVNjb3BlRnJvbVpvZCB9IGZyb20gJy4vbGliL3Njb3BlJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gRW5naW5lIOKAlCBOYXJyYXRpdmUgKGNvbW1vbmx5IHVzZWQpXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB0eXBlIHsgQ29tYmluZWROYXJyYXRpdmVFbnRyeSB9IGZyb20gJy4vbGliL2VuZ2luZSc7XG5leHBvcnQgeyBDb21iaW5lZE5hcnJhdGl2ZUJ1aWxkZXIgfSBmcm9tICcuL2xpYi9lbmdpbmUnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBNZW1vcnkg4oCUIFNjb3BlRmFjdG9yeSB0eXBlIChuZWVkZWQgZm9yIEZsb3dDaGFydEV4ZWN1dG9yIGNvbnN0cnVjdG9yKVxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgdHlwZSB7IFJ1bk9wdGlvbnMgfSBmcm9tICcuL2xpYi9lbmdpbmUnO1xuZXhwb3J0IHR5cGUgeyBTY29wZUZhY3RvcnkgfSBmcm9tICcuL2xpYi9tZW1vcnknO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBDb250cmFjdCDigJQgSS9PIGJvdW5kYXJ5LCBzY2hlbWFzLCBhbmQgT3BlbkFQSSBnZW5lcmF0aW9uXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IGRlZmluZUNvbnRyYWN0IH0gZnJvbSAnLi9saWIvY29udHJhY3QnO1xuZXhwb3J0IHsgbm9ybWFsaXplU2NoZW1hLCB6b2RUb0pzb25TY2hlbWEgfSBmcm9tICcuL2xpYi9jb250cmFjdCc7XG5leHBvcnQgeyBnZW5lcmF0ZU9wZW5BUEkgfSBmcm9tICcuL2xpYi9jb250cmFjdCc7XG5leHBvcnQgdHlwZSB7XG4gIEZsb3dDaGFydENvbnRyYWN0LFxuICBGbG93Q2hhcnRDb250cmFjdE9wdGlvbnMsXG4gIEpzb25TY2hlbWEsXG4gIE9wZW5BUElPcHRpb25zLFxuICBPcGVuQVBJU3BlYyxcbn0gZnJvbSAnLi9saWIvY29udHJhY3QnO1xuIl19