@farmslot/recipe-cli 0.1.0

package/dist/render.js

@@ -0,0 +1,165 @@
+export function renderLibraries(libraries, rules) {
+    const lines = ['Libraries (precedence order):'];
+    if (libraries.length === 0)
+        lines.push('  none. Set RECIPE_LIBRARY_PATH=name=path or pass --library.');
+    for (const library of libraries) {
+        const override = library.overrides ? ` overrides env ${library.overrides}` : '';
+        lines.push(`  ${library.rank}. ${library.name} (${library.origin}${override}) ${library.root}`, `     digest ${library.digest}${library.platforms.length ? ` · platforms ${library.platforms.join(',')}` : ''}`);
+        for (const [id, adapter] of Object.entries(library.adapters))
+            lines.push(`     adapter ${id} → ${adapter.module} (declared, not loaded)`);
+        for (const requirement of library.requires)
+            lines.push(`     requires ${requirement.package} ${requirement.range}: ok (${requirement.installed})`);
+    }
+    if (rules)
+        lines.push('Precedence:', ...rules.map((rule) => `  - ${rule}`));
+    return lines;
+}
+export function renderList(recipes, platform, platforms) {
+    const lines = [
+        '',
+        `Recipes (${platform ? `platform ${platform}` : `all platforms: ${platforms.join(', ') || 'none'}`}) (${recipes.length})`,
+    ];
+    for (const recipe of recipes) {
+        const state = recipe.runnable === null ? 'needs --platform' : recipe.runnable ? 'runnable' : 'incomplete';
+        const shadows = recipe.shadows.length ? ` shadows=${recipe.shadows.join(',')}` : '';
+        lines.push(`  ${recipe.ref}  [${recipe.source} · ${recipe.file}] ${state}${shadows}`);
+        if (recipe.description)
+            lines.push(`    ${firstSentence(recipe.description)}`);
+        if (recipe.variants.length > 1 || recipe.variants[0]?.platform)
+            lines.push(`    variants: ${recipe.variants.map((variant) => variant.platform ?? 'generic').join(', ')}`);
+    }
+    return lines;
+}
+export function renderActions(actions, platform) {
+    const lines = [
+        '',
+        `Actions (${platform ? `platform ${platform}` : 'all platforms'}) (${actions.length})`,
+    ];
+    for (const action of actions) {
+        const owner = action.source ?? (action.declared ? 'runner' : 'undeclared');
+        const fields = action.parameters.map((parameter) => parameter.name);
+        const scopes = action.platforms.length ? ` · ${action.platforms.join(',')}` : '';
+        lines.push(`  ${action.name}  [${owner}${scopes}] handler=${action.handler}${fields.length ? ` fields=${fields.join(',')}` : ''}${action.capabilities.length ? ` risk=${action.capabilities.join(',')}` : ''}`);
+        if (action.description)
+            lines.push(`    ${firstSentence(action.description)}`);
+    }
+    if (actions.some((action) => !action.declared))
+        lines.push('undeclared: this CLI has a handler, but no library manifest declares the action yet.');
+    return lines;
+}
+export function renderDescribeRecipe(recipe) {
+    return [
+        `recipe ${recipe.ref}${recipe.title ? ` — ${recipe.title}` : ''}`,
+        ...(recipe.description ? [`  ${recipe.description}`] : []),
+        `  id: ${recipe.id} (resolved by ${recipe.resolvedBy})`,
+        `  source: ${recipe.source} · ${recipe.file}${recipe.variant ? ` · variant ${recipe.variant}` : ''}`,
+        ...(recipe.shadows.length ? [`  shadows: ${recipe.shadows.join(', ')}`] : []),
+        `  variants: ${recipe.variants.map((variant) => `${variant.platform ?? 'generic'} (${variant.source})`).join(', ') || 'none'}`,
+        `  runnable: ${recipe.runnable === null ? 'pick a --platform' : recipe.runnable ? 'yes' : 'no'}`,
+        ...recipe.problems.map((problem) => `    ${problem.code}: ${problem.message}`),
+        ...renderParameters(recipe.parameters),
+        ...renderNames('actions', recipe.actions),
+        ...renderNames('called recipes', recipe.nestedRecipes),
+        ...(recipe.unresolvedRecipes.length
+            ? renderNames('unresolved recipes', recipe.unresolvedRecipes)
+            : []),
+        ...renderNames('callers', recipe.callers),
+        `  Run: ${recipe.runCommand}`,
+    ];
+}
+export function renderDescribeAction(action) {
+    return [
+        `action ${action.name} (${action.kind})`,
+        ...(action.description ? [`  ${action.description}`] : []),
+        `  source: ${action.source ?? 'not declared by any library'}${action.manifest ? ` · ${action.manifest}` : ''}`,
+        ...(action.shadows.length ? [`  shadows: ${action.shadows.join(', ')}`] : []),
+        `  platforms: ${action.platforms.join(', ') || 'none'}`,
+        `  handler: ${action.handler}`,
+        `  capabilities: ${action.capabilities.join(', ') || 'none'}`,
+        ...renderParameters(action.parameters),
+        ...renderNames('result cases', action.resultCases),
+        ...(action.examples.length
+            ? [
+                '  example:',
+                ...JSON.stringify(action.examples[0], null, 2)
+                    .split('\n')
+                    .map((line) => `    ${line}`),
+            ]
+            : []),
+        ...renderNames('callers', action.callers),
+    ];
+}
+export function renderExplain(envelope) {
+    const lines = [
+        `explain ${envelope.recipe.ref}${envelope.platform ? ` (platform ${envelope.platform})` : ''}`,
+    ];
+    const visit = (recipe, depth) => {
+        const pad = '  '.repeat(depth);
+        lines.push(`${pad}${recipe.ref} [${recipe.source} · ${recipe.file}${recipe.variant ? ` · ${recipe.variant}` : ''}]`);
+        for (const parameter of recipe.parameters) {
+            const value = parameter.from === 'missing' ? 'MISSING' : (JSON.stringify(parameter.value) ?? 'undefined');
+            const template = parameter.template ? ` ← ${parameter.template}` : '';
+            lines.push(`${pad}  param ${parameter.name} = ${value} (${parameter.from}${template})`);
+        }
+        for (const node of recipe.nodes) {
+            const phase = node.phase === 'main' ? '' : ` (${node.phase})`;
+            if (node.kind === 'action') {
+                if (node.action !== 'end')
+                    lines.push(`${pad}  #${node.nodeId} ${node.action}${phase}`);
+                continue;
+            }
+            lines.push(`${pad}  #${node.nodeId} call ${node.ref}${phase}${node.recipe ? '' : ' UNRESOLVED'}`);
+            if (node.recipe)
+                visit(node.recipe, depth + 2);
+        }
+    };
+    visit(envelope.recipe, 1);
+    lines.push(`Required actions (${envelope.requiredActions.length}):`);
+    for (const action of envelope.requiredActions) {
+        lines.push(`  ${action.name} ${action.declared ? `[${action.source ?? 'runner'}] handler=${action.handler}` : 'NOT DECLARED'}${action.capabilities.length ? ` risk=${action.capabilities.join(',')}` : ''}`);
+    }
+    lines.push(`Capabilities: ${envelope.capabilities.join(', ') || 'none'}`);
+    const missing = envelope.missing;
+    const gaps = [
+        ...missing.parameters.map((entry) => `parameter ${entry.recipe}.${entry.name}`),
+        ...missing.recipes.map((entry) => `recipe ${entry.ref} (from ${entry.from})`),
+        ...missing.actions.map((entry) => `action ${entry.name}`),
+        ...missing.problems.map((problem) => `${problem.code}: ${problem.message}`),
+    ];
+    lines.push(`Missing: ${gaps.length ? '' : 'none'}`, ...gaps.map((gap) => `  ${gap}`));
+    if (missing.handlers.length)
+        lines.push(`Handled by a platform adapter (not loaded here): ${missing.handlers.join(', ')}`);
+    return lines;
+}
+export function renderSearch(results, query) {
+    if (results.length === 0)
+        return [`No action or recipe matches "${query}".`];
+    return results.map((result) => `${result.kind.padEnd(6)} ${result.name}  [${result.source ?? 'not declared'}]${result.description ? ` — ${firstSentence(result.description)}` : ''}`);
+}
+function renderParameters(parameters) {
+    if (parameters.length === 0)
+        return ['  parameters: none'];
+    return [
+        `  parameters (${parameters.length}):`,
+        ...parameters.map((parameter) => {
+            const type = parameter.type ? ` (${parameter.type})` : '';
+            const required = parameter.required ? ' required' : '';
+            const defaultValue = Object.hasOwn(parameter, 'default')
+                ? ` default=${JSON.stringify(parameter.default)}`
+                : '';
+            const choices = parameter.enum ? ` choices=${JSON.stringify(parameter.enum)}` : '';
+            const description = parameter.description ? ` — ${parameter.description}` : '';
+            return `    ${parameter.name}${type}${required}${defaultValue}${choices}${description}`;
+        }),
+    ];
+}
+function renderNames(label, names) {
+    if (names.length === 0)
+        return [`  ${label}: none`];
+    return [`  ${label} (${names.length}):`, ...names.map((name) => `    ${name}`)];
+}
+function firstSentence(text) {
+    const sentence = /^.*?[.!?](?:\s|$)/u.exec(text)?.[0]?.trim() ?? text;
+    return sentence.length <= 160 ? sentence : `${sentence.slice(0, 157).trimEnd()}…`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedLibraryRecipe } from '@farmslot/recipe-harness';
+import { type RecipeDiscoveryIndex } from './discovery-index.js';
+import type { SearchResult } from './types.js';
+/** Rank actions and recipes by id, parameter names and description; every term must match. */
+export declare function searchIndex(index: RecipeDiscoveryIndex, query: string, 
+/** Shadowed library recipes, searchable by their `<library>.<ref>` id. */
+shadowed?: readonly ResolvedLibraryRecipe[]): SearchResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAe,KAAK,oBAAoB,EAAiB,MAAM,sBAAsB,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY/C,8FAA8F;AAC9F,wBAAgB,WAAW,CACzB,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM;AACb,0EAA0E;AAC1E,QAAQ,GAAE,SAAS,qBAAqB,EAAO,GAC9C,YAAY,EAAE,CAwDhB"}

