cngkit 1.1.16 → 1.1.18

package/dist/commands/knowledges/files.js

@@ -1,17 +1,17 @@
 import {
   runKnowFilesCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   JsonOutputOptionsSchema,
   OptionalQueryArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/files.tsx

package/dist/commands/knowledges/glob.js

@@ -1,17 +1,17 @@
 import {
   runKnowGlobCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   LimitOptionsSchema,
   OptionalGlobPatternArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/glob.tsx

package/dist/commands/knowledges/grep.js

@@ -1,17 +1,17 @@
 import {
   runKnowGrepCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   LimitOptionsSchema,
   RequiredPatternArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/grep.tsx

package/dist/commands/knowledges/index.js

@@ -1,13 +1,13 @@
 import {
   formatKnowledgesHelp
-} from "../../chunk-GZ2DPIU6.js";
+} from "../../chunk-KSW6QT5Q.js";
 import {
   GlobalOptionsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/index.tsx

package/dist/commands/knowledges/list.js

@@ -1,17 +1,17 @@
 import {
   runKnowListCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   LimitOptionsSchema,
   OptionalQueryArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/list.tsx

package/dist/commands/knowledges/ls.js

@@ -0,0 +1,31 @@
+import {
+  runKnowLsCommand
+} from "../../chunk-C7HFDK4S.js";
+import "../../chunk-XQGLUQFM.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
+import {
+  LimitOptionsSchema,
+  OptionalPathArgsSchema
+} from "../../chunk-ZA4YOWPB.js";
+import {
+  CommandRunner
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
+import "../../chunk-PZ5AY32C.js";
+
+// src/commands/knowledges/ls.tsx
+import { jsx } from "react/jsx-runtime";
+var description = "List remote catalog directory entries";
+var args = OptionalPathArgsSchema;
+var options = LimitOptionsSchema;
+function LsCommand({ args: args2, options: options2 }) {
+  return /* @__PURE__ */ jsx(CommandRunner, { run: (output) => runKnowLsCommand(args2[0], options2, output) });
+}
+export {
+  args,
+  LsCommand as default,
+  description,
+  options
+};
+//# sourceMappingURL=ls.js.map

package/dist/commands/knowledges/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/knowledges/ls.tsx"],"sourcesContent":["import { LimitOptionsSchema, OptionalPathArgsSchema } from \"../../cli/options.js\";\nimport { runKnowLsCommand, type KnowLsCommandOptions } from \"../../features/knowledges/run-knowledges-command.js\";\nimport { CommandRunner } from \"../../cli/command-runner.js\";\n\nexport const description = \"List remote catalog directory entries\";\nexport const args = OptionalPathArgsSchema;\nexport const options = LimitOptionsSchema;\n\ntype LsCommandProps = {\n  readonly args: [string?];\n  readonly options: KnowLsCommandOptions;\n};\n\nexport default function LsCommand({ args, options }: LsCommandProps) {\n  return <CommandRunner run={(output) => runKnowLsCommand(args[0], options, output)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcS;AAVF,IAAM,cAAc;AACpB,IAAM,OAAO;AACb,IAAM,UAAU;AAOR,SAAR,UAA2B,EAAE,MAAAA,OAAM,SAAAC,SAAQ,GAAmB;AACnE,SAAO,oBAAC,iBAAc,KAAK,CAAC,WAAW,iBAAiBD,MAAK,CAAC,GAAGC,UAAS,MAAM,GAAG;AACrF;","names":["args","options"]}

package/dist/commands/knowledges/read.js

@@ -1,17 +1,17 @@
 import {
   runKnowReadCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   JsonOutputOptionsSchema,
   RequiredFilePathArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/read.tsx

package/dist/commands/knowledges/search.js

@@ -1,17 +1,17 @@
 import {
   runKnowSearchCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   LimitOptionsSchema,
   RequiredQueryArgsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/search.tsx

package/dist/commands/knowledges/status.js

@@ -1,16 +1,16 @@
 import {
   runKnowStatusCommand
-} from "../../chunk-NRWEU6YQ.js";
+} from "../../chunk-C7HFDK4S.js";
 import "../../chunk-XQGLUQFM.js";
-import "../../chunk-GZ2DPIU6.js";
-import "../../chunk-MJVMVXV5.js";
+import "../../chunk-KSW6QT5Q.js";
+import "../../chunk-FJ34NVQ4.js";
 import {
   JsonOutputOptionsSchema
-} from "../../chunk-MLKBG5YJ.js";
+} from "../../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../../chunk-W7X6HWP5.js";
-import "../../chunk-7KQBSEQV.js";
+} from "../../chunk-TWQDLZ6F.js";
+import "../../chunk-CBIVTEZP.js";
 import "../../chunk-PZ5AY32C.js";
 
 // src/commands/knowledges/status.tsx

package/dist/commands/login.js

@@ -1,12 +1,12 @@
 import {
   GlobalOptionsSchema
-} from "../chunk-MLKBG5YJ.js";
+} from "../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../chunk-W7X6HWP5.js";
+} from "../chunk-TWQDLZ6F.js";
 import {
   resolveApiBaseUrl
-} from "../chunk-7KQBSEQV.js";
+} from "../chunk-CBIVTEZP.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/shared/browser.ts

