@gpdoc/filekit 1.23.0 → 1.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpdoc/filekit",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "type": "module",
   "description": "Headless GPDoc file format detection, validation, and text conversion",
   "repository": "https://github.com/repetere/gpdoc.git",

package/src/index.js

@@ -13,6 +13,52 @@ const FRONT_MATTER = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
 const MAX_URL_RESPONSE_BYTES = 10 * 1024 * 1024;
 const URL_TIMEOUT_MS = 15_000;
 
+export const GPDOC_PAGE_BREAK = '<div style="page-break-after: always;"></div>';
+
+export function resolveSlideDelimiter(metadata = {}) {
+  const configured = typeof metadata?.slideDelimiter === 'string'
+    ? metadata.slideDelimiter.trim()
+    : '';
+  return configured || GPDOC_PAGE_BREAK;
+}
+
+export function splitMarkdownSlides(markdown, delimiter = GPDOC_PAGE_BREAK) {
+  // @spec FILE-MODEL-006, FILE-MODEL-007, FILE-MODEL-008, FILE-MODEL-009
+  const boundary = typeof delimiter === 'string' && delimiter.trim()
+    ? delimiter.trim()
+    : GPDOC_PAGE_BREAK;
+  const slides = [];
+  let current = [];
+  let fence = null;
+  for (const line of String(markdown ?? '').replace(/\r\n/g, '\n').split('\n')) {
+    const marker = line.match(/^\s*(`{3,}|~{3,})/u)?.[1] ?? null;
+    if (marker) {
+      if (!fence) fence = { character: marker[0], length: marker.length };
+      else if (marker[0] === fence.character && marker.length >= fence.length) fence = null;
+      current.push(line);
+      continue;
+    }
+    if (!fence && line.trim() === boundary) {
+      slides.push(current.join('\n').trim());
+      current = [];
+      continue;
+    }
+    current.push(line);
+  }
+  slides.push(current.join('\n').trim());
+  return slides;
+}
+
+export function joinMarkdownSlides(slides, delimiter = GPDOC_PAGE_BREAK) {
+  // @spec FILE-MODEL-007, FILE-MODEL-008, FILE-MODEL-009
+  const boundary = typeof delimiter === 'string' && delimiter.trim()
+    ? delimiter.trim()
+    : GPDOC_PAGE_BREAK;
+  return (Array.isArray(slides) ? slides : [slides ?? ''])
+    .map((slide) => String(slide ?? '').trim())
+    .join(`\n\n${boundary}\n\n`);
+}
+
 export class FileKitError extends Error {
   constructor(code, message) {
     super(message);
@@ -284,8 +330,15 @@ function parseGpdocJson(source) {
   if (!isManagedMetadata(json) || !isPlainObject(json.content)) {
     throw new FileKitError('INVALID_GPDOC', 'Managed GPDoc metadata must include id, filename, and a supported filetype.');
   }
+  if (json.filetype === 'slides' && Array.isArray(json.content.slides)) {
+    return {
+      metadata: clone(json),
+      body: joinMarkdownSlides(json.content.slides, resolveSlideDelimiter(json)),
+      slides: json.content.slides.map((slide) => String(slide ?? '')),
+    };
+  }
   if (typeof json.content.document !== 'string') {
-    throw new FileKitError('INVALID_GPDOC', 'This CLI release supports document content only.');
+    throw new FileKitError('INVALID_GPDOC', 'This GPDoc file does not contain supported document or slide content.');
   }
   return { metadata: clone(json), body: json.content.document };
 }
@@ -306,11 +359,15 @@ export function readDocument(source, filePath = '') {
   }
   if (format === 'json') {
     const parsed = parseGpdocJson(source);
-    return { format: 'gpdoc-json', managed: true, filetype: parsed.metadata.filetype, title: parsed.metadata.filename, body: parsed.body, metadata: parsed.metadata, warnings: [] };
+    return { format: 'gpdoc-json', managed: true, filetype: parsed.metadata.filetype, title: parsed.metadata.filename, body: parsed.body, slides: parsed.slides, metadata: parsed.metadata, warnings: [] };
   }
   const parsed = parseManagedMarkdown(String(source));
   if (parsed) {
-    return { format: 'gpdoc-markdown', managed: true, filetype: parsed.metadata.filetype, title: parsed.metadata.filename, body: parsed.body, metadata: parsed.metadata, warnings: [] };
+    const document = { format: 'gpdoc-markdown', managed: true, filetype: parsed.metadata.filetype, title: parsed.metadata.filename, body: parsed.body, metadata: parsed.metadata, warnings: [] };
+    if (parsed.metadata.filetype === 'slides') {
+      document.slides = splitMarkdownSlides(parsed.body, resolveSlideDelimiter(parsed.metadata));
+    }
+    return document;
   }
   return { format: 'markdown', managed: false, filetype: 'document', title: filenameTitle(filePath), body: String(source), warnings: [] };
 }
@@ -327,6 +384,22 @@ export function createManagedDocument(title = 'Untitled', body = '') {
   };
 }
 
+export function createManagedSlides(title = 'Untitled', slides = ['# Slide 1']) {
+  // @spec CLI-074, FILE-MODEL-011
+  const now = new Date().toISOString();
+  const normalizedSlides = (Array.isArray(slides) && slides.length ? slides : ['# Slide 1'])
+    .map((slide) => String(slide ?? ''));
+  return {
+    id: `file_${randomUUID()}`,
+    filename: title,
+    filetype: 'slides',
+    slideDelimiter: GPDOC_PAGE_BREAK,
+    created: now,
+    updated: now,
+    content: { slides: normalizedSlides },
+  };
+}
+
 export function serializeManagedMarkdown(metadata, body) {
   // @spec CLI-001, CLI-066
   // Markdown has a separate body. `content.document` is reserved for GPDoc JSON.
@@ -347,7 +420,16 @@ function markdownToText(markdown) {
 export function convertDocument(document, targetFormat) {
   const target = String(targetFormat).toLowerCase();
   const metadata = document.managed ? clone(document.metadata) : createManagedDocument(document.title, document.body);
-  metadata.content = { document: document.body };
+  if (document.filetype === 'slides') {
+    metadata.slideDelimiter = resolveSlideDelimiter(metadata);
+    metadata.content = {
+      slides: Array.isArray(document.slides)
+        ? document.slides.map((slide) => String(slide ?? ''))
+        : splitMarkdownSlides(document.body, metadata.slideDelimiter),
+    };
+  } else {
+    metadata.content = { document: document.body };
+  }
   if (target === 'gpdoc') return serializeManagedMarkdown(metadata, document.body);
   if (target === 'markdown' || target === 'md') return document.body;
   if (target === 'html') return `<!doctype html>\n<html><head><meta charset="utf-8"><title>${escapeHtml(document.title)}</title></head><body>\n${marked.parse(document.body)}\n</body></html>\n`;