@wasmsoft/fantastic 1.0.0

package/dist/packaging/layout.d.ts

@@ -0,0 +1,153 @@
+export declare const BUNDLE_DIRS: {
+    /** ما لا نكتبه ونشحنه: العُقدة وأدوات الوسائط. */
+    readonly runtime: "runtime";
+    readonly core: "core";
+    readonly live: "live";
+    /**
+     * AR: **المُشرِف وحده، لا الواجهة** (٠٢٦).
+     *
+     *     كان هنا ‎cli\‎: الواجهة كاملةً بشجرة اعتمادياتها (٠١٨)، ‎34‎ ميغابايت مقيسة. وقد خرجت إلى
+     *     سِجلّ الحزم لأن عمرها مختلفٌ عن عمر المنتج — إصلاح سطرٍ فيها كان يكلّف إعادة تحزيمٍ
+     *     وإعادة تثبيت.
+     *
+     *     **وبقي المُشرِف لسببٍ واحد لا يقبل بديلًا**: مهمّة الإقلاع في جدولة ويندوز تناديه بمسارٍ
+     *     مطلق، وتعمل بلا إنسانٍ أمام الجهاز بعد انقطاع الكهرباء، وبحسابٍ قد يكون ‎SYSTEM‎ أو حساب
+     *     فنّيٍّ آخر. وتوجيهها إلى الواجهة العالمية يعني ‎%AppData%\Roaming\npm‎ الخاصّ **بمستخدمٍ
+     *     بعينه** — مسارٌ لا يجده حسابٌ آخر، في المسار الذي لا يقرأ أحدٌ فيه رسالة خطأ.
+     *
+     *     ويعمل على ‎runtime\‎ المشحون كبقيّة الخدمات، فقاعدة العزل تبقى مفروضةً حيث تخدم مشاهدًا.
+     * EN: **The supervisor alone, not the CLI** (026).
+     *
+     *     This used to be `cli\`: the whole CLI with its dependency tree (018), a measured 34 MB. It
+     *     moved to a package registry because its life cycle differs from the product's — fixing a
+     *     line in it used to cost a repack and a reinstall.
+     *
+     *     **The supervisor stayed for one reason that admits no alternative**: the Windows scheduled
+     *     task calls it by an absolute path, runs with nobody at the machine after a power cut, and
+     *     may run as `SYSTEM` or as another technician's account. Pointing it at the global CLI means
+     *     `%AppData%\Roaming\npm` belonging to **one particular user** — a path another account cannot
+     *     find, on the path where nobody is present to read an error.
+     *
+     *     It runs on the shipped `runtime\` like every service, so the isolation rule stays enforced
+     *     wherever a viewer is served.
+     */
+    readonly supervisor: "supervisor";
+    /**
+     * AR: الشيمة وحدها. **مجلد لا يحوي إلّا ‎fantastic.cmd‎ لأنه وحده ما يُعرَض على PATH** — ووضعها في
+     *     جذر التثبيت كان سيفرض عرض الجذر كلّه، وفيه ‎data\‎ و‎logs\‎ (القرار D-018-04).
+     * EN: The shim alone. **A directory holding nothing but `fantastic.cmd`, because it alone goes on
+     *     PATH** — putting the shim in the install root would have meant exposing the whole root, which
+     *     contains data\ and logs\ (decision D-018-04).
+     */
+    readonly bin: "bin";
+    /** الواجهة ملفات ثابتة تقدّمها النواة عبر ‎PORTAL_DIST‎. */
+    readonly interfaceRoot: "interface";
+    readonly interfaceClient: string;
+    /** مِلك العميل. لا تلمسه عملية تلقائية. */
+    readonly data: "data";
+    readonly logs: "logs";
+    readonly run: "run";
+    readonly updates: "updates";
+};
+export declare const MANIFEST_FILE: string;
+/** أسماء ثابتة داخل ‎runtime/‎: ملفّ التشغيل يعتمد عليها حرفيًا. */
+export declare const RUNTIME_FILES: {
+    readonly node: "node.exe";
+    readonly ffmpeg: "ffmpeg.exe";
+    readonly ffprobe: "ffprobe.exe";
+};
+/** مدخل كل خدمة داخل حزمتها، نسبةً إلى جذر التثبيت. */
+export declare const SERVICE_ENTRY: {
+    readonly core: string;
+    readonly live: string;
+};
+/**
+ * AR: مدخل المُشرِف المشحون، نسبةً إلى جذر الحزمة. تقرؤه الشيمة والإقلاع التجريبي معًا.
+ *
+ *     كان ‎cli\bin\run.js‎ حتى ٠٢٦، حين خرجت الواجهة من الحزمة. والاسم تغيّر مع ما يشير إليه:
+ *     ثابتٌ اسمه ‎CLI_ENTRY‎ يشير إلى مُشرِف يكذب على قارئه بعد سنة.
+ * EN: The shipped supervisor's entry point, relative to the bundle root. Read by the shim and the
+ *     smoke boot alike.
+ *
+ *     It was `cli\bin\run.js` until 026, when the CLI left the bundle. The name changed with what it
+ *     points at: a constant called `CLI_ENTRY` aiming at a supervisor lies to its reader a year on.
+ */
+export declare const SUPERVISOR_ENTRY: string;
+/**
+ * AR: أسماء الشيمات. ‎.cmd‎ لا ‎.ps1‎: سياسة ويندوز الافتراضية ‎Restricted‎ تمنع الثانية، وقد قِيس
+ *     ذلك ميدانيًّا — ورفع السياسة تغييرٌ في أمان جهاز العميل لا يجوز أن يكون ثمن تثبيت منتجنا
+ *     (القرار D-018-03). و‎.cmd‎ تعمل في PowerShell و cmd معًا.
+ * EN: The shim names. `.cmd` and not `.ps1`: Windows' default `Restricted` policy blocks the latter,
+ *     as measured in the field — and raising the policy is a change to the customer's machine
+ *     security that must not be the price of installing our product (decision D-018-03). A `.cmd`
+ *     works in both PowerShell and cmd.
+ */
+export declare const SHIM_FILES: {
+    /**
+     * AR: في ‎bin\‎ بعد التثبيت: تناديه **مهمّة الإقلاع** فيصل إلى المُشرِف المشحون.
+     *
+     *     كان اسمه يصف ما كانه: الأمر ‎fantastic‎ العامّ الذي يكتبه الفنّي. وقد صار الفنّي يصل إلى
+     *     الحزمة العالمية (٠٢٦)، وبقي الملفّ باسمه لأن **مهمّةً مسجَّلة على أجهزة عملاء تشير إليه
+     *     بهذا الاسم**: تغييرُه يعني جهازًا لا تعود خدماته بعد انقطاع كهرباء، ومهمّةً تشير إلى ملفٍّ
+     *     لا وجود له، ولا أحد أمام الشاشة ليقرأ الخطأ.
+     * EN: In `bin\` after installation: the **boot task** calls it, and it reaches the shipped
+     *     supervisor.
+     *
+     *     Its name used to describe what it was: the global `fantastic` command a technician typed.
+     *     The technician now reaches the globally installed package (026), and the file kept its name
+     *     because **tasks registered on customers' machines point at it by that name**: renaming it
+     *     means an appliance whose services do not come back after a power cut, a task aiming at a
+     *     file that does not exist, and nobody at the screen to read the error.
+     */
+    readonly command: "fantastic.cmd";
+};
+/**
+ * الإضافات الأصلية التي **يجب** أن توجد في شجرة اعتماديات كل خدمة.
+ *
+ * غيابها لا يُفشل البناء ولا بدء العملية: يظهر عند أول استعلام قاعدة أو أول مصغّرة — أي عند العميل.
+ * لذلك تُفحَص صراحةً قبل الأرشفة (017/FR-019).
+ */
+export declare const REQUIRED_NATIVE: {
+    readonly core: readonly [string, string];
+    readonly live: readonly [string];
+};
+/** حِزَم المستودع الداخلية. تُنسَخ نسخًا فعليًا لأن الوصلة الرمزية تنكسر عند النقل. */
+/**
+ * AR: حِزَم هذا المستودع. **تُحذَف من قائمة التثبيت وتُنسَخ يدويًا بعده** — ليست على السِّجل
+ *     العامّ، فمحاولةُ تثبيتها ترجع ‎404‎.
+ *
+ *     **و‎license-protocol‎ كانت ناقصة من هنا، فتوقّف بناء الحزم كلّه.** أُضيفت إلى اعتماديات
+ *     النواة في P4.2 ولم تُسجَّل في هذه القائمة، فصار `fantastic bundle` يفشل عند تثبيت
+ *     اعتماديات النواة بـ‎404 @fantastic/license-protocol‎ — أي أن **آخر حزمة أُنتجت كانت قبل
+ *     وصول الترخيص**، ولا شيء يستطيع أن يصل عميلًا. وُجد بمحاولة بناء حزمة في P5.4، ولم يكن
+ *     ليظهر بغير محاولة البناء: الاختبارات والـ‎typecheck‎ كلّها تمرّ لأن الوصلة الرمزية في
+ *     المستودع تعمل تمامًا.
+ *
+ *     أيّ حزمة تُضاف إلى ‎packages/‎ وتصير اعتمادًا لخدمة **يجب أن تُسجَّل هنا في نفس الالتزام**.
+ * EN: This repository's own packages. **Removed from the install list and copied in afterwards** —
+ *     they are not on the public registry, so trying to install them returns `404`.
+ *
+ *     **`license-protocol` was missing from here, and it stopped bundle builds entirely.** It was
+ *     added to the core's dependencies in P4.2 and never registered in this list, so
+ *     `fantastic bundle` failed installing the core's dependencies with
+ *     `404 @fantastic/license-protocol` — meaning **the last bundle ever produced predates
+ *     licensing**, and nothing could reach a customer. Found by attempting a bundle in P5.4, and it
+ *     could not have surfaced any other way: tests and typecheck all pass because the workspace
+ *     symlink works perfectly in the repository.
+ *
+ *     Any package added to `packages/` that becomes a service dependency **must be registered here
+ *     in the same commit**.
+ */
+export declare const WORKSPACE_PACKAGES: readonly ["@fantastic/shared-types", "@fantastic/token-codec", "@fantastic/license-protocol"];
+/**
+ * حِزَم تُستبعَد من شجرة الإنتاج لأن الحزمة تشحن محتواها في مكان آخر.
+ *
+ * **قِيس في 017/T034:** حزمتا مُثبِّت ffmpeg/ffprobe اعتماديّتان للنواة ولخدمة البث معًا، فكانت
+ * الثنائيّات تُشحن **ثلاث مرّات** — 140 ميغابايت في شجرة كل خدمة و139 في ‎runtime/‎، أي 419 لملفّات
+ * يلزم منها نسخة واحدة. مجموع اعتماديات الإنتاج كان 393 ميغابايت مقابل تقدير 70–90 في الخطة.
+ *
+ * تُستبعَد هنا، وتُضبَط ‎FFMPEG_PATH‎ و‎FFPROBE_PATH‎ على نسخة ‎runtime/‎، وكلا الخدمتين ترجع إلى
+ * حزمة المُثبِّت إن لم يُضبَط المتغيّر — فلا ينكسر التطوير في المستودع.
+ */
+export declare const EXCLUDED_FROM_BUNDLE: readonly ["@ffmpeg-installer/ffmpeg", "@ffprobe-installer/ffprobe"];
+//# sourceMappingURL=layout.d.ts.map

