octocms 0.1.0

package/dist/agentDocs-Z5BI2Y2G.js

@@ -0,0 +1,38 @@
+import {
+  agentsMdSection,
+  agentsMdTemplate
+} from "./chunk-I7KNSICQ.js";
+import {
+  log
+} from "./chunk-6PHFHGTZ.js";
+import "./chunk-W6QJTGBC.js";
+
+// cli/commands/agentDocs.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+async function agentDocsCommand(projectRoot) {
+  log.header("Agent documentation");
+  const agentsMdPath = join(projectRoot, "AGENTS.md");
+  const MARKER = "<!-- octocms:agent-docs -->";
+  if (!existsSync(agentsMdPath)) {
+    writeFileSync(agentsMdPath, agentsMdTemplate(), "utf8");
+    log.success("AGENTS.md \u2014 created with OctoCMS agent docs section");
+  } else {
+    const current = readFileSync(agentsMdPath, "utf8");
+    if (current.includes(MARKER)) {
+      log.success("AGENTS.md \u2014 OctoCMS section already present");
+    } else {
+      const updated = current.trimEnd() + "\n\n" + agentsMdSection() + "\n";
+      writeFileSync(agentsMdPath, updated, "utf8");
+      log.step("AGENTS.md \u2014 appended OctoCMS agent docs section");
+    }
+  }
+  log.blank();
+  log.info("AI agents can now read octocms/docs/ for content management instructions.");
+  log.info("Regenerate the docs after schema changes: npm run agent-docs:gen");
+  log.blank();
+}
+export {
+  agentDocsCommand
+};
+//# sourceMappingURL=agentDocs-Z5BI2Y2G.js.map

