md2gost 1.3.2 → 1.4.1

package/CHANGELOG.md

@@ -13,6 +13,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### Fixed
 ### Security
 
+## [1.4.1] - 2026-09-07
+### Fixed
+- fix bug with image size (rem dev code from prev release)
+
+## [1.4.0] - 2026-09-06
+### Added
+- totalPagesOffset property of Doc to modify TOTAL_PAGES field value (`!!rule` isn't implemented yet)
+- make render process cancellable
+- add `userInput` error code to `MDRenderError`
+- add `abortSignal` property to `MDRenderConfig`
+- add `allowExternalFiles` property to `MDRenderConfig`
+- support page orientation (`landscape`/`portrait`) and disable numbering (`unpaged`) in `!!section` directive
+### Changed
+- `!!section` directive now accepts multiple optional parameters in any order (orientation and numbering)
+### Fixed
+- fix typos in readme
+- fix `<br>` display in image title in preview
+
 ## [1.3.2] - 2026-07-12
 ### Added
 * **Directory Output Support**: `renderMarkdown` now accepts directory paths for `config.output`, auto-generating the filename from the input file with the correct extension (`.pdf`/`.docx`).

package/README.md

@@ -40,6 +40,7 @@ md2gost report.md --format pdf
 Specify an output path:
 
 ```bash
+md2gost report.md -o dist/
 md2gost report.md -o dist/report.docx
 md2gost report.md -o dist/report.pdf
 ```
@@ -237,7 +238,7 @@ Without Microsoft Word, PDF export and several advanced Word-specific features a
 ```
 ![демонстрация разницы переносов строк](https://raw.githubusercontent.com/MixelTe/md2gost/master/imgs/screenshot_linebreaks.png)
 
-Выделение с помощью обратных кавычек ``` `монотекст` ``` по умолчанию отображается как курсив. С помощью [правила](#правила) `backtick_mono` можно именить отображение:
+Выделение с помощью обратных кавычек ``` `монотекст` ``` по умолчанию отображается как курсив. С помощью [правила](#правила) `backtick_mono` можно изменить отображение:
 * `!!rule backtick_mono italic` - курсив (по умолчанию)
 
 	![backtick_mono italic](https://raw.githubusercontent.com/MixelTe/md2gost/master/imgs/backtick_mono_italic.png)
@@ -298,7 +299,7 @@ Without Microsoft Word, PDF export and several advanced Word-specific features a
 ![Рисунок 1.2 - С указанием ширины] (image.png){340}
 ![Рисунок 1.3 - С указанием высоты] (image.png){x265}
 ![Рисунок 1.4 - С указанием размера] (image.png){340x265}
-![Рисунок 1.5 - Важные зарисовки, с очень длинным названием, \nкоторое не умещается в одну строку] (image.png){340}
+![Рисунок 1.5 - Важные зарисовки, с очень длинным названием, <br>которое не умещается в одну строку] (image.png){340}
 ```
 
 
@@ -386,19 +387,44 @@ Without Microsoft Word, PDF export and several advanced Word-specific features a
 
 ### Разрыв раздела
 
-Создаёт разрыв раздела в документе:
+Вставляет разрыв раздела и задаёт параметры форматирования для следующей страницы: ориентацию листа и логику нумерации.
 
+**Синтаксис:**
+
+```text
+!!section [ориентация] [нумерация]
 ```
+
+Параметры не зависят от порядка следования и являются необязательными. Если параметр не указан, раздел сохраняет настройки предыдущей страницы.
+
+**Параметры:**
+
+| Параметр | Значения | Описание |
+| --- | --- | --- |
+| **Ориентация** | `landscape`<br>`portrait` | Устанавливает альбомную или книжную ориентацию листа. |
+| **Нумерация** | `from <N>`<br>`unpaged` | Сбрасывает счетчик страниц на число `N` либо полностью отключает нумерацию на страницах раздела. |
+
+**Примеры использования:**
+
+```text
 !!section
-Раздел без нумерации страниц
+Раздел с параметрами предыдущей страницы
+
+!!section landscape
+Альбомная ориентация (сквозная нумерация сохраняется)
+
+!!section portrait
+Возврат к книжной ориентации
 
 !!section from 3
-Раздел с нумерацией страниц начиная с 3
-```
+Нумерация страниц начинается заново с 3
 
-Различия:
-* `---` – просто разрыв страницы без влияния на нумерацию.
-* `!!section` – начинает новую страницу и **сбрасывает нумерацию**.
+!!section unpaged
+Страницы раздела не нумеруются
+
+!!section landscape from 3
+Альбомная ориентация с нумерацией с 3-й страницы
+```
 
 ### Автонумерация
 Система автонумерации автоматически нумерует элементы документа (разделы, рисунки, таблицы, листинги, источники) и позволяет ссылаться на них из текста.

package/assets/run.ps1

@@ -27,10 +27,19 @@ $MacroTemplate = [System.IO.Path]::GetFullPath($MacroTemplate)
 
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8;
 
+# Take a snapshot of currently running Word instances
+$existingPids = @(Get-Process WINWORD -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Id)
+
 $word = New-Object -ComObject Word.Application
 $word.Visible = $false
 $word.DisplayAlerts = 0
 
+# Find the new Word instance and print its PID for Node.js
+$newWord = Get-Process WINWORD -ErrorAction SilentlyContinue | Where-Object { $_.Id -notin $existingPids }
+if ($newWord) {
+    Write-Host "[WordPID:$($newWord[0].Id)]"
+}
+
 try {
     # Подключаем глобальный шаблон
     $word.AddIns.Add($MacroTemplate, $true)
@@ -56,6 +65,10 @@ try {
 	Write-Host "Done: $OutputDoc"
 }
 finally {
-    $word.Quit()
-    [System.Runtime.InteropServices.Marshal]::ReleaseComObject($word) | Out-Null
+    try {
+        $word.Quit()
+    } catch {}
+    try {
+        [System.Runtime.InteropServices.Marshal]::ReleaseComObject($word) | Out-Null
+    } catch {}
 }

package/dist/index.d.ts

@@ -29,12 +29,39 @@ export interface MDRenderConfig {
 	 * @defaultValue `false`
 	 */
 	disableMacros?: boolean;
+	/**
+	 * DOES NOT WORK!
+	 * @experimental
+	 */
+	useLibreOffice?: boolean;
+	/**
+	 * Maps internal outputs to specific log levels:
+	 * - **info**: Shadows {@link progress} and info in {@link MDRenderError.powershellLog}
+	 * - **warn**: Shadows {@link MDRenderResult.warnings} (and {@link MDRenderError.warnings})
+	 * - **error**: Shadows errors in {@link MDRenderError.powershellLog}
+	 */
+	logger?: {
+		info: (msg: string) => void;
+		warn: (msg: string) => void;
+		error: (msg: string) => void;
+	};
 	/**
 	 * Optional callback function triggered periodically to report the total rendering progress.
 	 * @param totalPercent - The total calculated completion progress, clamped between 0 and 100.
 	 * @param message - A human-readable description of the active step.
 	 */
 	progress?: (totalPercent: number, message: string) => void;
+	/**
+	 * Optional `AbortSignal` used to cancel the rendering process.
+	 */
+	abortSignal?: AbortSignal;
+	/**
+	 * When `true`, permits referencing external assets (e.g. images or `include` documents)
+	 * that resolve outside the source file's working directory.
+	 * @note When `false`, accessing any path outside the working directory throws a `userInput` error.
+	 * @defaultValue `false`
+	 */
+	allowExternalFiles?: boolean;
 }
 /**
  * The successful result of a Markdown rendering operation.
@@ -84,7 +111,7 @@ export interface MDRenderResult {
  * 		if (error.cause)
  * 			console.error("Root cause:", error.cause);
  *
- * 		result.warnings.forEach(w => console.warn(`[W] ${w}`));
+ * 		error.warnings.forEach(w => console.warn(`[W] ${w}`));
  *
  * 		if (error.code.endsWith("PS") && error.powershellLog.length > 0)
  * 			console.error("PowerShell Logs:\n", error.powershellLog.join(""));
@@ -96,7 +123,7 @@ export interface MDRenderResult {
  */
 declare function renderMarkdown(config: MDRenderConfig): Promise<MDRenderResult>;
 /** Error codes identifying unique failure points in the compilation. */
-export type MDRenderErrorCode = "unknown" | "noPS" | "inPS" | "vba" | "pdf" | "noWin";
+export type MDRenderErrorCode = "unknown" | "userInput" | "noPS" | "inPS" | "vba" | "pdf" | "noWin";
 /**
  * Custom error thrown when compilation or rendering fails.
  * Captures historical console buffers, partial file states, and downstream environment warnings.
@@ -109,6 +136,7 @@ export declare class MDRenderError extends Error {
 	/**
 	 * Code indicating the underlying cause of the failure:
 	 * - `unknown`: An unhandled or unexpected internal runtime error.
+	 * - `userInput`: Invalid user input or Markdown document structure.
 	 * - `noPS`: PowerShell could not be started or found in the system PATH.
 	 * - `inPS`: A failure occurred inside PowerShell; MS Word may be missing or corrupt.
 	 * - `vba`: An error occurred during the execution of internal Word VBA macros.