package/dist/packaging/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/packaging/layout.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW;IACtB,kDAAkD;;;;IAIlD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;;IAEH;;;;;;OAMG;;IAEH,4DAA4D;;;IAG5D,2CAA2C;;;;;CAKnC,CAAC;AAEX,eAAO,MAAM,aAAa,QAA6C,CAAC;AAExE,oEAAoE;AACpE,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAuD,CAAC;AAErF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;IACrB;;;;;;;;;;;;;;;OAeG;;CAEK,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;CAMlB,CAAC;AAEX,uFAAuF;AACvF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,kBAAkB,+FAIrB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,qEAAsE,CAAC"}

package/dist/packaging/layout.js

@@ -0,0 +1,168 @@
+import { join } from "node:path";
+// AR: تخطيط الحزمة كما نصّت عليه المعمارية v3 §09، **في مكان واحد**. كل خطوة في خطّ الأنابيب وكل
+//     أمر تثبيت يقرأ من هنا، فلا يُكتب اسم مجلد مرتين ولا ينحرف المُنتِج عن المستهلك.
+//     ‎appliance.profile.ts‎ يشير إلى نفس هذه المواضع؛ إن تغيّر أحدهما وجب أن يتغيّر الآخر.
+// EN: The bundle layout from architecture v3 §09, **in one place**. Every pipeline step and every
+//     install command reads it from here, so no directory name is written twice and the producer
+//     cannot drift from the consumer. appliance.profile.ts points at these same locations; if one
+//     changes, the other must.
+export const BUNDLE_DIRS = {
+    /** ما لا نكتبه ونشحنه: العُقدة وأدوات الوسائط. */
+    runtime: "runtime",
+    core: "core",
+    live: "live",
+    /**
+     * AR: **المُشرِف وحده، لا الواجهة** (٠٢٦).
+     *
+     *     كان هنا ‎cli\‎: الواجهة كاملةً بشجرة اعتمادياتها (٠١٨)، ‎34‎ ميغابايت مقيسة. وقد خرجت إلى
+     *     سِجلّ الحزم لأن عمرها مختلفٌ عن عمر المنتج — إصلاح سطرٍ فيها كان يكلّف إعادة تحزيمٍ
+     *     وإعادة تثبيت.
+     *
+     *     **وبقي المُشرِف لسببٍ واحد لا يقبل بديلًا**: مهمّة الإقلاع في جدولة ويندوز تناديه بمسارٍ
+     *     مطلق، وتعمل بلا إنسانٍ أمام الجهاز بعد انقطاع الكهرباء، وبحسابٍ قد يكون ‎SYSTEM‎ أو حساب
+     *     فنّيٍّ آخر. وتوجيهها إلى الواجهة العالمية يعني ‎%AppData%\Roaming\npm‎ الخاصّ **بمستخدمٍ
+     *     بعينه** — مسارٌ لا يجده حسابٌ آخر، في المسار الذي لا يقرأ أحدٌ فيه رسالة خطأ.
+     *
+     *     ويعمل على ‎runtime\‎ المشحون كبقيّة الخدمات، فقاعدة العزل تبقى مفروضةً حيث تخدم مشاهدًا.
+     * EN: **The supervisor alone, not the CLI** (026).
+     *
+     *     This used to be `cli\`: the whole CLI with its dependency tree (018), a measured 34 MB. It
+     *     moved to a package registry because its life cycle differs from the product's — fixing a
+     *     line in it used to cost a repack and a reinstall.
+     *
+     *     **The supervisor stayed for one reason that admits no alternative**: the Windows scheduled
+     *     task calls it by an absolute path, runs with nobody at the machine after a power cut, and
+     *     may run as `SYSTEM` or as another technician's account. Pointing it at the global CLI means
+     *     `%AppData%\Roaming\npm` belonging to **one particular user** — a path another account cannot
+     *     find, on the path where nobody is present to read an error.
+     *
+     *     It runs on the shipped `runtime\` like every service, so the isolation rule stays enforced
+     *     wherever a viewer is served.
+     */
+    supervisor: "supervisor",
+    /**
+     * AR: الشيمة وحدها. **مجلد لا يحوي إلّا ‎fantastic.cmd‎ لأنه وحده ما يُعرَض على PATH** — ووضعها في
+     *     جذر التثبيت كان سيفرض عرض الجذر كلّه، وفيه ‎data\‎ و‎logs\‎ (القرار D-018-04).
+     * EN: The shim alone. **A directory holding nothing but `fantastic.cmd`, because it alone goes on
+     *     PATH** — putting the shim in the install root would have meant exposing the whole root, which
+     *     contains data\ and logs\ (decision D-018-04).
+     */
+    bin: "bin",
+    /** الواجهة ملفات ثابتة تقدّمها النواة عبر ‎PORTAL_DIST‎. */
+    interfaceRoot: "interface",
+    interfaceClient: join("interface", "client"),
+    /** مِلك العميل. لا تلمسه عملية تلقائية. */
+    data: "data",
+    logs: "logs",
+    run: "run",
+    updates: "updates",
+};
+export const MANIFEST_FILE = join(BUNDLE_DIRS.updates, "versions.json");
+/** أسماء ثابتة داخل ‎runtime/‎: ملفّ التشغيل يعتمد عليها حرفيًا. */
+export const RUNTIME_FILES = {
+    node: "node.exe",
+    ffmpeg: "ffmpeg.exe",
+    ffprobe: "ffprobe.exe",
+};
+/** مدخل كل خدمة داخل حزمتها، نسبةً إلى جذر التثبيت. */
+export const SERVICE_ENTRY = {
+    core: join(BUNDLE_DIRS.core, "main.js"),
+    live: join(BUNDLE_DIRS.live, "main.js"),
+};
+/**
+ * AR: مدخل المُشرِف المشحون، نسبةً إلى جذر الحزمة. تقرؤه الشيمة والإقلاع التجريبي معًا.
+ *
+ *     كان ‎cli\bin\run.js‎ حتى ٠٢٦، حين خرجت الواجهة من الحزمة. والاسم تغيّر مع ما يشير إليه:
+ *     ثابتٌ اسمه ‎CLI_ENTRY‎ يشير إلى مُشرِف يكذب على قارئه بعد سنة.
+ * EN: The shipped supervisor's entry point, relative to the bundle root. Read by the shim and the
+ *     smoke boot alike.
+ *
+ *     It was `cli\bin\run.js` until 026, when the CLI left the bundle. The name changed with what it
+ *     points at: a constant called `CLI_ENTRY` aiming at a supervisor lies to its reader a year on.
+ */
+export const SUPERVISOR_ENTRY = join(BUNDLE_DIRS.supervisor, "bin", "supervisor.js");
+/**
+ * AR: أسماء الشيمات. ‎.cmd‎ لا ‎.ps1‎: سياسة ويندوز الافتراضية ‎Restricted‎ تمنع الثانية، وقد قِيس
+ *     ذلك ميدانيًّا — ورفع السياسة تغييرٌ في أمان جهاز العميل لا يجوز أن يكون ثمن تثبيت منتجنا
+ *     (القرار D-018-03). و‎.cmd‎ تعمل في PowerShell و cmd معًا.
+ * EN: The shim names. `.cmd` and not `.ps1`: Windows' default `Restricted` policy blocks the latter,
+ *     as measured in the field — and raising the policy is a change to the customer's machine
+ *     security that must not be the price of installing our product (decision D-018-03). A `.cmd`
+ *     works in both PowerShell and cmd.
+ */
+export const SHIM_FILES = {
+    /**
+     * AR: في ‎bin\‎ بعد التثبيت: تناديه **مهمّة الإقلاع** فيصل إلى المُشرِف المشحون.
+     *
+     *     كان اسمه يصف ما كانه: الأمر ‎fantastic‎ العامّ الذي يكتبه الفنّي. وقد صار الفنّي يصل إلى
+     *     الحزمة العالمية (٠٢٦)، وبقي الملفّ باسمه لأن **مهمّةً مسجَّلة على أجهزة عملاء تشير إليه
+     *     بهذا الاسم**: تغييرُه يعني جهازًا لا تعود خدماته بعد انقطاع كهرباء، ومهمّةً تشير إلى ملفٍّ
+     *     لا وجود له، ولا أحد أمام الشاشة ليقرأ الخطأ.
+     * EN: In `bin\` after installation: the **boot task** calls it, and it reaches the shipped
+     *     supervisor.
+     *
+     *     Its name used to describe what it was: the global `fantastic` command a technician typed.
+     *     The technician now reaches the globally installed package (026), and the file kept its name
+     *     because **tasks registered on customers' machines point at it by that name**: renaming it
+     *     means an appliance whose services do not come back after a power cut, a task aiming at a
+     *     file that does not exist, and nobody at the screen to read the error.
+     */
+    command: "fantastic.cmd",
+};
+/**
+ * الإضافات الأصلية التي **يجب** أن توجد في شجرة اعتماديات كل خدمة.
+ *
+ * غيابها لا يُفشل البناء ولا بدء العملية: يظهر عند أول استعلام قاعدة أو أول مصغّرة — أي عند العميل.
+ * لذلك تُفحَص صراحةً قبل الأرشفة (017/FR-019).
+ */
+export const REQUIRED_NATIVE = {
+    core: [
+        join("@libsql", "win32-x64-msvc", "index.node"),
+        join("@img", "sharp-win32-x64"),
+    ],
+    live: [join("@libsql", "win32-x64-msvc", "index.node")],
+};
+/** حِزَم المستودع الداخلية. تُنسَخ نسخًا فعليًا لأن الوصلة الرمزية تنكسر عند النقل. */
+/**
+ * AR: حِزَم هذا المستودع. **تُحذَف من قائمة التثبيت وتُنسَخ يدويًا بعده** — ليست على السِّجل
+ *     العامّ، فمحاولةُ تثبيتها ترجع ‎404‎.
+ *
+ *     **و‎license-protocol‎ كانت ناقصة من هنا، فتوقّف بناء الحزم كلّه.** أُضيفت إلى اعتماديات
+ *     النواة في P4.2 ولم تُسجَّل في هذه القائمة، فصار `fantastic bundle` يفشل عند تثبيت
+ *     اعتماديات النواة بـ‎404 @fantastic/license-protocol‎ — أي أن **آخر حزمة أُنتجت كانت قبل
+ *     وصول الترخيص**، ولا شيء يستطيع أن يصل عميلًا. وُجد بمحاولة بناء حزمة في P5.4، ولم يكن
+ *     ليظهر بغير محاولة البناء: الاختبارات والـ‎typecheck‎ كلّها تمرّ لأن الوصلة الرمزية في
+ *     المستودع تعمل تمامًا.
+ *
+ *     أيّ حزمة تُضاف إلى ‎packages/‎ وتصير اعتمادًا لخدمة **يجب أن تُسجَّل هنا في نفس الالتزام**.
+ * EN: This repository's own packages. **Removed from the install list and copied in afterwards** —
+ *     they are not on the public registry, so trying to install them returns `404`.
+ *
+ *     **`license-protocol` was missing from here, and it stopped bundle builds entirely.** It was
+ *     added to the core's dependencies in P4.2 and never registered in this list, so
+ *     `fantastic bundle` failed installing the core's dependencies with
+ *     `404 @fantastic/license-protocol` — meaning **the last bundle ever produced predates
+ *     licensing**, and nothing could reach a customer. Found by attempting a bundle in P5.4, and it
+ *     could not have surfaced any other way: tests and typecheck all pass because the workspace
+ *     symlink works perfectly in the repository.
+ *
+ *     Any package added to `packages/` that becomes a service dependency **must be registered here
+ *     in the same commit**.
+ */
+export const WORKSPACE_PACKAGES = [
+    "@fantastic/shared-types",
+    "@fantastic/token-codec",
+    "@fantastic/license-protocol",
+];
+/**
+ * حِزَم تُستبعَد من شجرة الإنتاج لأن الحزمة تشحن محتواها في مكان آخر.
+ *
+ * **قِيس في 017/T034:** حزمتا مُثبِّت ffmpeg/ffprobe اعتماديّتان للنواة ولخدمة البث معًا، فكانت
+ * الثنائيّات تُشحن **ثلاث مرّات** — 140 ميغابايت في شجرة كل خدمة و139 في ‎runtime/‎، أي 419 لملفّات
+ * يلزم منها نسخة واحدة. مجموع اعتماديات الإنتاج كان 393 ميغابايت مقابل تقدير 70–90 في الخطة.
+ *
+ * تُستبعَد هنا، وتُضبَط ‎FFMPEG_PATH‎ و‎FFPROBE_PATH‎ على نسخة ‎runtime/‎، وكلا الخدمتين ترجع إلى
+ * حزمة المُثبِّت إن لم يُضبَط المتغيّر — فلا ينكسر التطوير في المستودع.
+ */
+export const EXCLUDED_FROM_BUNDLE = ["@ffmpeg-installer/ffmpeg", "@ffprobe-installer/ffprobe"];
+//# sourceMappingURL=layout.js.map