package/dist/agentDocs-Z5BI2Y2G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/commands/agentDocs.ts"],"sourcesContent":["/**\n * `octocms agent-docs` — Inject AI agent documentation links into AGENTS.md.\n *\n * Creates AGENTS.md if it doesn't exist, or appends the OctoCMS section\n * if the file exists but doesn't contain it yet.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { log } from '../lib/logger';\nimport { agentsMdSection, agentsMdTemplate } from '../lib/templates';\n\nexport async function agentDocsCommand(projectRoot: string): Promise<void> {\n  log.header('Agent documentation');\n\n  const agentsMdPath = join(projectRoot, 'AGENTS.md');\n  const MARKER = '<!-- octocms:agent-docs -->';\n\n  if (!existsSync(agentsMdPath)) {\n    writeFileSync(agentsMdPath, agentsMdTemplate(), 'utf8');\n    log.success('AGENTS.md — created with OctoCMS agent docs section');\n  } else {\n    const current = readFileSync(agentsMdPath, 'utf8');\n    if (current.includes(MARKER)) {\n      log.success('AGENTS.md — OctoCMS section already present');\n    } else {\n      const updated = current.trimEnd() + '\\n\\n' + agentsMdSection() + '\\n';\n      writeFileSync(agentsMdPath, updated, 'utf8');\n      log.step('AGENTS.md — appended OctoCMS agent docs section');\n    }\n  }\n\n  log.blank();\n  log.info('AI agents can now read octocms/docs/ for content management instructions.');\n  log.info('Regenerate the docs after schema changes: npm run agent-docs:gen');\n  log.blank();\n}\n"],"mappings":";;;;;;;;;;AAOA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AAKrB,eAAsB,iBAAiB,aAAoC;AACzE,MAAI,OAAO,qBAAqB;AAEhC,QAAM,eAAe,KAAK,aAAa,WAAW;AAClD,QAAM,SAAS;AAEf,MAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,kBAAc,cAAc,iBAAiB,GAAG,MAAM;AACtD,QAAI,QAAQ,0DAAqD;AAAA,EACnE,OAAO;AACL,UAAM,UAAU,aAAa,cAAc,MAAM;AACjD,QAAI,QAAQ,SAAS,MAAM,GAAG;AAC5B,UAAI,QAAQ,kDAA6C;AAAA,IAC3D,OAAO;AACL,YAAM,UAAU,QAAQ,QAAQ,IAAI,SAAS,gBAAgB,IAAI;AACjE,oBAAc,cAAc,SAAS,MAAM;AAC3C,UAAI,KAAK,sDAAiD;AAAA,IAC5D;AAAA,EACF;AAEA,MAAI,MAAM;AACV,MAAI,KAAK,2EAA2E;AACpF,MAAI,KAAK,kEAAkE;AAC3E,MAAI,MAAM;AACZ;","names":[]}

package/dist/chunk-4MPOTHTY.js

@@ -0,0 +1,9 @@
+// defineConfig.ts
+function defineConfig(config) {
+  return config;
+}
+
+export {
+  defineConfig
+};
+//# sourceMappingURL=chunk-4MPOTHTY.js.map

package/dist/chunk-4MPOTHTY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../defineConfig.ts"],"sourcesContent":["import type { Config, ResolvedImageField, RichTextDocument } from './types';\n\n/**\n * Define the CMS configuration with full literal type inference.\n *\n * Wrapping your config in `defineConfig()` preserves exact collection names,\n * field names, and field formats as literal types — enabling type-safe queries\n * with autocomplete in `cms/query.ts`.\n *\n * Use `as const` on `select` field `options` (and `defaultOptions`) so option\n * `value`s infer as string literal unions in `InferFields`.\n *\n * @example\n * ```ts\n * // cms/octocms.config.ts\n * import { defineConfig } from 'octocms/defineConfig';\n *\n * export const config = defineConfig({\n *   projectName: 'My Site',\n *   git: { baseBranch: 'main', publishedPointerBranch: 'cms/publish-pointer' },\n *   collections: { post: { label: 'Post', hasMany: true, fields: { ... } } },\n *   // ...\n * });\n * ```\n */\nexport function defineConfig<T extends Config>(config: T): T {\n  return config;\n}\n\n// ---------------------------------------------------------------------------\n// Type utilities — infer entry shapes from a defineConfig() config literal\n// ---------------------------------------------------------------------------\n\n/** Map a field `format` string to the runtime TypeScript type it produces after processing. */\nexport type FieldFormatToType = {\n  string: string;\n  text: string;\n  markdown: string;\n  richtext: RichTextDocument;\n  boolean: 'true' | 'false';\n  number: number | null;\n  datetime: string | null;\n  image: ResolvedImageField;\n  reference: unknown;\n  json: unknown;\n  slug: string;\n  select: string;\n  url: string;\n  color: string;\n  conditional: unknown;\n};\n\n/** Union of option `value` literals when `options` is a readonly tuple. */\ntype OptionValues<Opts> =\n  Opts extends ReadonlyArray<{ readonly value: infer V }> ? (V extends string ? V : string) : string;\n\n/** Extract the collection names defined in a config object. */\nexport type CollectionNames<C extends Config> = Extract<keyof C['collections'], string>;\n\n// ---------------------------------------------------------------------------\n// Conditional field type inference\n// ---------------------------------------------------------------------------\n\n/** Infer the resolved value type for a single field definition. */\ntype InferSingleFieldType<F> = F extends { format: 'string'; list: true }\n  ? string[]\n  : F extends { format: 'boolean' }\n    ? 'true' | 'false'\n    : F extends { format: 'select'; multiple: true; options: infer Opts }\n      ? OptionValues<Opts>[]\n      : F extends { format: 'select'; options: infer Opts }\n        ? OptionValues<Opts>\n        : F extends {\n              format: 'conditional';\n              conditional: { branches: infer B };\n            }\n          ? InferConditionalValue<B>\n          : F extends { format: infer Fmt }\n            ? Fmt extends keyof FieldFormatToType\n              ? FieldFormatToType[Fmt]\n              : unknown\n            : unknown;\n\n/** Infer the inline fields type for a branch's fields record. */\ntype InferBranchInlineFields<Fields> = {\n  [K in Extract<keyof Fields, string>]: InferSingleFieldType<Fields[K]>;\n};\n\n/**\n * Infer the value type for a single branch.\n * - Inline branch (`fields`): produces an object type mapping field names to their inferred types.\n * - Reference branch (`collection`): produces `unknown` (resolved at runtime to the referenced entry).\n */\ntype InferBranchValue<B> = B extends { fields: infer F } ? InferBranchInlineFields<F> : unknown;\n\n/**\n * Infer the union of all branch value types for a conditional field.\n * This is the type the consumer gets after selecting a branch at query time.\n */\ntype InferConditionalValue<Branches> = Branches extends readonly [infer Head, ...infer Tail]\n  ? InferBranchValue<Head> | InferConditionalValue<Tail>\n  : never;\n\n/**\n * Extract the literal union of branch `key` strings from a conditional field's branches tuple.\n * Requires `as const` on the branches array in `cms/octocms.config.ts` for literal inference.\n */\nexport type InferConditionalKeys<Branches> = Branches extends readonly [infer Head, ...infer Tail]\n  ? (Head extends { key: infer K } ? (K extends string ? K : never) : never) | InferConditionalKeys<Tail>\n  : never;\n\n// ---------------------------------------------------------------------------\n// InferFields / InferEntry\n// ---------------------------------------------------------------------------\n\n/** Infer the `fields` shape for a collection, mapping each field format to its TS type. */\nexport type InferFields<C extends Config, Name extends CollectionNames<C>> = C['collections'][Name] extends {\n  fields: infer F;\n}\n  ? {\n      [K in Extract<keyof F, string>]: InferSingleFieldType<F[K]>;\n    }\n  : Record<string, unknown>;\n\n/** A fully-typed content entry for a given collection. */\nexport type InferEntry<C extends Config, Name extends CollectionNames<C>> = {\n  sys: { id: string; type: Name };\n  fields: InferFields<C, Name>;\n};\n\n// ---------------------------------------------------------------------------\n// InferConditions — extract the required `conditions` record for `query()`\n// ---------------------------------------------------------------------------\n\n/**\n * For a single collection, build `Record<fieldName, branchKeyUnion>` for every `format: 'conditional'` field.\n * If the collection has no conditional fields this resolves to `{}` (empty object / `never` keys).\n */\nexport type InferConditions<C extends Config, Name extends CollectionNames<C>> = C['collections'][Name] extends {\n  fields: infer F;\n}\n  ? {\n      [K in Extract<keyof F, string> as F[K] extends { format: 'conditional' } ? K : never]: F[K] extends {\n        conditional: { branches: infer B };\n      }\n        ? InferConditionalKeys<B>\n        : never;\n    }\n  : {};\n"],"mappings":";AAyBO,SAAS,aAA+B,QAAc;AAC3D,SAAO;AACT;","names":[]}