flowdini-spec 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # flowdini-spec
2
2
 
3
- Парсер `.md`-файлов для flowdini: заголовки первых трёх уровней и Obsidian Inline Fields (`[param:: value]`). TypeScript, ESM, npm-пакет.
3
+ Низкоуровневая «карта» flowdini: парсер и сериализатор `.md`-файлов (заголовки 1–3 уровней и Obsidian Inline Fields `[param:: value]`) + сырой доступ к файлам. TypeScript, ESM, npm-пакет. Без процесса/ролей/LLM — объект `fd` поверх этих функций собирает `flowdini-engine`.
4
4
 
5
5
  ## Установка
6
6
 
@@ -11,29 +11,43 @@ npm i flowdini-spec
11
11
  ## Использование
12
12
 
13
13
  ```ts
14
- import { FdMd } from 'flowdini-spec';
15
-
16
- const fd = new FdMd({ dir: './specs' });
17
- await fd.scan();
18
-
19
- for (const file of fd.getFileList()) {
20
- const schema = await fd.getContent(file);
21
- // schema.inlineList — поля до первого заголовка
22
- // schema.itemList — записи по заголовкам
14
+ import { FdTaskFile, textToStructure } from 'flowdini-spec';
15
+
16
+ const files = new FdTaskFile('./specs');
17
+ for (const file of await files.list()) {
18
+ const text = await files.read(file);
19
+ const content = textToStructure(text, true);
20
+ // content.inlineList — поля до первого заголовка
21
+ // content.itemList — записи по заголовкам (topic + text)
23
22
  }
24
23
  ```
25
24
 
26
- Низкоуровневый парсинг строки: `parseMarkdown(content)` (тот же `TFdContent`).
27
-
28
25
  ## API
29
26
 
27
+ ### `FdTaskFile` — сырой доступ к файлам
28
+
30
29
  | Метод | Сигнатура | Описание |
31
30
  |---|---|---|
32
- | `scan` | `async scan(): Promise<void>` | Рекурсивно обходит `dir`, формирует список файлов; повторный вызов сбрасывает кэш. |
33
- | `getFileList` | `getFileList(): string[]` | Относительные пути от `dir`, разделитель `/`, лексикографический порядок. |
34
- | `getContent` | `async getContent(fileItem): Promise<TFdContent>` | Контент файла (элемент `getFileList`), кэш по `mtime + size`. |
31
+ | `list` | `async list(): Promise<string[]>` | Рекурсивный обход `.md`-файлов (скрытые пропускаются), пути относительно каталога, разделитель `/`, сортировка. |
32
+ | `read` | `async read(file): Promise<string>` | Сырое содержимое файла. |
33
+ | `write` | `async write(file, text): Promise<void>` | Запись; создаёт родительские каталоги при необходимости. |
34
+
35
+ Конструктор: `new FdTaskFile(taskDir)`.
36
+
37
+ ### `parser` — текст ↔ структура
38
+
39
+ | Функция | Сигнатура | Описание |
40
+ |---|---|---|
41
+ | `textToStructure` | `(text, allowText: boolean): TFdContent` | Парсинг md в структуру. `allowText: false` → `text` везде `null` (тело не накапливается), структура и inline-поля — на месте. |
42
+ | `inlineFieldToText` | `(field): string` | `[param:: v1, v2]`. |
43
+ | `levelToText` | `(level, headingLevel: 1\|2\|3): string` | Заголовок: `### title 2`. |
44
+ | `topicToText` | `(topic): string` | Заголовок самого глубокого заданного уровня + inline-поля в ту же строку. |
45
+ | `itemToText` | `(item): string` | Заголовок + `\n` + тело (если есть). |
46
+ | `contentToText` | `(content): string` | Преамбула (по строке на поле) + элементы через `\n`. |
47
+
48
+ ### `builder` — фабрики пустых структур
35
49
 