package/dist/commands/scrub.js

@@ -1,11 +1,11 @@
 import {
   GlobalOptionsSchema,
   OptionalPathArgsSchema
-} from "../chunk-MLKBG5YJ.js";
+} from "../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../chunk-W7X6HWP5.js";
-import "../chunk-7KQBSEQV.js";
+} from "../chunk-TWQDLZ6F.js";
+import "../chunk-CBIVTEZP.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/scrub.tsx

package/dist/commands/transcripts.js

@@ -7,15 +7,15 @@ import {
 } from "../chunk-XQGLUQFM.js";
 import {
   formatCngkitHelp
-} from "../chunk-GZ2DPIU6.js";
+} from "../chunk-KSW6QT5Q.js";
 import {
   GlobalOptionsSchema,
   TranscriptArgsSchema
-} from "../chunk-MLKBG5YJ.js";
+} from "../chunk-ZA4YOWPB.js";
 import {
   CommandRunner
-} from "../chunk-W7X6HWP5.js";
-import "../chunk-7KQBSEQV.js";
+} from "../chunk-TWQDLZ6F.js";
+import "../chunk-CBIVTEZP.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/commands/transcripts.tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cngkit",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "description": "Opinionated Curly.ng CLI kit for Coderoom collaboration and website tooling.",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "format": "prettier --write README.md src tsconfig.json tsup.config.ts package.json",
     "lint": "eslint src",
     "prepublishOnly": "pnpm run build && pnpm run smoke",
-    "smoke": "node dist/cli.js --help && node dist/cli.js --version && node dist/cli.js help && node dist/cli.js help knowledges && node dist/cli.js help coderoom && node dist/cli.js help transcripts && node dist/cli.js login --help && node dist/cli.js coderoom --help && node dist/cli.js coderoom share --help && node dist/cli.js coderoom join --help && node dist/cli.js scrub --help && node dist/cli.js transcripts --help && node dist/cli.js knowledges --help && node dist/cli.js knowledges audiences --help && node dist/cli.js knowledges search --help && node dist/cli.js knowledges read --help && node dist/cli.js knowledges grep --help && node dist/cli.js knowledges glob --help && node dist/cli.js knowledges list --help && node dist/cli.js knowledges files --help && node dist/cli.js knowledges status --help",
+    "smoke": "node dist/cli.js --help && node dist/cli.js --version && node dist/cli.js help && node dist/cli.js help knowledges && node dist/cli.js help coderoom && node dist/cli.js help transcripts && node dist/cli.js help hookify && node dist/cli.js login --help && node dist/cli.js coderoom --help && node dist/cli.js coderoom share --help && node dist/cli.js coderoom join --help && node dist/cli.js scrub --help && node dist/cli.js transcripts --help && node dist/cli.js hookify --help && node dist/cli.js hookify ingest --help && node dist/cli.js knowledges --help && node dist/cli.js knowledges audiences --help && node dist/cli.js knowledges search --help && node dist/cli.js knowledges read --help && node dist/cli.js knowledges grep --help && node dist/cli.js knowledges glob --help && node dist/cli.js knowledges list --help && node dist/cli.js knowledges files --help && node dist/cli.js knowledges status --help",
     "smoke:docker": "bash scripts/smoke-docker.sh",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