package/dist/search.js

@@ -0,0 +1,90 @@
+import { levenshtein, recipeSummary } from './discovery-index.js';
+/** Rank actions and recipes by id, parameter names and description; every term must match. */
+export function searchIndex(index, query, 
+/** Shadowed library recipes, searchable by their `<library>.<ref>` id. */
+shadowed = []) {
+    const terms = searchTerms(query);
+    if (terms.length === 0)
+        return [];
+    const entries = [
+        ...[...index.actions.values()].map((action) => ({
+            kind: 'action',
+            name: action.name,
+            source: action.source,
+            description: action.description,
+            fields: action.parameters.map((parameter) => parameter.name),
+        })),
+        ...[...index.recipes.values()].map((recipe) => ({
+            kind: 'recipe',
+            name: recipe.ref,
+            id: recipe.id,
+            source: recipe.source,
+            description: [recipe.title, recipe.description].filter(Boolean).join(' '),
+            fields: recipe.parameters.map((parameter) => parameter.name),
+        })),
+        ...shadowed.map((record) => {
+            const recipe = recipeSummary(record);
+            return {
+                kind: 'recipe',
+                name: recipe.ref,
+                id: recipe.id,
+                source: recipe.source,
+                description: [recipe.title, recipe.description].filter(Boolean).join(' '),
+                fields: recipe.parameters.map((parameter) => parameter.name),
+            };
+        }),
+    ];
+    return entries
+        .map((entry) => {
+        const scores = terms.map((term) => Math.max(termScore(entry.name, entry, term), entry.id ? termScore(entry.id, entry, term) : 0));
+        return { entry, scores, score: scores.reduce((total, value) => total + value, 0) };
+    })
+        .filter(({ scores }) => scores.every((value) => value > 0))
+        .sort((left, right) => right.score - left.score ||
+        left.entry.kind.localeCompare(right.entry.kind) ||
+        left.entry.name.localeCompare(right.entry.name))
+        .map(({ entry, score }) => ({
+        kind: entry.kind,
+        name: entry.name,
+        ...(entry.id ? { id: entry.id } : {}),
+        score,
+        source: entry.source,
+        description: entry.description,
+    }));
+}
+function termScore(label, entry, term) {
+    const name = label.toLowerCase();
+    const segment = name.split('.').pop() ?? name;
+    const domain = name.includes('.') ? name.split('.')[0] : '';
+    const nameTerms = searchTerms(name.replaceAll('.', ' ').replaceAll('_', ' '));
+    const fields = entry.fields.map((field) => field.toLowerCase());
+    if (name === term)
+        return 120;
+    if (segment === term)
+        return 110;
+    if (domain === term)
+        return 100;
+    if (fields.includes(term))
+        return 90;
+    if (nameTerms.includes(term))
+        return 80;
+    if (name.includes(term))
+        return 70;
+    if (fields.some((field) => field.includes(term)))
+        return 60;
+    if (entry.description.toLowerCase().includes(term))
+        return 50;
+    if ([...nameTerms, ...fields].some((candidate) => fuzzyMatch(term, candidate)))
+        return 40;
+    return 0;
+}
+function fuzzyMatch(term, candidate) {
+    if (term.length < 4 || candidate.length < 4)
+        return false;
+    const threshold = Math.max(1, Math.floor(Math.max(term.length, candidate.length) / 4));
+    return levenshtein(term, candidate) <= threshold;
+}
+function searchTerms(value) {
+    return value.toLowerCase().match(/[a-z0-9]+/gu) ?? [];
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,12 @@
+import type { IndexedAction } from './discovery-index.js';
+import type { DiscoveryParameter } from './types.js';
+/** A workflow node for an action: its first authored example, else one built from the schema. */
+export declare function actionTemplateNode(action: IndexedAction): Record<string, unknown>;
+/** A `call` node for a recipe with every required parameter that has no default. */
+export declare function recipeTemplateNode(ref: string, parameters: readonly DiscoveryParameter[]): Record<string, unknown>;
+/** A complete recipe wrapping one node, ready to save as `<name>.recipe.json`. */
+export declare function recipeSkeleton(title: string, node: Record<string, unknown>): Record<string, unknown>;
+/** Command-line assignments for required parameters without defaults. */
+export declare function requiredAssignments(parameters: readonly DiscoveryParameter[]): string[];
+export declare function shellQuote(value: string): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBjF;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,SAAS,kBAAkB,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAIvF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/template.js

@@ -0,0 +1,74 @@
+import { isRecord, RECIPE_PROTOCOL_SCHEMA_URL } from '@farmslot/protocol';
+const STEP_ID = 'step';
+const DONE_ID = 'done';
+/** A workflow node for an action: its first authored example, else one built from the schema. */
+export function actionTemplateNode(action) {
+    const example = action.examples.find(isRecord);
+    const fields = example
+        ? Object.fromEntries(Object.entries(example).filter(([key]) => !['action', 'intent', 'next'].includes(key)))
+        : Object.fromEntries(action.parameters
+            .filter((parameter) => parameter.required)
+            .map((parameter) => [parameter.name, placeholder(parameter)]));
+    return {
+        action: action.name,
+        intent: typeof example?.intent === 'string'
+            ? example.intent
+            : `TODO: why this ${action.name} step runs`,
+        ...fields,
+        next: DONE_ID,
+    };
+}
+/** A `call` node for a recipe with every required parameter that has no default. */
+export function recipeTemplateNode(ref, parameters) {
+    const params = Object.fromEntries(parameters
+        .filter((parameter) => parameter.required && !Object.hasOwn(parameter, 'default'))
+        .map((parameter) => [parameter.name, placeholder(parameter)]));
+    return {
+        action: 'call',
+        ref,
+        intent: `TODO: why this recipe calls ${ref}`,
+        ...(Object.keys(params).length > 0 ? { params } : {}),
+        next: DONE_ID,
+    };
+}
+/** A complete recipe wrapping one node, ready to save as `<name>.recipe.json`. */
+export function recipeSkeleton(title, node) {
+    return {
+        $schema: RECIPE_PROTOCOL_SCHEMA_URL,
+        title,
+        description: 'TODO: what this recipe proves.',
+        workflow: {
+            entry: STEP_ID,
+            nodes: {
+                [STEP_ID]: node,
+                [DONE_ID]: { action: 'end', status: 'pass' },
+            },
+        },
+    };
+}
+/** Command-line assignments for required parameters without defaults. */
+export function requiredAssignments(parameters) {
+    return parameters
+        .filter((parameter) => parameter.required && !Object.hasOwn(parameter, 'default'))
+        .map((parameter) => `${parameter.name}=${shellQuote(assignmentValue(placeholder(parameter)))}`);
+}
+export function shellQuote(value) {
+    return /^[A-Za-z0-9_./:=@%+-]+$/u.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+function placeholder(parameter) {
+    if (parameter.enum && parameter.enum.length > 0)
+        return parameter.enum[0];
+    if (parameter.type === 'boolean')
+        return false;
+    if (parameter.type === 'number' || parameter.type === 'integer')
+        return 0;
+    if (parameter.type === 'array')
+        return [];
+    if (parameter.type === 'object')
+        return {};
+    return `<${parameter.name}>`;
+}
+function assignmentValue(value) {
+    return typeof value === 'string' ? value : JSON.stringify(value);
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAK1E,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,OAAO,GAAG,MAAM,CAAC;AAEvB,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CACvF;QACH,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,UAAU;aACd,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;aACzC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAChE,CAAC;IACN,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,MAAM,EACJ,OAAO,OAAO,EAAE,MAAM,KAAK,QAAQ;YACjC,CAAC,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,kBAAkB,MAAM,CAAC,IAAI,YAAY;QAC/C,GAAG,MAAM;QACT,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,UAAyC;IAEzC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,UAAU;SACP,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;SACjF,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAChE,CAAC;IACF,OAAO;QACL,MAAM,EAAE,MAAM;QACd,GAAG;QACH,MAAM,EAAE,+BAA+B,GAAG,EAAE;QAC5C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,IAA6B;IAE7B,OAAO;QACL,OAAO,EAAE,0BAA0B;QACnC,KAAK;QACL,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO;YACd,KAAK,EAAE;gBACL,CAAC,OAAO,CAAC,EAAE,IAAI;gBACf,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7C;SACF;KACF,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,UAAyC;IAC3E,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;SACjF,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,SAA6B;IAChD,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAC1C,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC;AAC/B,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}