@equationalapplications/core-okf 4.13.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Equational Applications LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @equationalapplications/core-okf
+
+Zero-dependency primitives for producing [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) (OKF v0.1) bundles: YAML frontmatter serialization, concept document assembly, and `index.md`/`log.md` builders. No knowledge of any specific data model — bring your own mapping from your domain objects to `OkfFrontmatter` + body strings.

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+type OkfFrontmatterScalar = string | number | boolean | null;
+type OkfFrontmatterValue = OkfFrontmatterScalar | OkfFrontmatterScalar[];
+interface OkfFrontmatter {
+    type: string;
+    title?: string;
+    description?: string;
+    resource?: string;
+    tags?: string[];
+    timestamp?: string;
+    [key: string]: OkfFrontmatterValue | undefined;
+}
+interface OkfIndexEntry {
+    path: string;
+    title: string;
+    description?: string;
+}
+interface OkfIndexSection {
+    heading: string;
+    entries: OkfIndexEntry[];
+}
+interface OkfLogEntry {
+    date: string;
+    text: string;
+}
+interface OkfFile {
+    path: string;
+    content: string;
+}
+
+declare function serializeFrontmatter(fm: OkfFrontmatter): string;
+
+declare function buildConceptDocument(fm: OkfFrontmatter, body: string): string;
+
+declare function buildIndexMd(sections: OkfIndexSection[]): string;
+declare function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string;
+
+declare function buildLogMd(entries: OkfLogEntry[]): string;
+
+export { type OkfFile, type OkfFrontmatter, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+type OkfFrontmatterScalar = string | number | boolean | null;
+type OkfFrontmatterValue = OkfFrontmatterScalar | OkfFrontmatterScalar[];
+interface OkfFrontmatter {
+    type: string;
+    title?: string;
+    description?: string;
+    resource?: string;
+    tags?: string[];
+    timestamp?: string;
+    [key: string]: OkfFrontmatterValue | undefined;
+}
+interface OkfIndexEntry {
+    path: string;
+    title: string;
+    description?: string;
+}
+interface OkfIndexSection {
+    heading: string;
+    entries: OkfIndexEntry[];
+}
+interface OkfLogEntry {
+    date: string;
+    text: string;
+}
+interface OkfFile {
+    path: string;
+    content: string;
+}
+
+declare function serializeFrontmatter(fm: OkfFrontmatter): string;
+
+declare function buildConceptDocument(fm: OkfFrontmatter, body: string): string;
+
+declare function buildIndexMd(sections: OkfIndexSection[]): string;
+declare function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string;
+
+declare function buildLogMd(entries: OkfLogEntry[]): string;
+
+export { type OkfFile, type OkfFrontmatter, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };

package/dist/index.js

@@ -0,0 +1,133 @@
+'use strict';
+
+// src/frontmatter.ts
+var RESERVED_LITERALS = /* @__PURE__ */ new Set(["true", "false", "yes", "no", "on", "off", "null", "~", ""]);
+function looksLikeNumber(value) {
+  return /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/.test(value);
+}
+function isIso8601Timestamp(value) {
+  return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2}|[+-]\d{4}|[+-]\d{2})$/.test(value);
+}
+function needsQuoting(value) {
+  if (value !== value.trim()) return true;
+  if (/[\n\r\t]/.test(value)) return true;
+  if (isIso8601Timestamp(value)) return false;
+  if (/^[-?:]\s/.test(value)) return true;
+  if (/^[\[\]{}&,*%!|>'"@`]/.test(value)) return true;
+  if (value.includes(":") || value.includes("#")) return true;
+  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;
+  if (looksLikeNumber(value)) return true;
+  return false;
+}
+function quoteString(value) {
+  const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  return `"${escaped}"`;
+}
+function serializeScalarString(value) {
+  return needsQuoting(value) ? quoteString(value) : value;
+}
+function serializeKey(key) {
+  if (/\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {
+    return quoteString(key);
+  }
+  return key;
+}
+function serializeValue(value) {
+  if (value === null) return "null";
+  if (typeof value === "boolean") return String(value);
+  if (typeof value === "number") return String(value);
+  if (typeof value === "string") return serializeScalarString(value);
+  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);
+}
+function serializeFrontmatter(fm) {
+  const lines = ["---"];
+  for (const [key, value] of Object.entries(fm)) {
+    if (value === void 0) continue;
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        lines.push(`${serializeKey(key)}: []`);
+      } else {
+        lines.push(`${serializeKey(key)}:`);
+        for (const item of value) {
+          if (typeof item === "string") {
+            lines.push(`  - ${serializeScalarString(item)}`);
+          } else {
+            lines.push(`  - ${serializeValue(item)}`);
+          }
+        }
+      }
+    } else {
+      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n") + "\n";
+}
+
+// src/concept.ts
+function buildConceptDocument(fm, body) {
+  return `${serializeFrontmatter(fm)}
+${body}`;
+}
+
+// src/index-md.ts
+function renderEntry(entry) {
+  const esc = (s) => s.replace(/\\/g, "\\\\").replace(/\[/g, "\\[").replace(/\]/g, "\\]").replace(/\r?\n/g, " ");
+  const title = esc(entry.title);
+  const description = entry.description ? esc(entry.description) : void 0;
+  return description ? `* [${title}](${entry.path}) - ${description}` : `* [${title}](${entry.path})`;
+}
+function renderSections(sections) {
+  const lines = [];
+  for (const section of sections) {
+    lines.push(`## ${section.heading}`);
+    lines.push("");
+    for (const entry of section.entries) {
+      lines.push(renderEntry(entry));
+    }
+    lines.push("");
+  }
+  if (lines.length === 0) return "";
+  return lines.join("\n").trimEnd() + "\n";
+}
+function buildIndexMd(sections) {
+  return renderSections(sections);
+}
+function buildRootIndexMd(okfVersion, sections) {
+  const frontmatter = `---
+okf_version: ${serializeScalarString(okfVersion)}
+---
+`;
+  return `${frontmatter}
+${renderSections(sections)}`;
+}
+
+// src/log-md.ts
+function buildLogMd(entries) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const group = groups.get(entry.date) ?? [];
+    group.push(entry);
+    groups.set(entry.date, group);
+  }
+  const dates = Array.from(groups.keys()).sort((a, b) => a < b ? 1 : a > b ? -1 : 0);
+  const lines = [];
+  for (const date of dates) {
+    lines.push(`## ${date}`);
+    lines.push("");
+    for (const entry of groups.get(date)) {
+      lines.push(`- ${entry.text}`);
+    }
+    lines.push("");
+  }
+  if (lines.length === 0) return "";
+  return lines.join("\n").trimEnd() + "\n";
+}
+
+exports.buildConceptDocument = buildConceptDocument;
+exports.buildIndexMd = buildIndexMd;
+exports.buildLogMd = buildLogMd;
+exports.buildRootIndexMd = buildRootIndexMd;
+exports.serializeFrontmatter = serializeFrontmatter;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { OkfFrontmatter } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,127 @@
+// src/frontmatter.ts
+var RESERVED_LITERALS = /* @__PURE__ */ new Set(["true", "false", "yes", "no", "on", "off", "null", "~", ""]);
+function looksLikeNumber(value) {
+  return /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/.test(value);
+}
+function isIso8601Timestamp(value) {
+  return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2}|[+-]\d{4}|[+-]\d{2})$/.test(value);
+}
+function needsQuoting(value) {
+  if (value !== value.trim()) return true;
+  if (/[\n\r\t]/.test(value)) return true;
+  if (isIso8601Timestamp(value)) return false;
+  if (/^[-?:]\s/.test(value)) return true;
+  if (/^[\[\]{}&,*%!|>'"@`]/.test(value)) return true;
+  if (value.includes(":") || value.includes("#")) return true;
+  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;
+  if (looksLikeNumber(value)) return true;
+  return false;
+}
+function quoteString(value) {
+  const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  return `"${escaped}"`;
+}
+function serializeScalarString(value) {
+  return needsQuoting(value) ? quoteString(value) : value;
+}
+function serializeKey(key) {
+  if (/\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {
+    return quoteString(key);
+  }
+  return key;
+}
+function serializeValue(value) {
+  if (value === null) return "null";
+  if (typeof value === "boolean") return String(value);
+  if (typeof value === "number") return String(value);
+  if (typeof value === "string") return serializeScalarString(value);
+  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);
+}
+function serializeFrontmatter(fm) {
+  const lines = ["---"];
+  for (const [key, value] of Object.entries(fm)) {
+    if (value === void 0) continue;
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        lines.push(`${serializeKey(key)}: []`);
+      } else {
+        lines.push(`${serializeKey(key)}:`);
+        for (const item of value) {
+          if (typeof item === "string") {
+            lines.push(`  - ${serializeScalarString(item)}`);
+          } else {
+            lines.push(`  - ${serializeValue(item)}`);
+          }
+        }
+      }
+    } else {
+      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n") + "\n";
+}
+
+// src/concept.ts
+function buildConceptDocument(fm, body) {
+  return `${serializeFrontmatter(fm)}
+${body}`;
+}
+
+// src/index-md.ts
+function renderEntry(entry) {
+  const esc = (s) => s.replace(/\\/g, "\\\\").replace(/\[/g, "\\[").replace(/\]/g, "\\]").replace(/\r?\n/g, " ");
+  const title = esc(entry.title);
+  const description = entry.description ? esc(entry.description) : void 0;
+  return description ? `* [${title}](${entry.path}) - ${description}` : `* [${title}](${entry.path})`;
+}
+function renderSections(sections) {
+  const lines = [];
+  for (const section of sections) {
+    lines.push(`## ${section.heading}`);
+    lines.push("");
+    for (const entry of section.entries) {
+      lines.push(renderEntry(entry));
+    }
+    lines.push("");
+  }
+  if (lines.length === 0) return "";
+  return lines.join("\n").trimEnd() + "\n";
+}
+function buildIndexMd(sections) {
+  return renderSections(sections);
+}
+function buildRootIndexMd(okfVersion, sections) {
+  const frontmatter = `---
+okf_version: ${serializeScalarString(okfVersion)}
+---
+`;
+  return `${frontmatter}
+${renderSections(sections)}`;
+}
+
+// src/log-md.ts
+function buildLogMd(entries) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const group = groups.get(entry.date) ?? [];
+    group.push(entry);
+    groups.set(entry.date, group);
+  }
+  const dates = Array.from(groups.keys()).sort((a, b) => a < b ? 1 : a > b ? -1 : 0);
+  const lines = [];
+  for (const date of dates) {
+    lines.push(`## ${date}`);
+    lines.push("");
+    for (const entry of groups.get(date)) {
+      lines.push(`- ${entry.text}`);
+    }
+    lines.push("");
+  }
+  if (lines.length === 0) return "";
+  return lines.join("\n").trimEnd() + "\n";
+}
+
+export { buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { OkfFrontmatter } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@equationalapplications/core-okf",
+  "version": "4.13.1",
+  "description": "Zero-dependency Open Knowledge Format (OKF) v0.1 primitives: frontmatter serialization, concept documents, index.md and log.md builders.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "okf",
+    "open-knowledge-format",
+    "markdown",
+    "frontmatter",
+    "knowledge-graph",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/equationalapplications/expo-llm-wiki.git",
+    "directory": "packages/okf"
+  },
+  "bugs": {
+    "url": "https://github.com/equationalapplications/expo-llm-wiki/issues"
+  },
+  "homepage": "https://github.com/equationalapplications/expo-llm-wiki/tree/main/packages/okf#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "4.1.5"
+  }
+}