@@ -37,11 +37,10 @@
   },
   "license": "Beerware",
   "dependencies": {
+    "@inkkit/ink-markdown": "1.0.0",
     "chalk": "5.6.2",
     "chokidar": "^4.0.3",
     "ink": "^6.8.0",
-    "marked": "15.0.12",
-    "marked-terminal": "7.3.0",
     "pastel": "^4.0.1",
     "react": "^19.2.7",
     "react-devtools-core": "^6.1.5",
@@ -51,7 +50,6 @@
   },
   "devDependencies": {
     "@cng/client": "workspace:*",
-    "@types/marked-terminal": "6.1.1",
     "@types/node": "^20",
     "@types/react": "^19.2.17",
     "@types/ws": "^8.18.1",

package/dist/chunk-7KQBSEQV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/config.ts","../src/shared/output.ts","../src/shared/theme.ts"],"sourcesContent":["import { randomBytes, randomUUID } from \"node:crypto\";\nimport process from \"node:process\";\n\nexport const packageVersion = \"1.1.16\";\nexport const defaultApiBaseUrl = \"https://curly.ng\";\nexport const outputFormats = [\"text\", \"json\", \"markdown\"] as const;\n\nexport type OutputFormat = (typeof outputFormats)[number];\n\nexport type GlobalCommandOptions = {\n  apiBaseUrl?: string;\n};\n\nexport function resolveApiBaseUrl(options: GlobalCommandOptions): string {\n  return options.apiBaseUrl ?? process.env.CNGKIT_API_BASE_URL ?? defaultApiBaseUrl;\n}\n\nexport function resolveOutputFormat(): OutputFormat {\n  const value = process.env.CNGKIT_FORMAT?.toLowerCase();\n  if (value === \"json\" || value === \"markdown\") {\n    return value;\n  }\n\n  return \"text\";\n}\n\nexport function parseOutputFormat(value: string): OutputFormat {\n  const normalizedValue = value.toLowerCase();\n  if (normalizedValue === \"text\" || normalizedValue === \"json\" || normalizedValue === \"markdown\") {\n    return normalizedValue;\n  }\n\n  throw new Error(\"Unknown --format value. Use one of: text, json, markdown.\");\n}\n\nexport function createRoomCode(): string {\n  return randomBytes(4).toString(\"hex\").toUpperCase();\n}\n\nexport function createPeerId(): string {\n  return randomUUID();\n}\n","import process from \"node:process\";\nimport { Marked, type MarkedExtension } from \"marked\";\nimport { markedTerminal } from \"marked-terminal\";\nimport { createElement } from \"react\";\nimport { renderToString, Text } from \"ink\";\nimport stripAnsi from \"strip-ansi\";\nimport {\n  createMarkdownTheme,\n  decorateMarkdownOutput,\n  normalizeRenderedMarkdownOutput,\n  statusStylePropsByOutputStyle,\n  type OutputStyle,\n} from \"./theme.js\";\nimport { resolveOutputFormat } from \"./config.js\";\n\ntype OutputStream = NodeJS.WriteStream & {\n  isTTY?: boolean;\n  columns?: number;\n};\n\nexport type CommandOutput = {\n  info(message: string): void;\n  success(message: string): void;\n  warning(message: string): void;\n  muted(message: string): void;\n  markdown(message: string): void;\n  raw(message: string): void;\n  error(message: string): void;\n};\n\nexport const consoleOutput = createCommandOutput(process.stdout, process.stderr);\n\nexport function createCommandOutput(stdout: OutputStream, stderr: OutputStream): CommandOutput {\n  return {\n    info(message) {\n      writeStyledMessage(stdout, \"info\", message);\n    },\n    success(message) {\n      writeStyledMessage(stdout, \"success\", message);\n    },\n    warning(message) {\n      writeStyledMessage(stdout, \"warning\", message);\n    },\n    muted(message) {\n      writeStyledMessage(stdout, \"muted\", message);\n    },\n    markdown(message) {\n      stdout.write(`${formatMarkdownMessage(stdout, message)}\\n`);\n    },\n    raw(message) {\n      stdout.write(`${message}\\n`);\n    },\n    error(message) {\n      writeStyledMessage(stderr, \"error\", message);\n    },\n  };\n}\n\nexport function formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction writeStyledMessage(stream: OutputStream, style: OutputStyle, message: string): void {\n  stream.write(`${formatStyledMessage(stream, style, message)}\\n`);\n}\n\nfunction formatStyledMessage(stream: OutputStream, style: OutputStyle, message: string): string {\n  if (!shouldRenderColor(stream)) {\n    return message;\n  }\n\n  return renderToString(\n    createElement(\n      Text,\n      {\n        ...statusStylePropsByOutputStyle[style],\n        wrap: \"wrap\",\n      },\n      message\n    ),\n    {\n      columns: 10_000,\n    }\n  );\n}\n\nfunction formatMarkdownMessage(stream: OutputStream, markdown: string): string {\n  if (resolveOutputFormat() === \"markdown\") {\n    return markdown;\n  }\n\n  const useColor = shouldRenderColor(stream);\n  const markdownWidth = clampMarkdownWidth(stream.columns);\n  const parser = new Marked();\n  parser.use(\n    markedTerminal({\n      ...createMarkdownTheme(false),\n      width: markdownWidth,\n    }) as unknown as MarkedExtension\n  );\n\n  const preparedMarkdown = prepareMarkdownForTerminal(markdown);\n  const renderedMarkdown = normalizeRenderedMarkdownOutput(\n    `${preparedMarkdown.prefix}${String(parser.parse(preparedMarkdown.body)).trimEnd()}`\n  );\n\n  return useColor ? decorateMarkdownOutput(renderedMarkdown) : stripAnsi(renderedMarkdown);\n}\n\nfunction prepareMarkdownForTerminal(markdown: string): { prefix: string; body: string } {\n  if (!markdown.startsWith(\"---\\n\")) {\n    return { prefix: \"\", body: markdown };\n  }\n\n  const frontmatterEndIndex = markdown.indexOf(\"\\n---\", 4);\n  if (frontmatterEndIndex < 0) {\n    return {\n      prefix: formatFrontmatterForTerminal(markdown.slice(4).trimEnd()),\n      body: \"\",\n    };\n  }\n\n  const frontmatter = markdown.slice(4, frontmatterEndIndex).trimEnd();\n  const body = markdown.slice(frontmatterEndIndex + \"\\n---\".length).replace(/^\\n+/, \"\");\n\n  return {\n    prefix: formatFrontmatterForTerminal(frontmatter),\n    body,\n  };\n}\n\nfunction formatFrontmatterForTerminal(frontmatter: string): string {\n  const formattedFrontmatter = frontmatter\n    .split(\"\\n\")\n    .map((line) => `  ${line}`)\n    .join(\"\\n\");\n\n  return `Metadata\\n\\n${formattedFrontmatter}\\n\\n`;\n}\n\nfunction shouldRenderColor(stream: OutputStream): boolean {\n  if (process.env.NO_COLOR !== undefined || process.env.CNGKIT_NO_COLOR === \"1\") {\n    return false;\n  }\n\n  const colorMode = process.env.CNGKIT_COLOR?.toLowerCase();\n\n  if (colorMode === \"never\" || colorMode === \"0\" || colorMode === \"false\") {\n    return false;\n  }\n\n  if (colorMode === \"always\" || colorMode === \"1\" || colorMode === \"true\") {\n    return true;\n  }\n\n  if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== \"0\") {\n    return true;\n  }\n\n  return stream.isTTY === true;\n}\n\nfunction clampMarkdownWidth(columns: number | undefined): number {\n  if (columns === undefined) {\n    return 100;\n  }\n\n  return Math.max(72, Math.min(columns, 120));\n}\n","import { Chalk } from \"chalk\";\nimport type { TextProps } from \"ink\";\nimport stripAnsi from \"strip-ansi\";\n\nexport type OutputStyle = \"info\" | \"success\" | \"warning\" | \"muted\" | \"error\";\n\nexport const statusStylePropsByOutputStyle = {\n  info: {\n    color: \"cyan\",\n  },\n  success: {\n    color: \"green\",\n    bold: true,\n  },\n  warning: {\n    color: \"yellow\",\n    bold: true,\n  },\n  muted: {\n    dimColor: true,\n  },\n  error: {\n    color: \"red\",\n    bold: true,\n  },\n} satisfies Record<OutputStyle, TextProps>;\n\nexport function createMarkdownTheme(useColor: boolean) {\n  const chalk = new Chalk({ level: useColor ? 1 : 0 });\n  const identity = (value: string) => value;\n\n  return {\n    code: chalk.green,\n    blockquote: chalk.dim.italic,\n    html: chalk.gray,\n    heading: chalk.blueBright.bold,\n    firstHeading: chalk.magentaBright.bold,\n    hr: chalk.gray,\n    listitem: identity,\n    table: identity,\n    paragraph: identity,\n    strong: chalk.bold,\n    em: chalk.italic,\n    codespan: chalk.cyanBright,\n    del: chalk.dim.strikethrough,\n    link: chalk.blueBright,\n    href: chalk.blue.underline,\n    text: identity,\n    showSectionPrefix: true,\n    reflowText: true,\n    unescape: true,\n    emoji: false,\n    tab: 2,\n  };\n}\n\nexport function decorateMarkdownOutput(output: string): string {\n  const chalk = new Chalk({ level: 1 });\n\n  const decoratedLines = output\n    .split(\"\\n\")\n    .map((line) => {\n      const plainLine = stripAnsi(line);\n\n      if (plainLine.startsWith(\"# \")) {\n        return chalk.magentaBright.bold(plainLine);\n      }\n\n      if (plainLine.startsWith(\"## \")) {\n        return chalk.blueBright.bold(plainLine);\n      }\n\n      return line;\n    })\n    .join(\"\\n\");\n\n  return decoratedLines\n    .replace(/`([^`\\n]+)`/g, (_match, value: string) => chalk.cyanBright(value))\n    .replace(/(^|\\s)(--[a-z][a-z0-9-]*)/g, (_match, prefix: string, flag: string) => {\n      return `${prefix}${chalk.yellow(flag)}`;\n    })\n    .replace(/(https?:\\/\\/[^\\s)]+)/g, (url: string) => chalk.blueBright.underline(url))\n    .replace(/^(\\s*)\\*\\s+/gm, (_match, prefix: string) => {\n      return `${prefix}${chalk.magentaBright(\"-\")} `;\n    });\n}\n\nexport function normalizeRenderedMarkdownOutput(output: string): string {\n  return output\n    .split(\"\\n\")\n    .map((line) => {\n      const headingMatch = line.match(/^(\\s*)#{1,6}\\s+(.+)$/);\n      if (headingMatch) {\n        return `${headingMatch[1]}${headingMatch[2]}`;\n      }\n\n      return line.replace(/^(\\s*)\\*\\s+/, \"$1- \");\n    })\n    .join(\"\\n\")\n    .replace(/`([^`\\n]+)`/g, \"$1\");\n}\n"],"mappings":"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","names":["process","stripAnsi","process","stripAnsi"]}

