@abraca/convert 2.11.0 → 2.13.0

package/dist/abracadabra-convert.cjs

@@ -118,6 +118,12 @@ function parseFrontmatter(markdown) {
 	if (subtitle) meta.subtitle = subtitle;
 	const url = getStr(["url"]);
 	if (url) meta.url = url;
+	const language = getStr(["language"]);
+	if (language) meta.language = language;
+	const fileExtension = getStr(["fileExtension"]);
+	if (fileExtension) meta.fileExtension = fileExtension;
+	const codeTheme = getStr(["codeTheme"]);
+	if (codeTheme) meta.codeTheme = codeTheme;
 	const ratingRaw = getStr(["rating"]);
 	if (ratingRaw !== void 0) {
 		const n = Number(ratingRaw);
@@ -1395,6 +1401,9 @@ function generateFrontmatter(label, meta, type) {
 		4: "urgent"
 	}[meta.priority] ?? meta.priority}`);
 	if (meta.checked !== void 0) lines.push(`checked: ${meta.checked}`);
+	if (meta.language) lines.push(`language: ${yamlScalar(meta.language)}`);
+	if (meta.fileExtension) lines.push(`fileExtension: ${yamlScalar(meta.fileExtension)}`);
+	if (meta.codeTheme) lines.push(`codeTheme: ${yamlScalar(meta.codeTheme)}`);
 	if (meta.dateStart) lines.push(`dateStart: "${escapeYaml(meta.dateStart)}"`);
 	if (meta.dateEnd) lines.push(`dateEnd: "${escapeYaml(meta.dateEnd)}"`);
 	if (meta.subtitle) lines.push(`subtitle: "${escapeYaml(meta.subtitle)}"`);
@@ -1908,6 +1917,174 @@ function appendHtmlToFragment(fragment, html) {
 	});
 }
 
+//#endregion
+//#region packages/convert/src/code.ts
+/** Y.Text key holding a code document's content. */
+const CODE_TEXT_KEY = "code";
+/** Read a code document's raw text. Empty string when absent. */
+function readCodeText(doc) {
+	return doc.getText(CODE_TEXT_KEY).toString();
+}
+/**
+* Replace a code document's full text in a single transaction. `origin`
+* is forwarded to `transact` so callers (e.g. fs-sync) can tag the write
+* and skip their own observers.
+*/
+function writeCodeText(doc, content, origin) {
+	const ytext = doc.getText(CODE_TEXT_KEY);
+	doc.transact(() => {
+		if (ytext.length > 0) ytext.delete(0, ytext.length);
+		if (content.length > 0) ytext.insert(0, content);
+	}, origin);
+}
+const LANGUAGE_BY_EXT = {
+	js: "javascript",
+	mjs: "javascript",
+	cjs: "javascript",
+	jsx: "jsx",
+	ts: "typescript",
+	mts: "typescript",
+	cts: "typescript",
+	tsx: "tsx",
+	html: "html",
+	htm: "html",
+	css: "css",
+	scss: "scss",
+	less: "less",
+	vue: "vue",
+	svelte: "svelte",
+	json: "json",
+	jsonc: "json",
+	json5: "json",
+	yaml: "yaml",
+	yml: "yaml",
+	toml: "toml",
+	xml: "xml",
+	ini: "properties",
+	env: "properties",
+	rs: "rust",
+	go: "go",
+	c: "c",
+	h: "c",
+	cpp: "cpp",
+	cc: "cpp",
+	cxx: "cpp",
+	hpp: "cpp",
+	cs: "csharp",
+	java: "java",
+	kt: "kotlin",
+	kts: "kotlin",
+	swift: "swift",
+	m: "objective-c",
+	mm: "objective-c",
+	py: "python",
+	pyi: "python",
+	rb: "ruby",
+	php: "php",
+	pl: "perl",
+	lua: "lua",
+	r: "r",
+	sh: "shell",
+	bash: "shell",
+	zsh: "shell",
+	fish: "shell",
+	sql: "sql",
+	graphql: "graphql",
+	gql: "graphql",
+	dockerfile: "dockerfile",
+	md: "markdown",
+	markdown: "markdown"
+};
+/** Preferred on-disk extension per language (reverse of LANGUAGE_BY_EXT). */
+const EXT_BY_LANGUAGE = {
+	javascript: "js",
+	jsx: "jsx",
+	typescript: "ts",
+	tsx: "tsx",
+	html: "html",
+	css: "css",
+	scss: "scss",
+	less: "less",
+	vue: "vue",
+	svelte: "svelte",
+	json: "json",
+	yaml: "yaml",
+	toml: "toml",
+	xml: "xml",
+	properties: "ini",
+	rust: "rs",
+	go: "go",
+	c: "c",
+	cpp: "cpp",
+	csharp: "cs",
+	java: "java",
+	kotlin: "kt",
+	swift: "swift",
+	"objective-c": "m",
+	python: "py",
+	ruby: "rb",
+	php: "php",
+	perl: "pl",
+	lua: "lua",
+	r: "r",
+	shell: "sh",
+	sql: "sql",
+	graphql: "graphql",
+	dockerfile: "dockerfile",
+	markdown: "md",
+	plain: "txt"
+};
+/** Normalize an extension: strip leading dot(s), lowercase. */
+function normalizeExtension(ext) {
+	return ext.replace(/^\.+/, "").toLowerCase();
+}
+/**
+* Whether a file extension should import as a `code` page type. Note
+* `md`/`markdown` are intentionally NOT code extensions here — fs-sync
+* treats `.md` as the prose/envelope format, so it's excluded from the
+* code-import gate even though it has a language mapping for in-editor use.
+*/
+function isCodeExtension(ext) {
+	const e = normalizeExtension(ext);
+	if (e === "md" || e === "markdown") return false;
+	return e in LANGUAGE_BY_EXT;
+}
+/** CodeMirror language id for an extension, or undefined when unknown. */
+function extToLanguage(ext) {
+	return LANGUAGE_BY_EXT[normalizeExtension(ext)];
+}
+/** Preferred on-disk extension (no dot) for a language, or undefined. */
+function languageToExtension(language) {
+	return EXT_BY_LANGUAGE[language.toLowerCase()];
+}
+/**
+* Derive `{ language, fileExtension }` from a filename for code import.
+* Returns undefined when the extension is not a recognized code extension
+* (so callers fall back to the prose/doc path).
+*/
+function inferCodeMetaFromFilename(filename) {
+	const dot = filename.lastIndexOf(".");
+	if (dot < 0) return void 0;
+	const ext = normalizeExtension(filename.slice(dot + 1));
+	if (!isCodeExtension(ext)) return void 0;
+	const language = LANGUAGE_BY_EXT[ext];
+	if (!language) return void 0;
+	return {
+		language,
+		fileExtension: ext
+	};
+}
+/**
+* Choose the on-disk extension for a code doc on export. Prefers an
+* explicit `fileExtension`, then the language's primary extension, then
+* `txt`.
+*/
+function codeFileExtension(meta) {
+	if (meta?.fileExtension) return normalizeExtension(meta.fileExtension);
+	if (meta?.language) return languageToExtension(meta.language) ?? "txt";
+	return "txt";
+}
+
 //#endregion
 //#region packages/convert/src/diff.ts
 function attrsToJson(el) {
@@ -3162,6 +3339,18 @@ function buildRelativePath(docId, treeData, manifest) {
 	return `${parentPath}${parentPath ? "/" : ""}${resolvedFilename}.md`;
 }
 /**
+* Companion code-file path for a `code` doc, derived from its `.md`
+* envelope path by swapping the extension. e.g.
+* `src/main.md` + `rs` -> `src/main.rs`. A code doc never has children,
+* so the `_index.md` form is not expected here, but is handled defensively.
+*/
+function codeCompanionPath(mdRelativePath, fileExtension) {
+	const ext = fileExtension.replace(/^\.+/, "").toLowerCase() || "txt";
+	if (mdRelativePath.endsWith("/_index.md")) return `${mdRelativePath.slice(0, -10)}/_index.${ext}`;
+	if (mdRelativePath.endsWith(".md")) return `${mdRelativePath.slice(0, -3)}.${ext}`;
+	return `${mdRelativePath}.${ext}`;
+}
+/**
 * Get the directory portion of a relative path for a doc.
 * For _index.md docs: returns the directory containing _index.md
 * For leaf docs: returns the parent directory
@@ -3217,6 +3406,7 @@ function nextOrder(treeData, parentId) {
 }
 
 //#endregion
+exports.CODE_TEXT_KEY = CODE_TEXT_KEY;
 exports.MARK_SPECS = MARK_SPECS;
 exports.MARK_SPEC_BY_DELIM = MARK_SPEC_BY_DELIM;
 exports.MARK_SPEC_BY_NAME = MARK_SPEC_BY_NAME;
@@ -3228,18 +3418,24 @@ exports.appendHtmlToFragment = appendHtmlToFragment;
 exports.buildAliasMap = buildAliasMap;
 exports.buildRelativePath = buildRelativePath;
 exports.buildReverseLookup = buildReverseLookup;
+exports.codeCompanionPath = codeCompanionPath;
+exports.codeFileExtension = codeFileExtension;
 exports.conflictsDir = conflictsDir;
 exports.createEmptyManifest = createEmptyManifest;
 exports.diffJson = diffJson;
 exports.diffYjs = diffYjs;
+exports.extToLanguage = extToLanguage;
 exports.filenameToLabel = filenameToLabel;
 exports.fsFilenameToLabel = fsFilenameToLabel;
 exports.getDocDir = getDocDir;
 exports.getFsAdapter = getFsAdapter;
 exports.getTreeData = getTreeData;
 exports.hasChildren = hasChildren;
+exports.inferCodeMetaFromFilename = inferCodeMetaFromFilename;
+exports.isCodeExtension = isCodeExtension;
 exports.jsonToYFragment = jsonToYFragment;
 exports.labelToFilename = labelToFilename;
+exports.languageToExtension = languageToExtension;
 exports.loadManifest = loadManifest;
 exports.lookupByDocId = lookupByDocId;
 exports.lookupByHash = lookupByHash;
@@ -3247,10 +3443,12 @@ exports.lookupByPath = lookupByPath;
 exports.manifestDir = manifestDir;
 exports.mdcTagOf = mdcTagOf;
 exports.nextOrder = nextOrder;
+exports.normalizeExtension = normalizeExtension;
 exports.orphansDir = orphansDir;
 exports.parseFrontmatter = parseFrontmatter;
 exports.populateYDocFromHtml = populateYDocFromHtml;
 exports.populateYDocFromMarkdown = populateYDocFromMarkdown;
+exports.readCodeText = readCodeText;
 exports.removeEntry = removeEntry;
 exports.resolveParentFromPath = resolveParentFromPath;
 exports.saveManifest = saveManifest;
@@ -3259,6 +3457,7 @@ exports.setFsAdapter = setFsAdapter;
 exports.simpleHash = simpleHash;
 exports.stringifyJsonNode = stringifyJsonNode;
 exports.trashDir = trashDir;
+exports.writeCodeText = writeCodeText;
 exports.yfragmentToJson = yfragmentToJson;
 exports.yjsToHtml = yjsToHtml;
 exports.yjsToMarkdown = yjsToMarkdown;