package/dist/packaging/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/packaging/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,iGAAiG;AACjG,sFAAsF;AACtF,4FAA4F;AAC5F,kGAAkG;AAClG,iGAAiG;AACjG,kGAAkG;AAClG,+BAA+B;AAE/B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kDAAkD;IAClD,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,EAAE,YAAY;IACxB;;;;;;OAMG;IACH,GAAG,EAAE,KAAK;IACV,4DAA4D;IAC5D,aAAa,EAAE,WAAW;IAC1B,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC5C,2CAA2C;IAC3C,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAExE,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;CACd,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;IACvC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,eAAe;CAChB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE;QACJ,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAY,CAAC;QAC/C,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC;KAChC;IACD,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;CAC/C,CAAC;AAEX,uFAAuF;AACvF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,yBAAyB;IACzB,wBAAwB;IACxB,6BAA6B;CACrB,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,0BAA0B,EAAE,4BAA4B,CAAU,CAAC"}

package/dist/packaging/machine-path.d.ts

@@ -0,0 +1,52 @@
+export interface MachinePathValue {
+    /** القيمة كما هي في السِّجل، **غير مُوسَّعة**. */
+    raw: string;
+    /** ‎ExpandString‎ عادةً. يُعاد كما هو حتى لا نغيّر نوع قيمة لم نُنشئها. */
+    kind: string;
+}
+/**
+ * AR: يفكّ قيمة PATH إلى مُدخلاتها. الفاصلة المنقوطة فاصل، والمدخلات الفارغة تُسقَط: قيمة تنتهي
+ *     بفاصلة منقوطة شائعة جدًّا، وإبقاء الفراغ ينتج مُدخلًا يعني «المجلد الحالي» — ثغرة معروفة.
+ * EN: Splits a PATH value into its entries. Semicolon separates, and empty entries are dropped: a
+ *     value ending in a semicolon is very common, and keeping the blank yields an entry meaning "the
+ *     current directory" — a well-known hazard.
+ */
+export declare function pathEntries(value: string): string[];
+export declare function pathContains(value: string, entry: string): boolean;
+/**
+ * AR: القيمة بعد الإضافة، أو ‎null‎ إن كان المُدخَل موجودًا فلا كتابة أصلًا. الإضافة في **النهاية**:
+ *     مُدخَلٌ في المقدّمة يسبق أدوات النظام ويحجب ما يشبهه اسمًا، وليس لنا حقّ في ذلك على جهاز لا
+ *     نملكه.
+ * EN: The value after adding, or `null` when the entry is already present so nothing is written at
+ *     all. Appended at **the end**: an entry at the front precedes the system's own tools and shadows
+ *     anything sharing a name, which is not our right on a machine we do not own.
+ */
+export declare function addToPath(value: string, entry: string): string | null;
+/**
+ * AR: القيمة بعد الإزالة، أو ‎null‎ إن لم يكن موجودًا. يُزيل كل نسخة منه — تثبيتات سابقة قد تكون
+ *     خلّفت مكرّرات قبل أن يوجد فحص التكرار.
+ * EN: The value after removal, or `null` when it is not present. Removes every copy — earlier
+ *     installations may have left duplicates before the duplicate check existed.
+ */
+export declare function removeFromPath(value: string, entry: string): string | null;
+/**
+ * AR: يعيد ملفّ ‎fantastic‎ الذي يفوز على PATH إن لم يكن شيمتنا، وإلّا ‎undefined‎. يقرأ PATH العملية
+ *     الحالية لا السِّجل: السؤال هو «ماذا يحدث حين يُكتب الاسم الآن»، لا «ماذا سيحدث بعد إعادة فتح».
+ * EN: Returns the `fantastic` file that wins on PATH when it is not our shim, else `undefined`. It
+ *     reads the current process's PATH rather than the registry: the question is "what happens when
+ *     the name is typed now", not "what will happen after a fresh terminal".
+ */
+export declare function findConflictingCommand(ourShim: string): string | undefined;
+/** يقرأ PATH الآلة غير مُوسَّعة، مع نوع قيمتها. ‎undefined‎ على غير ويندوز أو عند تعذّر القراءة. */
+export declare function readMachinePath(): Promise<MachinePathValue | undefined>;
+export interface PathChange {
+    /** ‎true‎ إن تغيّر السِّجل فعلًا. ‎false‎ يعني «كان صحيحًا أصلًا» لا «فشل». */
+    changed: boolean;
+    detail: string;
+    backupPath?: string;
+}
+/** يُضيف مجلدًا إلى PATH الآلة إن لم يكن فيه. */
+export declare function registerOnMachinePath(entry: string, logDir: string): Promise<PathChange>;
+/** يُزيل مجلدًا من PATH الآلة إن كان فيه. جهازٌ أُزيل عنه النظام لا يبقى فيه أثرٌ ميّت. */
+export declare function unregisterFromMachinePath(entry: string, logDir: string): Promise<PathChange>;
+//# sourceMappingURL=machine-path.d.ts.map

