todoosy 0.3.2 → 0.3.4

package/dist/cjs/formatter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Todoosy Formatter
+ */
+import type { Scheme } from './types.js';
+export declare function format(text: string, scheme?: Scheme, filename?: string): string;

package/dist/cjs/formatter.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Todoosy Formatter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = format;
+const parser_js_1 = require("./parser.js");
+function parseMiscLocation(misc) {
+    const slashIndex = misc.indexOf('/');
+    if (slashIndex === -1) {
+        return { filename: misc, heading: 'Misc' };
+    }
+    return {
+        filename: misc.substring(0, slashIndex),
+        heading: misc.substring(slashIndex + 1),
+    };
+}
+function formatMetadata(metadata) {
+    const parts = [];
+    if (metadata.due) {
+        const softPrefix = metadata.due_soft ? '~' : '';
+        parts.push(`due ${softPrefix}${metadata.due}`);
+    }
+    if (metadata.progress) {
+        parts.push(metadata.progress);
+    }
+    if (metadata.priority !== null) {
+        parts.push(`p${metadata.priority}`);
+    }
+    if (metadata.estimate_minutes !== null) {
+        const minutes = metadata.estimate_minutes;
+        if (minutes % 480 === 0 && minutes >= 480) {
+            parts.push(`${minutes / 480}d`);
+        }
+        else if (minutes % 60 === 0 && minutes >= 60) {
+            parts.push(`${minutes / 60}h`);
+        }
+        else {
+            parts.push(`${minutes}m`);
+        }
+    }
+    // Output direct hashtags (not effective_hashtags) at end
+    for (const tag of metadata.hashtags) {
+        parts.push(`#${tag}`);
+    }
+    return parts.length > 0 ? `(${parts.join(' ')})` : '';
+}
+function formatItemLine(item, indent = 0, sequenceNum) {
+    const indentStr = '  '.repeat(indent);
+    const metaStr = formatMetadata(item.metadata);
+    const titleWithMeta = metaStr ? `${item.title_text} ${metaStr}` : item.title_text;
+    if (item.type === 'heading') {
+        const hashes = '#'.repeat(item.level || 1);
+        return `${hashes} ${titleWithMeta}`;
+    }
+    // Use numbered marker if item is numbered
+    if (item.marker_type === 'numbered' && sequenceNum !== undefined) {
+        return `${indentStr}${sequenceNum}. ${titleWithMeta}`;
+    }
+    return `${indentStr}- ${titleWithMeta}`;
+}
+function formatComments(comments, isListItem, indent) {
+    if (comments.length === 0)
+        return [];
+    if (isListItem) {
+        // Indent is the list item's indent level; comments need +1 level
+        const indentStr = '  '.repeat(indent + 1);
+        return comments.map(c => `${indentStr}${c}`);
+    }
+    // Heading comments are not indented
+    return comments;
+}
+function format(text, scheme, filename) {
+    const { ast } = (0, parser_js_1.parse)(text);
+    const lines = [];
+    const itemMap = new Map();
+    for (const item of ast.items) {
+        itemMap.set(item.id, item);
+    }
+    // Determine misc location from scheme or use default
+    const miscLocation = parseMiscLocation(scheme?.misc ?? 'todoosy.md/Misc');
+    // If no filename provided, assume it could be the misc file (backward compatibility)
+    const isMiscFile = filename === undefined || filename === miscLocation.filename;
+    // Determine formatting style: roomy (default), balanced, or tight
+    const formattingStyle = scheme?.formatting_style ?? 'roomy';
+    // Track Misc section
+    let miscSectionId = null;
+    // Find existing Misc section (using configured heading name)
+    for (const item of ast.items) {
+        if (item.type === 'heading' && item.title_text === miscLocation.heading && item.level === 1) {
+            miscSectionId = item.id;
+            break;
+        }
+    }
+    // Helper to determine if we should add blank line before a heading
+    function shouldAddBlankBefore(item) {
+        if (item.type !== 'heading')
+            return false;
+        if (formattingStyle === 'tight')
+            return false;
+        if (formattingStyle === 'balanced')
+            return item.level === 1;
+        return true; // roomy
+    }
+    // Helper to determine if we should add blank line after a heading
+    function shouldAddBlankAfter(item) {
+        if (item.type !== 'heading')
+            return false;
+        if (formattingStyle === 'tight')
+            return false;
+        if (formattingStyle === 'balanced')
+            return item.level === 1;
+        return true; // roomy
+    }
+    // Helper to format an item and its subtree
+    function formatItem(id, listIndent = 0, isUnderMisc = false, sequenceNum) {
+        const item = itemMap.get(id);
+        // Skip Misc section during normal iteration (we'll add it at the end)
+        if (item.id === miscSectionId && !isUnderMisc) {
+            return;
+        }
+        // Add blank line before headings (except at start), based on style
+        if (shouldAddBlankBefore(item) && lines.length > 0) {
+            if (lines[lines.length - 1] !== '') {
+                lines.push('');
+            }
+        }
+        lines.push(formatItemLine(item, listIndent, sequenceNum));
+        // Add blank line after heading before comments or children, based on style
+        if (shouldAddBlankAfter(item)) {
+            lines.push('');
+        }
+        // Add comments
+        const formattedComments = formatComments(item.comments, item.type === 'list', listIndent);
+        lines.push(...formattedComments);
+        // Add blank line after heading comments before children
+        if (item.type === 'heading' && item.comments.length > 0 && item.children.length > 0) {
+            if (shouldAddBlankAfter(item)) {
+                lines.push('');
+            }
+        }
+        // Format children - renumber sequenced items
+        let childSequenceNum = 1;
+        for (const childId of item.children) {
+            const child = itemMap.get(childId);
+            if (child.type === 'list') {
+                // List items under a heading start at indent 0
+                // Nested list items increment indent
+                const nextIndent = item.type === 'heading' ? 0 : listIndent + 1;
+                // Pass sequence number for numbered items and increment
+                const childSeq = child.marker_type === 'numbered' ? childSequenceNum++ : undefined;
+                formatItem(childId, nextIndent, isUnderMisc, childSeq);
+            }
+            else {
+                formatItem(childId, 0, isUnderMisc);
+            }
+        }
+    }
+    // Format all root items except Misc
+    for (const rootId of ast.root_ids) {
+        if (rootId !== miscSectionId) {
+            formatItem(rootId, 0, false);
+        }
+    }
+    // Add Misc section at the end (only for the misc file)
+    if (isMiscFile) {
+        // Add blank line before Misc heading based on style
+        const miscItem = miscSectionId ? itemMap.get(miscSectionId) : null;
+        const shouldAddBlankBeforeMisc = formattingStyle !== 'tight' && (formattingStyle === 'roomy' || formattingStyle === 'balanced');
+        if (lines.length > 0 && lines[lines.length - 1] !== '' && shouldAddBlankBeforeMisc) {
+            lines.push('');
+        }
+        lines.push(`# ${miscLocation.heading}`);
+        // Add blank line after Misc heading based on style
+        const shouldAddBlankAfterMisc = formattingStyle !== 'tight' && (formattingStyle === 'roomy' || formattingStyle === 'balanced');
+        // Add Misc items if they exist
+        if (miscSectionId) {
+            const miscItemNode = itemMap.get(miscSectionId);
+            if (miscItemNode.comments.length > 0) {
+                if (shouldAddBlankAfterMisc) {
+                    lines.push('');
+                }
+                lines.push(...miscItemNode.comments);
+            }
+            if (miscItemNode.children.length > 0) {
+                if (shouldAddBlankAfterMisc) {
+                    lines.push('');
+                }
+                let miscChildSeqNum = 1;
+                for (const childId of miscItemNode.children) {
+                    // Format misc children - they start at indent 0
+                    const child = itemMap.get(childId);
+                    const childSeq = child.marker_type === 'numbered' ? miscChildSeqNum++ : undefined;
+                    lines.push(formatItemLine(child, 0, childSeq));
+                    const formattedComments = formatComments(child.comments, child.type === 'list', 0);
+                    lines.push(...formattedComments);
+                }
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Todoosy - Markdown-based todo system
+ */
+export { parse, parseTokensInParenGroup, extractParenGroups } from './parser.js';
+export type { ParseResult } from './parser.js';
+export { format } from './formatter.js';
+export { lint } from './linter.js';
+export { queryUpcoming, queryMisc, queryByHashtag, listHashtags } from './query.js';
+export type { HashtagItem, HashtagResult, HashtagListResult } from './query.js';
+export { parseScheme, parseSettings } from './settings.js';
+export { analyzeSequence, renumberChildren, insertSequencedItem, removeSequencedItem, convertToSequence, convertToBullets, } from './sequence.js';
+export type { SequenceInfo } from './sequence.js';
+export type { AST, ItemNode, ItemMetadata, Warning, LintResult, UpcomingItem, UpcomingResult, MiscItem, MiscResult, Scheme, Settings, SettingValue, ParsedToken, ParenGroup, } from './types.js';

package/dist/cjs/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Todoosy - Markdown-based todo system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToBullets = exports.convertToSequence = exports.removeSequencedItem = exports.insertSequencedItem = exports.renumberChildren = exports.analyzeSequence = exports.parseSettings = exports.parseScheme = exports.listHashtags = exports.queryByHashtag = exports.queryMisc = exports.queryUpcoming = exports.lint = exports.format = exports.extractParenGroups = exports.parseTokensInParenGroup = exports.parse = void 0;
+var parser_js_1 = require("./parser.js");
+Object.defineProperty(exports, "parse", { enumerable: true, get: function () { return parser_js_1.parse; } });
+Object.defineProperty(exports, "parseTokensInParenGroup", { enumerable: true, get: function () { return parser_js_1.parseTokensInParenGroup; } });
+Object.defineProperty(exports, "extractParenGroups", { enumerable: true, get: function () { return parser_js_1.extractParenGroups; } });
+var formatter_js_1 = require("./formatter.js");
+Object.defineProperty(exports, "format", { enumerable: true, get: function () { return formatter_js_1.format; } });
+var linter_js_1 = require("./linter.js");
+Object.defineProperty(exports, "lint", { enumerable: true, get: function () { return linter_js_1.lint; } });
+var query_js_1 = require("./query.js");
+Object.defineProperty(exports, "queryUpcoming", { enumerable: true, get: function () { return query_js_1.queryUpcoming; } });
+Object.defineProperty(exports, "queryMisc", { enumerable: true, get: function () { return query_js_1.queryMisc; } });
+Object.defineProperty(exports, "queryByHashtag", { enumerable: true, get: function () { return query_js_1.queryByHashtag; } });
+Object.defineProperty(exports, "listHashtags", { enumerable: true, get: function () { return query_js_1.listHashtags; } });
+var settings_js_1 = require("./settings.js");
+Object.defineProperty(exports, "parseScheme", { enumerable: true, get: function () { return settings_js_1.parseScheme; } });
+Object.defineProperty(exports, "parseSettings", { enumerable: true, get: function () { return settings_js_1.parseSettings; } });
+var sequence_js_1 = require("./sequence.js");
+Object.defineProperty(exports, "analyzeSequence", { enumerable: true, get: function () { return sequence_js_1.analyzeSequence; } });
+Object.defineProperty(exports, "renumberChildren", { enumerable: true, get: function () { return sequence_js_1.renumberChildren; } });
+Object.defineProperty(exports, "insertSequencedItem", { enumerable: true, get: function () { return sequence_js_1.insertSequencedItem; } });
+Object.defineProperty(exports, "removeSequencedItem", { enumerable: true, get: function () { return sequence_js_1.removeSequencedItem; } });
+Object.defineProperty(exports, "convertToSequence", { enumerable: true, get: function () { return sequence_js_1.convertToSequence; } });
+Object.defineProperty(exports, "convertToBullets", { enumerable: true, get: function () { return sequence_js_1.convertToBullets; } });

package/dist/cjs/linter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Todoosy Linter
+ */
+import type { LintResult, Scheme } from './types.js';
+export declare function lint(text: string, scheme?: Scheme, filename?: string): LintResult;
+export declare function lintScheme(scheme: Scheme): LintResult;