package/dist/chunk-GZ2DPIU6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/help-specs.ts"],"sourcesContent":["type HelpTopic = {\n  title: string;\n  aliases: string[];\n  body: string;\n};\n\nconst commandList = [\n  \"- `cngkit login` - open Curly.ng login, or print the URL in headless shells.\",\n  \"- `cngkit coderoom ...` - share or join a live developer room for a working tree.\",\n  \"- `cngkit scrub [path]` - scan for secrets; rewrite only when `--yes` is passed.\",\n  \"- `cngkit transcripts ...` - list, read, and grep local Claude/Codex transcripts.\",\n  \"- `cngkit knowledges ...` - search and read the hosted Harness knowledge catalog.\",\n].join(\"\\n\");\n\nconst coderoomCommandList = [\n  \"- `share [room-code]` - start a live room from the current directory.\",\n  \"- `join <room-code>` - join another developer's live room from the current directory.\",\n].join(\"\\n\");\n\nconst knowledgesCommandList = [\n  \"- `status` - print remote catalog state.\",\n  \"- `audiences` - list valid audience filters.\",\n  \"- `search <query>` - search over Postgres-backed knowledges records.\",\n  \"- `list [query]` - list known subskills.\",\n  \"- `files [query]` - list uploaded catalog files.\",\n  \"- `read <file-path>` - Claude-style file read.\",\n  \"- `grep <pattern>` - Claude-style content search.\",\n  \"- `glob [pattern]` - Claude-style file discovery.\",\n].join(\"\\n\");\n\nconst helpTopics: HelpTopic[] = [\n  {\n    title: \"cngkit\",\n    aliases: [\"\", \"overview\", \"help\"],\n    body: `# cngkit\n\nCurly.ng operator CLI for shared code rooms, safe local cleanup, local agent transcripts, and hosted Harness knowledges.\n\n## Run Now\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest --help\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\n\\`\\`\\`\n\n## Installed Usage\n\n\\`\\`\\`bash\ncngkit <command> [options]\n\\`\\`\\`\n\n## Global Options\n\n\\`\\`\\`bash\ncngkit --format text|json|markdown ...\ncngkit --no-color ...\ncngkit --api-base-url <url> ...\n\\`\\`\\`\n\n## Commands\n\n${commandList}\n\n## Help Map\n\n\\`\\`\\`bash\ncngkit help <topic>\ncngkit <command> --help\ncngkit coderoom --help\ncngkit coderoom <subcommand> --help\ncngkit transcripts --help\ncngkit knowledges --help\ncngkit knowledges <subcommand> --help\n\\`\\`\\`\n\n## AI And Scripts\n\n- Help renders as structured terminal text by default, even in pipes.\n- Use \\`--format json\\` or \\`--json\\` on read-only data commands for typed payloads.\n- Use \\`--format markdown\\` only when raw Markdown source is intentional.\n- Use \\`--no-color\\` or \\`CNGKIT_COLOR=never\\` for logs, screenshots, and strict plain text.\n- Use \\`npm_config_progress=false npx --yes cngkit@latest ...\\` for clean one-shot npx captures.\n\n## Backend\n\nDefault API: \\`https://curly.ng\\`\n\nOverride with:\n\n\\`\\`\\`bash\ncngkit --api-base-url <url> ...\nCNGKIT_API_BASE_URL=<url> cngkit ...\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"login\",\n    aliases: [\"login\"],\n    body: `# cngkit login\n\nOpen Curly.ng login in a browser. In headless shells, print the URL so an agent can show it to the operator.\n\n## Usage\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest login\ncngkit login\n\\`\\`\\`\n\n## Output\n\n- First line names the login URL being opened.\n- If no browser opener exists, the CLI prints a direct URL.\n- No credentials are printed or persisted by this command.\n`,\n  },\n  {\n    title: \"transcripts\",\n    aliases: [\"transcripts\", \"transcript\"],\n    body: `# cngkit transcripts\n\nRead local Claude and Codex transcript JSONL files.\n\nThis is local-only operator tooling. It does not call Curly.ng and it does not upload transcript content.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit transcripts list [--source all|codex|claude] [--limit <n>] [--json|--format json]\ncngkit transcripts read <path-or-session-id> [--source all|codex|claude] [--limit <n>] [--include-internal] [--json|--format json]\ncngkit transcripts grep <query> [--source all|codex|claude] [--limit <n>] [--file-limit <n>] [--include-internal] [--json|--format json]\n\\`\\`\\`\n\n## Sources\n\n- \\`~/.codex/sessions\\`\n- \\`~/.codex/archived_sessions\\`\n- \\`~/.claude/projects\\`\n- \\`~/.claude/history.jsonl\\`\n\n## Defaults\n\n- \\`list\\`: newest 12 transcript files.\n- \\`read\\`: newest 80 user/assistant entries from the selected file.\n- \\`grep\\`: first 80 matching user/assistant entries from the newest 60 files.\n- \\`--source\\`: \\`all\\`.\n\n## Output\n\n- Text mode prints source, role, timestamp when available, and extracted message text.\n- Internal developer/system payloads and hook/tool noise are skipped unless \\`--include-internal\\` is passed.\n- Direct file paths, home-relative paths, and partial session ids are accepted by \\`read\\`.\n`,\n  },\n  {\n    title: \"coderoom\",\n    aliases: [\"coderoom\", \"code-room\", \"repo-sync\"],\n    body: `# cngkit coderoom\n\nCreate or join a temporary live room for sharing a working tree over the Curly backend.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${coderoomCommandList}\n\n## Common Flow\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest coderoom share\nnpx --yes cngkit@latest coderoom join <room-code>\n\\`\\`\\`\n\n## Behavior\n\n- Connects to \\`/api/cng/sync/:roomCode\\` on the configured Curly backend.\n- Uses WebSocket transport backed by the \\`CngSyncRoom\\` Durable Object.\n- Sends an initial snapshot, then file and delete events.\n- Last received change wins.\n- Current rooms are live relays, not durable cloud storage.\n`,\n  },\n  {\n    title: \"coderoom share\",\n    aliases: [\"coderoom-share\"],\n    body: `# cngkit coderoom share\n\nStart a live repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom share [room-code]\n\\`\\`\\`\n\n## Behavior\n\n- Connects to \\`/api/cng/sync/:roomCode\\` on the configured Curly backend.\n- Uses WebSocket transport backed by the \\`CngSyncRoom\\` Durable Object.\n- Sends an initial snapshot, then file and delete events.\n- Last received change wins.\n\n## Filesystem Contract\n\n- Preserves \\`.git/\\`.\n- Preserves files ignored by the repo's \\`.gitignore\\`.\n- Sends regular files as base64 payloads in the sync protocol.\n\n## Output\n\n- Prints room code, repo root, peer id, backend health, and concise sync events.\n- Keeps running until the socket closes or the process receives a termination signal.\n`,\n  },\n  {\n    title: \"coderoom join\",\n    aliases: [\"coderoom-join\"],\n    body: `# cngkit coderoom join\n\nJoin an existing live repository sync room from the current directory.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit coderoom join <room-code>\n\\`\\`\\`\n\n## Behavior\n\nSame transport and filesystem contract as \\`cngkit coderoom share\\`. The supplied room code selects the Durable Object room.\n\n## Output\n\n- Prints backend health, room code, repo root, peer id, and concise sync events.\n- Missing room code exits with a usage error.\n`,\n  },\n  {\n    title: \"scrub\",\n    aliases: [\"scrub\"],\n    body: `# cngkit scrub\n\nScan a file or directory for secrets with TruffleHog. Report-only is the default.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit scrub [path]\ncngkit scrub [path] --yes\n\\`\\`\\`\n\n## Safety\n\n- Default mode does not rewrite files.\n- Inline masking rewrites files and requires \\`--yes\\`.\n- Raw and redacted secret values are never printed.\n\n## Requirements\n\n- \\`trufflehog\\` must be available on \\`PATH\\`.\n\n## Mask Format\n\n\\`\\`\\`text\n[CNGKIT_SECRET:<detector>:<verified|unverified>]\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges\",\n    aliases: [\"knowledges\", \"knowledge\"],\n    body: `# cngkit knowledges\n\nSearch and read the hosted Harness knowledges catalog from the Curly backend.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges <subcommand> [options]\n\\`\\`\\`\n\n## Subcommands\n\n${knowledgesCommandList}\n\n## Progressive Help\n\n\\`\\`\\`bash\ncngkit help knowledges <subcommand>\ncngkit knowledges <subcommand> --help\ncngkit knowledges read --help\ncngkit knowledges grep --help\ncngkit knowledges glob --help\n\\`\\`\\`\n\n## Common Examples\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\nnpx --yes cngkit@latest knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\nnpx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\nnpx --yes cngkit@latest knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n\n## AI-Friendly Output\n\n- Default output is structured text intended to be directly usable by people and agents.\n- \\`read\\` renders Markdown files by default and prints exact source with \\`--format markdown\\`.\n- \\`grep --output-mode content\\` prints \\`path:line\\` blocks.\n- \\`grep --output-mode files_with_matches\\` and \\`glob\\` print one path per line.\n- \\`--format json\\` and \\`--json\\` print typed backend payloads for machine consumption.\n`,\n  },\n  {\n    title: \"knowledges status\",\n    aliases: [\"knowledges-status\", \"status\"],\n    body: `# cngkit knowledges status\n\nPrint remote Harness catalog state.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges status [--json|--format json]\n\\`\\`\\`\n\n## Output\n\n- Text mode prints catalog name, file count, blob count, database binding, and latest run when present.\n- \\`--format json\\` and \\`--json\\` print the backend data payload.\n`,\n  },\n  {\n    title: \"knowledges audiences\",\n    aliases: [\"knowledges-audiences\", \"audiences\"],\n    body: `# cngkit knowledges audiences\n\nList valid audience filters for catalog browsing.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges audiences [--json|--format json]\n\\`\\`\\`\n\n## Use When\n\nRun this before \\`cngkit knowledges files --audience <id>\\`.\n`,\n  },\n  {\n    title: \"knowledges search\",\n    aliases: [\"knowledges-search\", \"search\"],\n    body: `# cngkit knowledges search\n\nSearch the hosted Harness index for relevant skills and subskills.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges search <query> [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`5\\`\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges search Cloudflare --limit 3\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges list\",\n    aliases: [\"knowledges-list\", \"list\"],\n    body: `# cngkit knowledges list\n\nList hosted Harness subskills, optionally filtered by query.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges list [query] [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges list cloudflare --limit 10\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges files\",\n    aliases: [\"knowledges-files\", \"files\"],\n    body: `# cngkit knowledges files\n\nList uploaded Harness catalog files, optionally filtered by query or audience.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges files [query] [--audience <id>] [--limit <n>] [--json|--format json]\n\\`\\`\\`\n\n## Defaults\n\n- \\`--limit\\`: \\`25\\`\n- \\`--audience\\`: omitted\n\n## Example\n\n\\`\\`\\`bash\ncngkit knowledges files cloudflare --limit 10\ncngkit knowledges files \"vector search\" --audience builders\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges read\",\n    aliases: [\"knowledges-read\", \"read\"],\n    body: `# cngkit knowledges read\n\nRead a hosted Harness catalog file by path.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges read <file-path> [--offset <n>] [--limit <n>] [--json|--format json|--format markdown]\n\\`\\`\\`\n\n## Inputs\n\n- \\`file-path\\`: normalized catalog path. Shorthand paths such as \\`/libraries/lib-cloudflare/SUBSKILL.md\\` are expanded to \\`skills/knowledges/subskills/libraries/lib-cloudflare/SUBSKILL.md\\`.\n- \\`--offset\\`: zero-based starting line. Default: \\`0\\`.\n- \\`--limit\\`: maximum lines. Default in CLI: \\`200\\`. Backend max: \\`2000\\`.\n\n## Output\n\n- Text mode renders Markdown files for terminal reading.\n- \\`--format markdown\\` prints the exact returned file content.\n- If truncated, a final bracketed truncation note is printed after the content.\n- \\`--format json\\` and \\`--json\\` print \\`{ file_path, content, total_lines, offset, limit, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges grep\",\n    aliases: [\"knowledges-grep\", \"grep\"],\n    body: `# cngkit knowledges grep\n\nSearch inside hosted Harness catalog files with a JavaScript regular expression.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges grep <pattern> [--path <path>] [--include <glob>] [--output-mode <mode>] [--context <n>] [--case-insensitive] [--json|--format json]\n\\`\\`\\`\n\n## Inputs\n\n- \\`pattern\\`: JavaScript regular expression source.\n- \\`--path\\`: catalog path prefix. Default: \\`skills\\`.\n- \\`--include\\`: filename include filter. Default: \\`*\\`.\n- Modes: content, files_with_matches, or count.\n- \\`--output-mode\\`: \\`content\\`, \\`files_with_matches\\`, or \\`count\\`. Default: \\`content\\`.\n- \\`--context\\`: context lines around content matches. Default: \\`0\\`. Backend max: \\`20\\`.\n- \\`--case-insensitive\\`: maps to backend \\`case_insensitive=true\\`.\n\n## Output\n\n- \\`content\\`: prints blocks as \\`file_path:line_number\\`, optional context lines, then \\`> matching line\\`.\n- \\`files_with_matches\\`: prints one matching file path per line.\n- \\`count\\`: prints \\`file_path: match_count\\` lines.\n- \\`--format json\\` and \\`--json\\` print the typed backend response union.\n\n## Examples\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches\nnpx --yes cngkit@latest knowledges grep \"Postgres|Hyperdrive\" --path /libraries/lib-cloudflare --context 2\n\\`\\`\\`\n`,\n  },\n  {\n    title: \"knowledges glob\",\n    aliases: [\"knowledges-glob\", \"glob\"],\n    body: `# cngkit knowledges glob\n\nFind hosted Harness catalog files by glob pattern.\n\n## Usage\n\n\\`\\`\\`bash\ncngkit knowledges glob [pattern] [--path <path>] [--json|--format json]\n\\`\\`\\`\n\n## Inputs\n\n- \\`pattern\\`: supported glob pattern. CLI default: \\`**/*.md\\`.\n- \\`--path\\`: catalog path prefix. Default: \\`skills\\`.\n\n## Supported Patterns\n\n- \\`**/*.md\\`\n- \\`**/*.SUBSKILL.md\\`\n- \\`**/SKILL.md\\`\n- \\`*.md\\`\n- \\`*.SUBSKILL.md\\`\n- \\`SKILL.md\\`\n\n## Output\n\n- Text mode prints one file path per line.\n- If truncated, a final bracketed truncation note is printed.\n- \\`--format json\\` and \\`--json\\` print \\`{ files, total_files, truncated }\\`.\n\n## Example\n\n\\`\\`\\`bash\nnpx --yes cngkit@latest knowledges glob \"**/*.md\" --path /libraries/lib-cloudflare\n\\`\\`\\`\n`,\n  },\n];\n\nconst helpTopicNames = helpTopics\n  .filter((topic) => topic.title !== \"cngkit\")\n  .map((topic) => topic.title)\n  .sort();\n\nconst helpTopicByAlias = new Map<string, HelpTopic>();\n\nfor (const topic of helpTopics) {\n  for (const alias of topic.aliases) {\n    helpTopicByAlias.set(alias, topic);\n  }\n}\n\nexport function formatCngkitHelp(topicName?: string): string {\n  const normalizedTopicName = normalizeHelpTopicName(topicName);\n  const topic = helpTopicByAlias.get(normalizedTopicName);\n\n  if (topic) {\n    return topic.body.trim();\n  }\n\n  if (normalizedTopicName === \"\") {\n    return helpTopicByAlias.get(\"\")?.body.trim() ?? \"\";\n  }\n\n  return formatUnknownHelpTopic(normalizedTopicName);\n}\n\nexport function formatKnowledgesHelp(topicName?: string): string {\n  const normalizedTopicName = normalizeHelpTopicName(topicName);\n  const topicKey = normalizedTopicName ? `knowledges-${normalizedTopicName}` : \"knowledges\";\n  return formatCngkitHelp(topicKey);\n}\n\nfunction normalizeHelpTopicName(value: string | undefined): string {\n  return value?.trim().toLowerCase().replace(/\\s+/g, \"-\") ?? \"\";\n}\n\nfunction formatUnknownHelpTopic(topicName: string): string {\n  return `# cngkit help\n\nNo help topic named \\`${topicName}\\`.\n\n## Available Topics\n\n${helpTopicNames.map((name) => `- \\`${name}\\``).join(\"\\n\")}\n\n## Usage\n\n\\`\\`\\`bash\ncngkit help <topic>\ncngkit <command> --help\n\\`\\`\\``;\n}\n"],"mappings":";AAMA,IAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,sBAAsB;AAAA,EAC1B;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,aAA0B;AAAA,EAC9B;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,IAAI,YAAY,MAAM;AAAA,IAChC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BR,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCX;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,OAAO;AAAA,IACjB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,eAAe,YAAY;AAAA,IACrC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkCR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,YAAY,aAAa,WAAW;AAAA,IAC9C,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYR,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBnB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,gBAAgB;AAAA,IAC1B,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,eAAe;AAAA,IACzB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,OAAO;AAAA,IACjB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,cAAc,WAAW;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYR,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BrB;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,qBAAqB,QAAQ;AAAA,IACvC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,wBAAwB,WAAW;AAAA,IAC7C,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,qBAAqB,QAAQ;AAAA,IACvC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,oBAAoB,OAAO;AAAA,IACrC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkCR;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS,CAAC,mBAAmB,MAAM;AAAA,IACnC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoCR;AACF;AAEA,IAAM,iBAAiB,WACpB,OAAO,CAAC,UAAU,MAAM,UAAU,QAAQ,EAC1C,IAAI,CAAC,UAAU,MAAM,KAAK,EAC1B,KAAK;AAER,IAAM,mBAAmB,oBAAI,IAAuB;AAEpD,WAAW,SAAS,YAAY;AAC9B,aAAW,SAAS,MAAM,SAAS;AACjC,qBAAiB,IAAI,OAAO,KAAK;AAAA,EACnC;AACF;AAEO,SAAS,iBAAiB,WAA4B;AAC3D,QAAM,sBAAsB,uBAAuB,SAAS;AAC5D,QAAM,QAAQ,iBAAiB,IAAI,mBAAmB;AAEtD,MAAI,OAAO;AACT,WAAO,MAAM,KAAK,KAAK;AAAA,EACzB;AAEA,MAAI,wBAAwB,IAAI;AAC9B,WAAO,iBAAiB,IAAI,EAAE,GAAG,KAAK,KAAK,KAAK;AAAA,EAClD;AAEA,SAAO,uBAAuB,mBAAmB;AACnD;AAEO,SAAS,qBAAqB,WAA4B;AAC/D,QAAM,sBAAsB,uBAAuB,SAAS;AAC5D,QAAM,WAAW,sBAAsB,cAAc,mBAAmB,KAAK;AAC7E,SAAO,iBAAiB,QAAQ;AAClC;AAEA,SAAS,uBAAuB,OAAmC;AACjE,SAAO,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,GAAG,KAAK;AAC7D;AAEA,SAAS,uBAAuB,WAA2B;AACzD,SAAO;AAAA;AAAA,wBAEe,SAAS;AAAA;AAAA;AAAA;AAAA,EAI/B,eAAe,IAAI,CAAC,SAAS,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQ1D;","names":[]}