36
- Конструктор: `new FdMd({ dir, filter? })`, где `filter: { list: string[], action: 'allow' | 'deny' }`.
50
+ `newInlineField()`, `newLevel()`, `newTopic()`, `newItem()`, `newContent()` — и объект `builder` с теми же функциями (без `this`, безопасны при деструктуризации).
37
51
 
38
52
  ## Типы
39
53
 
@@ -48,21 +62,21 @@ interface TFdInlineField {
48
62
  valueList: string[];
49
63
  }
50
64
 
51
- interface TFdContentTopic {
65
+ interface TFdTopic {
52
66
  level1: TFdLevel | null;
53
67
  level2: TFdLevel | null;
54
68
  level3: TFdLevel | null;
55
69
  inlineList: TFdInlineField[];
56
70
  }
57
71
 
58
- interface TFdContentItem {
59
- topic: TFdContentTopic;
60
- text?: string; // тело раздела (сырой текст), отсутствует если пусто
72
+ interface TFdItem {
73
+ topic: TFdTopic;
74
+ text: string | null; // тело раздела (сырой текст), null — тела нет
61
75
  }
62
76
 
63
77
  interface TFdContent {
64
78
  inlineList: TFdInlineField[]; // преамбула: поля до первого заголовка
65
- itemList: TFdContentItem[];
79
+ itemList: TFdItem[];
66
80
  }
67
81
  ```
68
82
 
@@ -97,18 +111,12 @@ interface TFdContent {
97
111
 
98
112
  - Строки между заголовком и следующим заголовком — тело раздела; сохраняются в `text` сырыми (как есть, включая строки с inline-полями и fenced-блоки).
99
113
  - Inline-поля тела дополнительно индексируются в `topic.inlineList` (не вычищаются из `text` — `text` каноничен для обратной сборки).
100
- - Пустое тело (только whitespace) → `text` отсутствует (`undefined`).
114
+ - Пустое тело (только whitespace) → `text: null`.
115
+ - При `allowText: false` тело не накапливается, `text` всегда `null`; поля индексируются как обычно.
101
116
 
102
- ## Фильтр
117
+ ## Сериализация
103
118
 
104
- - Дефолт — все `*.md` рекурсивно (`**/*.md`).
105
- - Матчинг micromatch против относительного пути (разделитель `/`), регистрозависимый: `*` не пересекает `/`, `**` пересекает. `111.md` — только корень, `**/*2.md` — любая глубина.
106
- - `allow` — оставить подходящие; `deny` — исключить подходящие.
107
-
108
- ## Кэш и ошибки
109
-
110
- - Кэш по `mtime + size`; без изменений файл не перечитывается.
111
- - Ошибка чтения/парсинга → пустой контент `{ inlineList: [], itemList: [] }`, кэш для файла сбрасывается.
119
+ Собирает структуру обратно в md: `contentToText` → `itemToText` → `topicToText` → `levelToText` / `inlineFieldToText`. `text` сериализуется как есть. Точный round-trip исходного форматирования (пробелы, положение поля в теле vs в заголовке) не гарантируется: inline-поля `topic.inlineList` выводятся в строку заголовка.
112
120
 
113
121
  ## Пример
114
122
 
@@ -122,7 +130,7 @@ interface TFdContent {
122
130
  [par1:: val4, val5]
123
131
  ```
124
132
 
125
- Выход (`getContent`):
133
+ Выход (`textToStructure(text, true)`):
126
134
 
127
135
  ```json
128
136
  {
@@ -134,7 +142,8 @@ interface TFdContent {
134
142
  "level2": null,
135
143
  "level3": null,
136
144
  "inlineList": []
137
- }
145
+ },
146
+ "text": null
138
147
  },
139
148
  {
140
149
  "topic": {
@@ -0,0 +1,12 @@
1
+ /** Сырой доступ к `.md`-файлам каталога задачи: список / чтение / запись. */
2
+ export declare class FdTaskFile {
3
+ private readonly dir;
4
+ constructor(taskDir: string);
5
+ /** Рекурсивный обход `.md`-файлов (скрытые папки/файлы пропускаются), пути относительно `dir`. */
6
+ list(): Promise<string[]>;
7
+ read(relativeFileName: string): Promise<string>;
8
+ /** Создаёт родительские каталоги при необходимости. */
9
+ write(relativeFileName: string, text: string): Promise<void>;
10
+ private walk;
11
+ }
12
+ //# sourceMappingURL=FdTaskFile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FdTaskFile.d.ts","sourceRoot":"","sources":["../src/FdTaskFile.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,EAAE,MAAM;IAI3B,kGAAkG;IAC5F,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOzB,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,uDAAuD;IACjD,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAMpD,IAAI;CAoBnB"}
@@ -0,0 +1,48 @@
1
+ import { promises as fs } from 'node:fs';
2
+ import * as path from 'node:path';
3
+ /** Сырой доступ к `.md`-файлам каталога задачи: список / чтение / запись. */
4
+ export class FdTaskFile {
5
+ dir;
6
+ constructor(taskDir) {
7
+ this.dir = path.resolve(taskDir);
8
+ }
9
+ /** Рекурсивный обход `.md`-файлов (скрытые папки/файлы пропускаются), пути относительно `dir`. */
10
+ async list() {
11
+ const abs = await this.walk(this.dir);
12
+ return abs
13
+ .map((f) => path.relative(this.dir, f).split(path.sep).join('/'))
14
+ .sort();
15
+ }
16
+ async read(relativeFileName) {
17
+ return fs.readFile(path.resolve(this.dir, relativeFileName), 'utf8');
18
+ }
19
+ /** Создаёт родительские каталоги при необходимости. */
20
+ async write(relativeFileName, text) {
21
+ const fullPath = path.resolve(this.dir, relativeFileName);
22
+ await fs.mkdir(path.dirname(fullPath), { recursive: true });
23
+ await fs.writeFile(fullPath, text, 'utf8');
24
+ }
25
+ async walk(dir) {
26
+ let entries;
27
+ try {
28
+ entries = await fs.readdir(dir, { withFileTypes: true });
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ const out = [];
34
+ for (const entry of entries) {
35
+ if (entry.name.startsWith('.'))
36
+ continue;
37
+ const full = path.join(dir, entry.name);
38
+ if (entry.isDirectory()) {
39
+ out.push(...(await this.walk(full)));
40
+ }
41
+ else if (entry.isFile() && entry.name.endsWith('.md')) {
42
+ out.push(full);
43
+ }
44
+ }
45
+ return out;
46
+ }
47
+ }
48
+ //# sourceMappingURL=FdTaskFile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FdTaskFile.js","sourceRoot":"","sources":["../src/FdTaskFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,6EAA6E;AAC7E,MAAM,OAAO,UAAU;IACJ,GAAG,CAAS;IAE7B,YAAY,OAAe;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,GAAG;aACP,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAChE,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,gBAAwB;QACjC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,KAAK,CAAC,gBAAwB,EAAE,IAAY;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAW;QAC5B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}
@@ -0,0 +1,15 @@
1
+ import type { TFdContent, TFdInlineField, TFdItem, TFdLevel, TFdTopic } from './types.js';
2
+ export declare function newInlineField(): TFdInlineField;
3
+ export declare function newLevel(): TFdLevel;
4
+ export declare function newTopic(): TFdTopic;
5
+ export declare function newItem(): TFdItem;
6
+ export declare function newContent(): TFdContent;
7
+ /** Фабрики пустых структур (без `this` — безопасны при деструктуризации). */
8
+ export declare const builder: {
9
+ newInlineField: typeof newInlineField;
10
+ newLevel: typeof newLevel;
11
+ newTopic: typeof newTopic;
12
+ newItem: typeof newItem;
13
+ newContent: typeof newContent;
14
+ };
15
+ //# sourceMappingURL=builder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,QAAQ,EACR,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,wBAAgB,cAAc,IAAI,cAAc,CAE/C;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED,6EAA6E;AAC7E,eAAO,MAAM,OAAO;;;;;;CAMnB,CAAC"}
@@ -0,0 +1,24 @@
1
+ export function newInlineField() {
2
+ return { param: '', valueList: [] };
3
+ }
4
+ export function newLevel() {
5
+ return { title: '', idx: null };
6
+ }
7
+ export function newTopic() {
8
+ return { level1: null, level2: null, level3: null, inlineList: [] };
9
+ }
10
+ export function newItem() {
11
+ return { topic: newTopic(), text: null };
12
+ }
13
+ export function newContent() {
14
+ return { inlineList: [], itemList: [] };
15
+ }
16
+ /** Фабрики пустых структур (без `this` — безопасны при деструктуризации). */
17
+ export const builder = {
18
+ newInlineField,
19
+ newLevel,
20
+ newTopic,
21
+ newItem,
22
+ newContent,
23
+ };
24
+ //# sourceMappingURL=builder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,cAAc;IACd,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,UAAU;CACX,CAAC"}
package/dist/index.d.ts CHANGED
@@ -1,4 +1,5 @@
1
- export { FdMd } from './FdMd.js';
2
- export { parseMarkdown } from './parse.js';
3
- export type { TFdContent, TFdContentItem, TFdContentTopic, TFdInlineField, TFdLevel, FdMdParams, FdMdFilter, } from './types.js';
1
+ export { FdTaskFile } from './FdTaskFile.js';
2
+ export { textToStructure, inlineFieldToText, levelToText, topicToText, itemToText, contentToText, } from './parse.js';
3
+ export { builder, newInlineField, newLevel, newTopic, newItem, newContent, } from './builder.js';
4
+ export type { TFdContent, TFdItem, TFdTopic, TFdLevel, TFdInlineField, } from './types.js';
4
5
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAC"}
package/dist/index.js CHANGED
@@ -1,3 +1,4 @@
1
- export { FdMd } from './FdMd.js';
2
- export { parseMarkdown } from './parse.js';
1
+ export { FdTaskFile } from './FdTaskFile.js';
2
+ export { textToStructure, inlineFieldToText, levelToText, topicToText, itemToText, contentToText, } from './parse.js';
3
+ export { builder, newInlineField, newLevel, newTopic, newItem, newContent, } from './builder.js';
3
4
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,cAAc,CAAC"}
package/dist/parse.d.ts CHANGED
@@ -1,3 +1,19 @@
1
- import type { TFdContent } from './types.js';
2
- export declare function parseMarkdown(content: string): TFdContent;
1
+ import type { TFdContent, TFdInlineField, TFdItem, TFdLevel, TFdTopic } from './types.js';
2
+ /**
3
+ * Парсинг md в структуру. `allowText` управляет телом разделов:
4
+ * `true` — тело сохраняется в `item.text`; `false` — `text` везде `null`
5
+ * (тело не накапливается — когда нужна только структура/навигация).
6
+ * Inline-поля индексируются в `topic.inlineList` в обоих режимах.
7
+ */
8
+ export declare function textToStructure(text: string, allowText: boolean): TFdContent;
9
+ export declare function inlineFieldToText(field: TFdInlineField): string;
10
+ export declare function levelToText(level: TFdLevel, headingLevel: 1 | 2 | 3): string;
11
+ /**
12
+ * Заголовок самого глубокого заданного уровня + inline-поля в ту же строку.
13
+ * Пустой топик (все уровни `null`) → `''`.
14
+ */
15
+ export declare function topicToText(topic: TFdTopic): string;
16
+ export declare function itemToText(item: TFdItem): string;
17
+ /** Преамбула (по строке на поле) + элементы, склеенные через `\n`. */
18
+ export declare function contentToText(content: TFdContent): string;
3
19
  //# sourceMappingURL=parse.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,YAAY,CAAC;AAkFpB,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAoEzD"}
1
+ {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,OAAO,EACP,QAAQ,EACR,QAAQ,EACT,MAAM,YAAY,CAAC;AAwEpB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,CAmE5E;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAI5E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAOnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAKzD"}
package/dist/parse.js CHANGED
@@ -56,14 +56,20 @@ function isClosingFence(line, char, len) {
56
56
  const re = new RegExp(`^ {0,3}${char}{${len},}\\s*$`);
57
57
  return re.test(line);
58
58
  }
59
- /** Пустое тело (только whitespace) не сохраняется — `text` остаётся отсутствующим. */
59
+ /** Пустое тело (только whitespace) → `null`. */
60
60
  function finishText(bodyLines) {
61
61
  const text = bodyLines.join('\n');
62
- return text.trim() === '' ? undefined : text;
62
+ return text.trim() === '' ? null : text;
63
63
  }
64
- export function parseMarkdown(content) {
64
+ /**
65
+ * Парсинг md в структуру. `allowText` управляет телом разделов:
66
+ * `true` — тело сохраняется в `item.text`; `false` — `text` везде `null`
67
+ * (тело не накапливается — когда нужна только структура/навигация).
68
+ * Inline-поля индексируются в `topic.inlineList` в обоих режимах.
69
+ */
70
+ export function textToStructure(text, allowText) {
65
71
  const result = { inlineList: [], itemList: [] };
66
- const lines = content.split(/\r?\n/);
72
+ const lines = text.split(/\r?\n/);
67
73
  let level1 = null;
68
74
  let level2 = null;
69
75
  let level3 = null;
@@ -74,8 +80,8 @@ export function parseMarkdown(content) {
74
80
  let fenceLen = 0;
75
81
  for (const line of lines) {
76
82
  if (inFence) {
77
- // Fenced-блок — литерал: строки идут в тело раздела как есть.
78
- bodyLines.push(line);
83
+ if (allowText)
84
+ bodyLines.push(line);
79
85
  if (isClosingFence(line, fenceChar, fenceLen))
80
86
  inFence = false;
81
87
  continue;
@@ -85,12 +91,13 @@ export function parseMarkdown(content) {
85
91
  inFence = true;
86
92
  fenceChar = open.char;
87
93
  fenceLen = open.len;
88
- bodyLines.push(line);
94
+ if (allowText)
95
+ bodyLines.push(line);
89
96
  continue;
90
97
  }
91
98
  const heading = matchHeading(line);
92
99
  if (heading) {
93
- if (currentItem)
100
+ if (allowText && currentItem)
94
101
  currentItem.text = finishText(bodyLines);
95
102
  bodyLines = [];
96
103
  const level = parseLevel(stripFields(heading.text));
@@ -108,13 +115,14 @@ export function parseMarkdown(content) {
108
115
  level3 = level;
109
116
  }
110
117
  const topic = { level1, level2, level3, inlineList: fields };
111
- const item = { topic };
118
+ const item = { topic, text: null };
112
119
  result.itemList.push(item);
113
120
  currentItem = item;
114
121
  continue;
115
122
  }
116
- // Обычная строка тела: сохраняется в text; inline-поля дополнительно индексируются.
117
- bodyLines.push(line);
123
+ // Обычная строка тела: текст только при allowText; поля индексируются всегда.
124
+ if (allowText)
125
+ bodyLines.push(line);
118
126
  const fields = extractFields(line);
119
127
  if (fields.length > 0) {
120
128
  if (currentItem)
@@ -123,8 +131,43 @@ export function parseMarkdown(content) {
123
131
  result.inlineList.push(...fields);
124
132
  }
125
133
  }
126
- if (currentItem)
134
+ if (allowText && currentItem)
127
135
  currentItem.text = finishText(bodyLines);
128
136
  return result;
129
137
  }
138
+ // ---- Сериализация (структура → текст) ----
139
+ export function inlineFieldToText(field) {
140
+ return `[${field.param}:: ${field.valueList.join(', ')}]`;
141
+ }
142
+ export function levelToText(level, headingLevel) {
143
+ const hashes = '#'.repeat(headingLevel);
144
+ const idx = level.idx === null ? '' : ` ${level.idx}`;
145
+ return `${hashes} ${level.title}${idx}`;
146
+ }
147
+ /**
148
+ * Заголовок самого глубокого заданного уровня + inline-поля в ту же строку.
149
+ * Пустой топик (все уровни `null`) → `''`.
150
+ */
151
+ export function topicToText(topic) {
152
+ const deepest = topic.level3 ?? topic.level2 ?? topic.level1;
153
+ if (!deepest)
154
+ return '';
155
+ const headingLevel = topic.level3 ? 3 : topic.level2 ? 2 : 1;
156
+ const head = levelToText(deepest, headingLevel);
157
+ const fields = topic.inlineList.map(inlineFieldToText).join(' ');
158
+ return fields ? `${head} ${fields}` : head;
159
+ }
160
+ export function itemToText(item) {
161
+ const head = topicToText(item.topic);
162
+ return item.text === null ? head : `${head}\n${item.text}`;
163
+ }
164
+ /** Преамбула (по строке на поле) + элементы, склеенные через `\n`. */
165
+ export function contentToText(content) {
166
+ const parts = [];
167
+ for (const field of content.inlineList)
168
+ parts.push(inlineFieldToText(field));
169
+ for (const item of content.itemList)
170
+ parts.push(itemToText(item));
171
+ return parts.join('\n');
172
+ }
130
173
  //# sourceMappingURL=parse.js.map
package/dist/parse.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -3,32 +3,26 @@ export interface TFdInlineField {
3
3
  valueList: string[];
4
4
  }
5
5
  export interface TFdLevel {
6
+ /** Текст заголовка без `idx`. */
6
7
  title: string;
7
8
  idx: number | null;
8
9
  }
9
- /** Адресуемый узел: заголовки (1–3 уровня) + привязанные inline-поля. Без текста. */
10
- export interface TFdContentTopic {
10
+ /** Адресуемый узел: заголовки 1–3 уровней + привязанные inline-поля. Без текста. */
11
+ export interface TFdTopic {
11
12
  level1: TFdLevel | null;
12
13
  level2: TFdLevel | null;
13
14
  level3: TFdLevel | null;
14
15
  inlineList: TFdInlineField[];
15
16
  }
16
- /** Элемент контента: узел (topic) + необязательное тело раздела. */
17
- export interface TFdContentItem {
18
- topic: TFdContentTopic;
19
- text?: string;
17
+ /** Элемент контента: узел (topic) + тело раздела. `text: null` — тела нет. */
18
+ export interface TFdItem {
19
+ topic: TFdTopic;
20
+ text: string | null;
20
21
  }
22
+ /** Распарсенный контент одного файла: преамбула + элементы. */
21
23
  export interface TFdContent {
22
24
  /** Преамбула: inline-поля до первого заголовка. */
23
25
  inlineList: TFdInlineField[];
24
- itemList: TFdContentItem[];
25
- }
26
- export interface FdMdFilter {
27
- list: string[];
28
- action: 'allow' | 'deny';
29
- }
30
- export interface FdMdParams {
31
- dir: string;
32
- filter?: FdMdFilter;
26
+ itemList: TFdItem[];
33
27
  }
34
28
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flowdini-spec",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "Markdown parser for flowdini specs: headings (levels 1-3) and Obsidian inline fields",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/dist/FdMd.d.ts DELETED
@@ -1,16 +0,0 @@
1
- import type { FdMdParams, TFdContent } from './types.js';
2
- export declare class FdMd {
3
- private readonly dir;
4
- private readonly filter?;
5
- private fileList;
6
- private readonly cache;
7
- constructor(params: FdMdParams);
8
- scan(): Promise<void>;
9
- getFileList(): string[];
10
- /** Кэш по `mtime + size`; ошибка чтения → пустой контент, кэш файла сбрасывается. */
11
- getContent(fileItem: string): Promise<TFdContent>;
12
- /** micromatch против относительного пути: `*` не пересекает `/`, `**` — пересекает; регистрозависимо. */
13
- private applyFilter;
14
- private walk;
15
- }
16
- //# sourceMappingURL=FdMd.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"FdMd.d.ts","sourceRoot":"","sources":["../src/FdMd.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAYrE,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;gBAE3C,MAAM,EAAE,UAAU;IAKxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,WAAW,IAAI,MAAM,EAAE;IAIvB,qFAAqF;IAC/E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCvD,yGAAyG;IACzG,OAAO,CAAC,WAAW;YAUL,IAAI;CAoBnB"}
package/dist/FdMd.js DELETED
@@ -1,91 +0,0 @@
1
- import { promises as fs } from 'node:fs';
2
- import * as path from 'node:path';
3
- import micromatch from 'micromatch';
4
- import { parseMarkdown } from './parse.js';
5
- function emptyContent() {
6
- return { inlineList: [], itemList: [] };
7
- }
8
- export class FdMd {
9
- dir;
10
- filter;
11
- fileList = [];
12
- cache = new Map();
13
- constructor(params) {
14
- this.dir = path.resolve(params.dir);
15
- this.filter = params.filter;
16
- }
17
- async scan() {
18
- const absFiles = await this.walk(this.dir);
19
- const relFiles = absFiles
20
- .map((f) => path.relative(this.dir, f).split(path.sep).join('/'))
21
- .sort();
22
- this.fileList = this.applyFilter(relFiles);
23
- this.cache.clear();
24
- }
25
- getFileList() {
26
- return [...this.fileList];
27
- }
28
- /** Кэш по `mtime + size`; ошибка чтения → пустой контент, кэш файла сбрасывается. */
29
- async getContent(fileItem) {
30
- const fullPath = path.resolve(this.dir, fileItem);
31
- let mtimeMs;
32
- let size;
33
- try {
34
- const stat = await fs.stat(fullPath);
35
- mtimeMs = stat.mtimeMs;
36
- size = stat.size;
37
- }
38
- catch {
39
- this.cache.delete(fileItem);
40
- return emptyContent();
41
- }
42
- const cached = this.cache.get(fileItem);
43
- if (cached && cached.mtimeMs === mtimeMs && cached.size === size) {
44
- return cached.content;
45
- }
46
- let content;
47
- try {
48
- const text = await fs.readFile(fullPath, 'utf8');
49
- content = parseMarkdown(text);
50
- }
51
- catch {
52
- this.cache.delete(fileItem);
53
- return emptyContent();
54
- }
55
- this.cache.set(fileItem, { mtimeMs, size, content });
56
- return content;
57
- }
58
- /** micromatch против относительного пути: `*` не пересекает `/`, `**` — пересекает; регистрозависимо. */
59
- applyFilter(relFiles) {
60
- if (!this.filter)
61
- return relFiles;
62
- const { list, action } = this.filter;
63
- const matches = (p) => list.some((pat) => micromatch.isMatch(p, pat));
64
- if (action === 'allow')
65
- return relFiles.filter(matches);
66
- return relFiles.filter((p) => !matches(p));
67
- }
68
- async walk(dir) {
69
- let entries;
70
- try {
71
- entries = await fs.readdir(dir, { withFileTypes: true });
72
- }
73
- catch {
74
- return [];
75
- }
76
- const out = [];
77
- for (const entry of entries) {
78
- if (entry.name.startsWith('.'))
79
- continue;
80
- const full = path.join(dir, entry.name);
81
- if (entry.isDirectory()) {
82
- out.push(...(await this.walk(full)));
83
- }
84
- else if (entry.isFile() && entry.name.endsWith('.md')) {
85
- out.push(full);
86
- }
87
- }
88
- return out;
89
- }
90
- }
91
- //# sourceMappingURL=FdMd.js.map
package/dist/FdMd.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"FdMd.js","sourceRoot":"","sources":["../src/FdMd.ts"],"names":[],"mappings":"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"}