package/dist/packaging/machine-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-path.d.ts","sourceRoot":"","sources":["../../src/packaging/machine-path.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa1E;AASD,oGAAoG;AACpG,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAuB7E;AA+DD,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmCD,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOxF;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO5F"}

package/dist/packaging/machine-path.js

@@ -0,0 +1,237 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { delimiter, join, resolve } from "node:path";
+import { execa } from "execa";
+// AR: تسجيل ‎bin\‎ في PATH الآلة وإلغاؤه (٠١٨/P3).
+//
+//     **هذا أخطر ملفّ في الميزة.** خطأٌ هنا لا يعطّل نظامنا بل الجهاز كلّه: PATH تالف يعني أن ويندوز
+//     نفسه لا يجد أدواته. لذلك كل قرار فيه محافظ بالضرورة لا بالذوق:
+//
+//     ١ — **إلحاق لا استبدال.** القيمة تُقرأ ثم يُضاف إليها، ولا تُكتب من الصفر أبدًا.
+//     ٢ — **قراءة غير مُوسَّعة.** قيمة PATH من نوع ‎REG_EXPAND_SZ‎ وتحوي مُدخلات مثل
+//         ‎%SystemRoot%\system32‎. قراءتها بالطريق المعتاد
+//         (‎[Environment]::GetEnvironmentVariable‎) تُرجعها **مُوسَّعة**، فإعادة كتابتها تُجمّد
+//         المسارات نصًّا ثابتًا: جهازٌ يُغيَّر حرف قرص نظامه أو يُرحَّل يفقد PATH صالحًا. نقرأ عبر
+//         ‎GetValue(..., DoNotExpandEnvironmentNames)‎ ونكتب بنفس نوع القيمة الأصلي.
+//     ٣ — **لا ‎setx‎ أبدًا.** يقصّ القيمة عند ١٠٢٤ محرفًا بلا إنذار، و PATH آلةٍ عاملة يتجاوزها
+//         عادةً. أداةٌ تبدو مناسبة وتُتلف بصمت.
+//     ٤ — **نسخة احتياطية قبل كل كتابة**، في ‎logs\‎، بالقيمة غير المُوسَّعة كما قُرئت. إن ساء شيء
+//         فالاسترجاع نسخٌ ولصق لا تخمين.
+// EN: Registering `bin\` in the machine PATH and removing it (018/P3).
+//
+//     **This is the most dangerous file in the feature.** A mistake here disables not our system but
+//     the whole machine: a corrupted PATH means Windows itself cannot find its own tools. So every
+//     decision in it is conservative by necessity rather than taste:
+//
+//     1 — **Append, never replace.** The value is read and added to; it is never written from scratch.
+//     2 — **Read unexpanded.** PATH is a `REG_EXPAND_SZ` holding entries like `%SystemRoot%\system32`.
+//         Reading it the usual way (`[Environment]::GetEnvironmentVariable`) returns it **expanded**,
+//         so writing it back freezes those paths into literal text: a machine whose system drive
+//         letter changes, or that is migrated, loses a working PATH. We read via
+//         `GetValue(..., DoNotExpandEnvironmentNames)` and write back with the original value kind.
+//     3 — **Never `setx`.** It truncates at 1024 characters without warning, and a working machine's
+//         PATH commonly exceeds that. A tool that looks right and corrupts silently.
+//     4 — **A backup before every write**, in `logs\`, holding the unexpanded value exactly as read.
+//         If anything goes wrong, recovery is copy-and-paste rather than guesswork.
+const ENVIRONMENT_KEY = "HKLM:\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment";
+/**
+ * AR: يفكّ قيمة PATH إلى مُدخلاتها. الفاصلة المنقوطة فاصل، والمدخلات الفارغة تُسقَط: قيمة تنتهي
+ *     بفاصلة منقوطة شائعة جدًّا، وإبقاء الفراغ ينتج مُدخلًا يعني «المجلد الحالي» — ثغرة معروفة.
+ * EN: Splits a PATH value into its entries. Semicolon separates, and empty entries are dropped: a
+ *     value ending in a semicolon is very common, and keeping the blank yields an entry meaning "the
+ *     current directory" — a well-known hazard.
+ */
+export function pathEntries(value) {
+    return value
+        .split(";")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+/**
+ * AR: هل المُدخَل موجود أصلًا؟ المقارنة بلا حساسية لحالة الأحرف وبتجاهل الشرطة الأخيرة، لأن ويندوز
+ *     يعامل ‎C:\Fantastic\bin‎ و‎c:\fantastic\bin\‎ مسارًا واحدًا — ولو قارنّا نصًّا خامًا لأضاف
+ *     التثبيت الثاني مُدخلًا مكرّرًا في كل مرّة.
+ * EN: Is the entry already there? The comparison ignores case and a trailing separator, because
+ *     Windows treats `C:\Fantastic\bin` and `c:\fantastic\bin\` as one path — and a raw text compare
+ *     would make every reinstall append yet another duplicate.
+ */
+function sameEntry(a, b) {
+    const normalise = (value) => value.replace(/[\\/]+$/, "").toLowerCase();
+    return normalise(a) === normalise(b);
+}
+export function pathContains(value, entry) {
+    return pathEntries(value).some((existing) => sameEntry(existing, entry));
+}
+/**
+ * AR: القيمة بعد الإضافة، أو ‎null‎ إن كان المُدخَل موجودًا فلا كتابة أصلًا. الإضافة في **النهاية**:
+ *     مُدخَلٌ في المقدّمة يسبق أدوات النظام ويحجب ما يشبهه اسمًا، وليس لنا حقّ في ذلك على جهاز لا
+ *     نملكه.
+ * EN: The value after adding, or `null` when the entry is already present so nothing is written at
+ *     all. Appended at **the end**: an entry at the front precedes the system's own tools and shadows
+ *     anything sharing a name, which is not our right on a machine we do not own.
+ */
+export function addToPath(value, entry) {
+    if (pathContains(value, entry))
+        return null;
+    const entries = pathEntries(value);
+    entries.push(entry);
+    return entries.join(";");
+}
+/**
+ * AR: القيمة بعد الإزالة، أو ‎null‎ إن لم يكن موجودًا. يُزيل كل نسخة منه — تثبيتات سابقة قد تكون
+ *     خلّفت مكرّرات قبل أن يوجد فحص التكرار.
+ * EN: The value after removal, or `null` when it is not present. Removes every copy — earlier
+ *     installations may have left duplicates before the duplicate check existed.
+ */
+export function removeFromPath(value, entry) {
+    const entries = pathEntries(value);
+    const kept = entries.filter((existing) => !sameEntry(existing, entry));
+    return kept.length === entries.length ? null : kept.join(";");
+}
+/**
+ * AR: يعيد ملفّ ‎fantastic‎ الذي يفوز على PATH إن لم يكن شيمتنا، وإلّا ‎undefined‎. يقرأ PATH العملية
+ *     الحالية لا السِّجل: السؤال هو «ماذا يحدث حين يُكتب الاسم الآن»، لا «ماذا سيحدث بعد إعادة فتح».
+ * EN: Returns the `fantastic` file that wins on PATH when it is not our shim, else `undefined`. It
+ *     reads the current process's PATH rather than the registry: the question is "what happens when
+ *     the name is typed now", not "what will happen after a fresh terminal".
+ */
+export function findConflictingCommand(ourShim) {
+    const extensions = (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean);
+    const entries = pathEntries(process.env.PATH ?? process.env.Path ?? "").flatMap((entry) => entry.split(delimiter));
+    for (const directory of entries) {
+        for (const extension of extensions) {
+            const candidate = join(directory, `fantastic${extension.toLowerCase()}`);
+            if (!existsSync(candidate))
+                continue;
+            return resolve(candidate).toLowerCase() === resolve(ourShim).toLowerCase() ? undefined : candidate;
+        }
+    }
+    return undefined;
+}
+async function powershell(script) {
+    const { stdout } = await execa("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
+        timeout: 20_000,
+    });
+    return stdout;
+}
+/** يقرأ PATH الآلة غير مُوسَّعة، مع نوع قيمتها. ‎undefined‎ على غير ويندوز أو عند تعذّر القراءة. */
+export async function readMachinePath() {
+    if (process.platform !== "win32")
+        return undefined;
+    // ‎DoNotExpandEnvironmentNames‎ هي بيت القصيد: بدونها تعود ‎%SystemRoot%‎ نصًّا مُوسَّعًا فتُجمَّد.
+    const script = [
+        `$key = Get-Item -LiteralPath '${ENVIRONMENT_KEY}'`,
+        `$raw = $key.GetValue('Path', $null, 'DoNotExpandEnvironmentNames')`,
+        `$kind = $key.GetValueKind('Path')`,
+        `if ($null -eq $raw) { exit 1 }`,
+        // سطر أول للنوع ثم القيمة كما هي. ‎[char]10‎ لا محرف هروب PowerShell: الأخير علامة اقتباس
+        // خلفية، وهي تُنهي القالب النصّي في TypeScript قبل أن تصل إلى PowerShell أصلًا.
+        `[Console]::Out.Write($kind.ToString() + [char]10 + $raw)`,
+    ].join("; ");
+    try {
+        const stdout = await powershell(script);
+        const newline = stdout.indexOf("\n");
+        if (newline < 0)
+            return undefined;
+        return { kind: stdout.slice(0, newline).trim(), raw: stdout.slice(newline + 1) };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * AR: يكتب القيمة الجديدة بنفس نوعها الأصلي، ثم يُذيع ‎WM_SETTINGCHANGE‎ ليعرف مستكشف الملفات أن
+ *     البيئة تغيّرت. الإذاعة **أفضل جهد**: فشلها لا يُفشل التثبيت، وغايتها وحدها أن تقصر الانتظار
+ *     على طرفية جديدة بدل إعادة تسجيل الدخول.
+ * EN: Writes the new value with its original kind, then broadcasts `WM_SETTINGCHANGE` so Explorer
+ *     learns the environment changed. The broadcast is **best effort**: its failure does not fail the
+ *     installation, and its only purpose is to reduce the wait to a new terminal rather than a new
+ *     logon.
+ */
+async function writeMachinePath(value, kind) {
+    const encoded = Buffer.from(value, "utf8").toString("base64");
+    // القيمة تعبر مُرمَّزة بـbase64 لا نصًّا: PATH يحوي فواصل منقوطة وعلامات اقتباس وعلامات نسبة،
+    // وأي منها في سطر أوامر PowerShell يُفسَّر. الترميز يجعل النقل حرفيًّا لا مؤوَّلًا.
+    const script = [
+        `$value = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${encoded}'))`,
+        `Set-ItemProperty -LiteralPath '${ENVIRONMENT_KEY}' -Name 'Path' -Value $value -Type ${kind}`,
+    ].join("; ");
+    await powershell(script);
+    const broadcast = [
+        `$sig = '[DllImport("user32.dll", SetLastError=true, CharSet=CharSet.Auto)] public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);'`,
+        `$type = Add-Type -MemberDefinition $sig -Name 'FantasticEnv' -Namespace 'Win32' -PassThru`,
+        `$out = [UIntPtr]::Zero`,
+        `[void]$type::SendMessageTimeout([IntPtr]0xffff, 0x1A, [UIntPtr]::Zero, 'Environment', 2, 5000, [ref]$out)`,
+    ].join("; ");
+    await powershell(broadcast).catch(() => undefined);
+}
+/**
+ * AR: يترجم فشل الكتابة إلى سبب يُقرأ. **لا يُطبَع سطر الأوامر نفسه**: رسالة ‎execa‎ تحمل الأمر كاملًا،
+ *     وفيه قيمة PATH مُرمَّزة بـbase64 — كيلوبايتان من نصّ لا يقرأه أحد يغرق فيها السبب الحقيقي، وهو
+ *     في الغالب كلمة واحدة: لا صلاحيات.
+ * EN: Turns a write failure into a readable cause. **The command line itself is never printed**:
+ *     execa's message carries the whole command, and in it the base64-encoded PATH — two kilobytes of
+ *     text nobody reads, drowning the actual cause, which is usually one word: no rights.
+ */
+function describeFailure(error) {
+    const text = error instanceof Error ? error.message : String(error);
+    if (/denied|Requested registry access is not allowed|UnauthorizedAccess/i.test(text)) {
+        return "needs an administrator terminal";
+    }
+    if (/timed out|ETIMEDOUT/i.test(text))
+        return "the registry did not answer in time";
+    return "could not be written";
+}
+/** يحفظ القيمة غير المُوسَّعة قبل أي كتابة. الاسترجاع بعدها نسخٌ ولصق لا تخمين. */
+function backup(logDir, value, action) {
+    mkdirSync(logDir, { recursive: true });
+    const path = join(logDir, "machine-path.backup.txt");
+    const stamp = new Date().toISOString();
+    writeFileSync(path, `# ${stamp} — before ${action}\r\n${value}\r\n`, "utf8");
+    return path;
+}
+/**
+ * AR: **الفشل هنا لا يُسقط ما نجح.** الكتابة في ‎HKLM‎ تحتاج صلاحيات مسؤول، وقد لا تتوفّر — أو يمنعها
+ *     دفاعٌ على الجهاز. والنظام حينها مثبَّتٌ ويعمل تمامًا، وكل ما فات هو اختصار كتابة مسار. رميُ
+ *     الخطأ كان سيُطلق التراجع فيمحو تثبيتًا سليمًا لأجل راحة، وهذا أسوأ بكثير من رسالة صريحة.
+ * EN: **A failure here does not undo what succeeded.** Writing to `HKLM` needs administrator rights,
+ *     which may be absent — or a security product may block it. The system at that point is installed
+ *     and fully working, and all that was lost is not having to type a path. Throwing would trigger
+ *     the rollback and erase a sound installation for a convenience, which is far worse than a plain
+ *     message.
+ */
+async function change(entry, logDir, compute, labels) {
+    const current = await readMachinePath();
+    if (!current)
+        return { changed: false, detail: labels.unreadable };
+    const next = compute(current.raw);
+    if (next === null)
+        return { changed: false, detail: labels.unchanged };
+    let backupPath;
+    try {
+        backupPath = backup(logDir, current.raw, `${labels.action} ${entry}`);
+        await writeMachinePath(next, current.kind);
+    }
+    catch (error) {
+        return { changed: false, detail: `${describeFailure(error)} — add ${entry} to PATH by hand`, backupPath };
+    }
+    return { changed: true, detail: labels.done, backupPath };
+}
+/** يُضيف مجلدًا إلى PATH الآلة إن لم يكن فيه. */
+export function registerOnMachinePath(entry, logDir) {
+    return change(entry, logDir, (raw) => addToPath(raw, entry), {
+        unreadable: "machine PATH is unreadable — add the folder by hand",
+        unchanged: "already on PATH",
+        done: "added to the machine PATH",
+        action: "adding",
+    });
+}
+/** يُزيل مجلدًا من PATH الآلة إن كان فيه. جهازٌ أُزيل عنه النظام لا يبقى فيه أثرٌ ميّت. */
+export function unregisterFromMachinePath(entry, logDir) {
+    return change(entry, logDir, (raw) => removeFromPath(raw, entry), {
+        unreadable: "machine PATH is unreadable — remove the folder by hand",
+        unchanged: "was not on PATH",
+        done: "removed from the machine PATH",
+        action: "removing",
+    });
+}
+//# sourceMappingURL=machine-path.js.map