@wasmsoft/fantastic 1.0.0

package/dist/render/licence.render.js

@@ -0,0 +1,167 @@
+import { c, glyph, NOT_REPORTED } from "./theme.js";
+// AR: عارضة الرخصة. **مكان واحد يقرّر كيف تُقرَأ حالة الرخصة في الطرفية** — يستعمله ‎activate‎
+//     و‎status‎ و‎health‎ و‎doctor‎. أربع نسخ من هذا المنطق تعني أربع إجابات لسؤال واحد، ويقرأ
+//     الفنّي «active» في أمرٍ و«grace» في آخر عن اللحظة نفسها.
+//     ولا منطق هنا: تحويل حالةٍ إلى نصّ ولون، لا قرار عمّا إذا كانت الرخصة صالحة.
+// EN: The licence renderer. **One place decides how licence state reads in the terminal** — used by
+//     `activate`, `status`, `health` and `doctor`. Four copies of this logic would mean four answers
+//     to one question, with the technician reading "active" in one command and "grace" in another
+//     about the same instant.
+//     No logic lives here: state to text and colour, never a decision about whether a licence is valid.
+/** سطر الحالة بلونه: كلمة واحدة يقرؤها الفنّي من بعيد. */
+export function licenceBadge(device) {
+    if (!device)
+        return c.dim(NOT_REPORTED);
+    switch (device.status) {
+        case "active":
+            return c.ok("active");
+        case "grace":
+            return c.warn(`grace (${device.graceDaysLeft ?? "?"}d left)`);
+        case "expired":
+            // AR: كلمتان مختلفتان لأن العلاجين متعاكسان: التجديد من الشركة مقابل اتصال إنترنت.
+            // EN: Two different words because the remedies are opposites: a renewal from the company
+            //     versus an internet connection.
+            return device.expiredReason === "grace" ? c.bad("grace exhausted") : c.bad("expired");
+        case "invalid":
+            return c.bad(`invalid (${device.reason ?? "?"})`);
+        // AR: كودُ المركز لا كلمةُ «invalid». الفنّي الذي يقرأ ‎refused (DEVICE_NOT_AUTHORIZED)‎
+        //     يعرف أن الملفّ سليم وأن القرار في اللوحة، فلا يضيّع ساعةً في إعادة تفعيلٍ لن تنجح.
+        // EN: The centre's code rather than the word "invalid". A technician reading
+        //     `refused (DEVICE_NOT_AUTHORIZED)` knows the file is sound and the decision is in the
+        //     dashboard, and does not lose an hour on a re-activation that cannot succeed.
+        case "refused":
+            return c.bad(`refused (${device.reason ?? "?"})`);
+        case "none":
+            return c.dim("not activated");
+    }
+}
+/** كتلة كاملة لـ‎activate‎ و‎health‎: الخطّة والانتهاء والأجهزة وبصمة الجهاز. */
+export function renderLicenceCard(device, options = {}) {
+    if (!device)
+        return ` ${c.dim("Licence")} ${c.dim(NOT_REPORTED)}`;
+    const lines = [];
+    if (options.heading) {
+        const network = device.networkName ? ` ${c.dim("—")} ${device.networkName}` : "";
+        lines.push(`${c.ok(glyph.pass)} ${c.ok("Activated")}${network}`);
+    }
+    else {
+        lines.push(` ${c.label("Licence")}  ${licenceBadge(device)}`);
+    }
+    const row = (label, value) => `   ${c.dim(label.padEnd(9))} ${value}`;
+    // AR: **اسم الشبكة صفٌّ في البطاقة لا سطرَ عنوانٍ وحده.** كان يظهر في ترويسة ‎activate‎ فقط،
+    //     فيقرأ من ينادي ‎status‎ حالةً ومدّةً بلا اسم العقد الذي تخصّه — وهو أوّل ما يتأكّد منه
+    //     المالك حين يملك أكثر من استراحة.
+    // EN: **The network name is a row in the card, not a heading alone.** It only ever appeared in
+    //     `activate`'s heading, so whoever ran `status` read a state and a term without the name of
+    //     the contract they belong to — the first thing an owner with more than one rest-house checks.
+    if (!options.heading && device.networkName)
+        lines.push(row("Name", c.value(device.networkName)));
+    // الكود يصل من النواة مُخفًى أصلًا (‎maskLicenseCode‎)، فلا إخفاء هنا ولا كشف.
+    if (device.code)
+        lines.push(row("Code", c.value(device.code)));
+    if (device.expiresAt)
+        lines.push(row("Expires", isoDateTime(device.expiresAt)));
+    // AR: **السقف وحده بلا العدد المستعمل.** الجهاز يعرف سقفه من الرخصة الموقَّعة، ولا يعرف كم
+    //     جهازًا آخر فعّله العميل — تلك معلومة المركز. طباعة «1 / 2» من هنا كانت تخترع الرقم
+    //     الأول وتبدو أدقّ ممّا هي، والفنّي يبني عليها قرارًا خاطئًا. الرقم الصحيح في لوحة الشركة.
+    // EN: **The ceiling alone, without the used count.** The appliance knows its ceiling from the
+    //     signed licence and has no idea how many other machines the customer activated — that is
+    //     the centre's knowledge. Printing "1 / 2" here would invent the first number and look more
+    //     precise than it is, and the technician would act on it. The real figure is in the company
+    //     dashboard.
+    if (device.maxDevices !== undefined)
+        lines.push(row("Devices", `up to ${device.maxDevices}`));
+    lines.push(row("Device", c.value(shortId(device.deviceId))));
+    // AR: **الباقة ومحتواها — أوّل ما يُسأل عنه حين «هذه الشاشة مقفلة عندي».**
+    //
+    //     تُطبع بعد بيانات الرخصة لأنها تفصيلها لا ترويستها؛ ومن ينادي ‎status‎ لأن شيئًا لا يعمل
+    //     يجد الجواب في الشاشة نفسها بدل فتح متصفّح أو الاتصال بالشركة.
+    // EN: **The package and what it contains — the first thing asked when "this screen is locked for
+    //     me".** Printed after the licence data because it is its detail rather than its heading; and
+    //     whoever runs `status` because something does not work finds the answer on the same screen
+    //     instead of opening a browser or calling the company.
+    lines.push(...packageLines(device, row));
+    return lines.join("\n");
+}
+/**
+ * AR: أسطر الباقة: مفتاحها، ثم المشمول وغير المشمول.
+ *
+ *     **المفتاح لا الاسم العربيّ.** أسماء الباقات يصنعها موظّفو الشركة وقت التشغيل، ولا تحملها
+ *     حمولةٌ موقَّعة — فالجهاز لا يعرفها أصلًا (‎research R14b‎). والمفتاح هو نفسه ما يظهر في رفض
+ *     الحارس وفي سجلّات الدعم، فيتكلّم الطرفان عن الشيء نفسه في المكالمة.
+ *
+ *     **والعلامة تحمل المعنى لا اللون.** ‎glyph.pass‎ و‎glyph.fail‎ لهما بديلان نصّيان في طرفية
+ *     بلا يونيكود، واللون يزيد الوضوح ولا يصنعه — فطرفيةٌ بلا ألوان تقرأ الجدول كاملًا.
+ *
+ *     **ولا كتالوج هنا.** ‎featureStates‎ تصل محسوبةً من النواة؛ نسخةٌ ثانية من الحساب في
+ *     الطرفية كانت ستفترق عن الشاشة عند أوّل ميزة تُعطَّل، فيقرأ المالك إجابتين عن اللحظة نفسها.
+ *
+ * EN: The package lines: its key, then what is included and what is not.
+ *
+ *     **The key, not an Arabic name.** Package names are created by company staff at runtime and no
+ *     signed payload carries them, so the appliance does not know them (research R14b). The key is
+ *     also what appears in the guard's refusal and in support's logs, so both sides of a phone call
+ *     name the same thing.
+ *
+ *     **And the marker carries the meaning, not the colour.** `glyph.pass` and `glyph.fail` have
+ *     text fallbacks on a terminal without unicode, and colour reinforces the distinction rather
+ *     than creating it — so a colourless terminal still reads the whole table.
+ *
+ *     **No catalogue lives here.** `featureStates` arrives computed by the core; a second copy of
+ *     the derivation in the terminal would diverge from the screen at the first capability anybody
+ *     deactivates, leaving the owner with two answers about the same instant.
+ */
+function packageLines(device, row) {
+    const lines = [];
+    if (device.plan)
+        lines.push(row("Package", c.value(device.plan)));
+    const states = device.featureStates ?? [];
+    if (states.length === 0)
+        return lines;
+    const included = states.filter((state) => state.included).map((state) => state.key);
+    const excluded = states.filter((state) => !state.included).map((state) => state.key);
+    if (included.length > 0) {
+        lines.push(row("Included", included.map((key) => `${c.ok(glyph.pass)} ${key}`).join("  ")));
+    }
+    if (excluded.length > 0) {
+        lines.push(row("Excluded", excluded.map((key) => `${c.bad(glyph.fail)} ${key}`).join("  ")));
+    }
+    return lines;
+}
+/**
+ * AR: بصمةٌ من ٦٤ محرفًا لا تُقرأ على الهاتف. الاثنا عشر الأولى تكفي للتمييز وللبحث في شاشة
+ *     الأجهزة، وهي نفس ما تعرضه اللوحة — فلا يقرأ العميل رقمًا لا يجده الدعم.
+ * EN: A 64-character digest is unreadable over the phone. The first twelve are enough to identify
+ *     and to search the devices screen, and they are exactly what the dashboard shows — so the
+ *     customer never reads out a number support cannot find.
+ */
+function shortId(deviceId) {
+    if (!deviceId)
+        return NOT_REPORTED;
+    return deviceId.length > 12 ? deviceId.slice(0, 12) : deviceId;
+}
+/**
+ * AR: التاريخ **والساعة** بالتوقيت المحلّي للجهاز.
+ *
+ *     كان التاريخ وحده، بحجّة أن الصلاحية «قرار أيام لا دقائق». وهي حجّة تنكسر في اليوم الأخير
+ *     بالذات: مالكٌ يقرأ ‎2026-08-09‎ صباحَ التاسع لا يعرف أهو يملك اليوم كلّه أم ساعتين، وهو
+ *     اليوم الوحيد الذي يهمّ فيه الفرق. والساعة محلّية لا UTC لأن من يقرؤها يقارنها بساعة الحائط
+ *     أمامه، لا بخطّ غرينتش.
+ * EN: The date **and the time**, in the machine's local zone.
+ *
+ *     It used to be the date alone, on the grounds that validity is "a matter of days, not minutes".
+ *     That reasoning breaks on precisely the last day: an owner reading `2026-08-09` on the morning
+ *     of the ninth cannot tell whether he has the whole day or two hours — the one day the
+ *     difference matters. And the time is local rather than UTC because whoever reads it compares it
+ *     to the clock on the wall in front of him, not to Greenwich.
+ */
+function isoDateTime(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    const pad = (value) => String(value).padStart(2, "0");
+    const day = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    const time = `${pad(date.getHours())}:${pad(date.getMinutes())}`;
+    return `${day} ${time}`;
+}
+//# sourceMappingURL=licence.render.js.map

package/dist/render/licence.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licence.render.js","sourceRoot":"","sources":["../../src/render/licence.render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD,+FAA+F;AAC/F,+FAA+F;AAC/F,+DAA+D;AAC/D,kFAAkF;AAClF,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,8BAA8B;AAC9B,wGAAwG;AAExG,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAExC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,aAAa,IAAI,GAAG,SAAS,CAAC,CAAC;QAChE,KAAK,SAAS;YACZ,mFAAmF;YACnF,yFAAyF;YACzF,qCAAqC;YACrC,OAAO,MAAM,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxF,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC;QACpD,yFAAyF;QACzF,yFAAyF;QACzF,6EAA6E;QAC7E,2FAA2F;QAC3F,mFAAmF;QACnF,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC;QACpD,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAOD,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,UAA8B,EAAE;IAC3F,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;IAElE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IAEtF,6FAA6F;IAC7F,6FAA6F;IAC7F,uCAAuC;IACvC,+FAA+F;IAC/F,gGAAgG;IAChG,mGAAmG;IACnG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEjG,+EAA+E;IAC/E,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChF,2FAA2F;IAC3F,yFAAyF;IACzF,+FAA+F;IAC/F,8FAA8F;IAC9F,8FAA8F;IAC9F,gGAAgG;IAChG,gGAAgG;IAChG,iBAAiB;IACjB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,2EAA2E;IAC3E,EAAE;IACF,8FAA8F;IAC9F,oEAAoE;IACpE,iGAAiG;IACjG,kGAAkG;IAClG,gGAAgG;IAChG,2DAA2D;IAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAS,YAAY,CACnB,MAAkB,EAClB,GAA6C;IAE7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAErF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,QAAuB;IACtC,IAAI,CAAC,QAAQ;QAAE,OAAO,YAAY,CAAC;IACnC,OAAO,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAE7C,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACvF,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAEjE,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/render/status.render.d.ts

@@ -0,0 +1,6 @@
+import type { Profile } from "../profiles/types.js";
+import type { ServiceState } from "../supervisor/inspect.js";
+export declare function renderStatusTable(states: ServiceState[]): string;
+/** سطر السياق أسفل الجدول: أي ملفّ تشغيل، وأين القاعدة، وكم حجمها. لا تخمين صامت. */
+export declare function renderProfileFooter(profile: Profile): string;
+//# sourceMappingURL=status.render.d.ts.map

package/dist/render/status.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.render.d.ts","sourceRoot":"","sources":["../../src/render/status.render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmB7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAuBhE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQ5D"}

package/dist/render/status.render.js

@@ -0,0 +1,52 @@
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import Table from "cli-table3";
+import { NOT_REPORTED, c, formatBytes, formatDuration, glyph } from "./theme.js";
+// AR: عارضة جدول الحالة. تأخذ حالة مجموعة ولا تحسبها، فيبقى الحساب في ‎supervisor/inspect‎ وحده.
+// EN: The status-table renderer. It takes collected state and never computes it, so the computation
+//     stays in supervisor/inspect alone.
+function stateCell(state) {
+    if (!state.running)
+        return c.bad(`${glyph.bad} stopped`);
+    // خدمة أطلقناها لكنها لا تردّ على المسبار: حيّة كعملية، غير جاهزة كخدمة. الفرق يستحق لونًا خاصًا.
+    if (!state.probe.reachable)
+        return c.warn(`${glyph.warn} not responding`);
+    return c.ok(`${glyph.ok} running`);
+}
+function sourceNote(state) {
+    if (state.source === "probe")
+        return c.dim("(started outside the CLI)");
+    return "";
+}
+export function renderStatusTable(states) {
+    const table = new Table({
+        head: ["Service", "State", "Port", "PID", "Uptime"].map((header) => c.dim(header)),
+        style: { head: [], border: [], "padding-left": 1, "padding-right": 1 },
+        chars: {
+            top: "─", "top-mid": "┬", "top-left": "┌", "top-right": "┐",
+            bottom: "─", "bottom-mid": "┴", "bottom-left": "└", "bottom-right": "┘",
+            left: "│", "left-mid": "├", mid: "─", "mid-mid": "┼", right: "│", "right-mid": "┤",
+            middle: "│",
+        },
+    });
+    for (const state of states) {
+        table.push([
+            `${state.definition.label} ${sourceNote(state)}`.trim(),
+            stateCell(state),
+            String(state.definition.port),
+            state.record ? String(state.record.pid) : NOT_REPORTED,
+            formatDuration(state.uptimeSeconds),
+        ]);
+    }
+    return table.toString();
+}
+/** سطر السياق أسفل الجدول: أي ملفّ تشغيل، وأين القاعدة، وكم حجمها. لا تخمين صامت. */
+export function renderProfileFooter(profile) {
+    const dbPath = join(profile.dataDir, "fantastic.db");
+    const size = existsSync(dbPath) ? formatBytes(statSync(dbPath).size) : "missing";
+    return [
+        c.dim("profile: ") + c.value(profile.kind),
+        c.dim("database: ") + c.value(dbPath) + c.dim(` (${size})`),
+    ].join(c.dim("  ·  "));
+}
+//# sourceMappingURL=status.render.js.map

package/dist/render/status.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.render.js","sourceRoot":"","sources":["../../src/render/status.render.ts"],"names":[],"mappings":"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"}

package/dist/render/theme.d.ts

@@ -0,0 +1,66 @@
+/** الألوان تُعطَّل تلقائيًا خارج الطرفية (CI أو مخرَج مُمرَّر بأنبوب). */
+export declare const isTty: boolean;
+export declare const c: {
+    ok: import("chalk").ChalkInstance;
+    bad: import("chalk").ChalkInstance;
+    warn: import("chalk").ChalkInstance;
+    dim: import("chalk").ChalkInstance;
+    accent: import("chalk").ChalkInstance;
+    label: import("chalk").ChalkInstance;
+    value: import("chalk").ChalkInstance;
+};
+/**
+ * AR: **هل تستطيع هذه الطرفية رسم ما هو خارج ASCII؟**
+ *
+ *     السؤال ليس ترفًا: على «موجّه الأوامر» التقليدي في ويندوز — وهو ما يفتحه الفنّي عند العميل —
+ *     كل محرف خارج ASCII يظهر ‎?‎. فيصير سطر الترحيب ‎52‎ علامة استفهام، وتصير كل علامة ‎✔‎ سؤالًا،
+ *     ويقرأ الفنّي شاشة تبدو معطوبة بينما كل شيء يعمل. قِيس على جهاز عميل حقيقي أثناء ٠١٨.
+ *
+ *     ولا نستطيع أن نسأل الطرفية، فنستدلّ: كل ما ليس ويندوز يرسم يونيكود، ونوافذ الطرفية الحديثة
+ *     (Windows Terminal، VS Code، ConEmu) تُعرّف عن نفسها بمتغيّرات بيئة. وما عداها يُفترَض قديمًا —
+ *     **والافتراض عند الشكّ هو الأبسط لا الأجمل**، لأن ثمن الخطأ متباعد: رمز ASCII في طرفية حديثة
+ *     أقلّ جمالًا بقليل، وعلامة استفهام عند عميل تبدو عطبًا.
+ * EN: **Can this terminal draw anything beyond ASCII?**
+ *
+ *     Not a cosmetic question: in Windows' classic Command Prompt — the one a technician opens at a
+ *     customer site — every non-ASCII character renders as `?`. The banner rule becomes 52 question
+ *     marks, every `✔` becomes a query, and the technician reads a screen that looks broken while
+ *     everything works. Measured on a real customer machine during 018.
+ *
+ *     We cannot ask the terminal, so we infer: everything that is not Windows draws Unicode, and
+ *     modern Windows terminals (Windows Terminal, VS Code, ConEmu) announce themselves through
+ *     environment variables. Anything else is assumed legacy — **and when in doubt the assumption is
+ *     the plainer one, not the prettier one**, because the costs are lopsided: an ASCII mark in a
+ *     modern terminal is slightly less handsome, a question mark at a customer looks like a fault.
+ */
+export declare const unicodeSafe: boolean;
+/**
+ * AR: رموز المخرَج، **مكانًا واحدًا لا متناثرة**. كانت تُكتب حرفيًّا في إحدى وسبعين ملفًّا، فلم يكن
+ *     ثمّة موضع واحد يقرّر — ولا سبيل إلى بديل ASCII إلا بتعديل الجميع. البدائل أحادية المحرف كلّها
+ *     فتبقى الأعمدة محاذاة كما هي.
+ * EN: Output glyphs, **in one place rather than scattered**. They were written literally across
+ *     seventy-one files, so no single place decided — and no ASCII alternative was possible without
+ *     touching all of them. Every fallback is one character wide, so columns stay aligned.
+ */
+export declare const glyph: {
+    ok: string;
+    bad: string;
+    warn: string;
+    step: string;
+    none: string;
+    pass: string;
+    fail: string;
+    arrow: string;
+    rule: string;
+};
+/** الشرطة تعني «غير متاح» صراحةً. الصفر ادّعاء، والشرطة اعتراف. */
+export declare const NOT_REPORTED: string;
+export declare function formatDuration(seconds: number | undefined): string;
+export declare function formatBytes(bytes: number | undefined): string;
+/** ألوان بادئات السجلات، ثابتة لكل خدمة حتى تُميَّز بالعين وحدها. */
+export declare const servicePrefixColor: {
+    readonly live: import("chalk").ChalkInstance;
+    readonly core: import("chalk").ChalkInstance;
+    readonly portal: import("chalk").ChalkInstance;
+};
+//# sourceMappingURL=theme.d.ts.map

package/dist/render/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/render/theme.ts"],"names":[],"mappings":"AASA,0EAA0E;AAC1E,eAAO,MAAM,KAAK,SAAgC,CAAC;AAEnD,eAAO,MAAM,CAAC;;;;;;;;CAQb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,WAAW,SAKa,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;CAEqF,CAAC;AAExG,mEAAmE;AACnE,eAAO,MAAM,YAAY,QAAa,CAAC;AAEvC,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAc7D;AAED,qEAAqE;AACrE,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC"}

package/dist/render/theme.js

@@ -0,0 +1,89 @@
+import chalk from "chalk";
+// AR: طبقة التنسيق. **لا منطق هنا** — ألوان ورموز وتحويل أرقام إلى نصّ مقروء فقط.
+//     ملاحظة اتجاهية: الطرفية ثنائية الاتجاه غير موثوقة، فنُبقي القيم اللاتينية (مسارات، منافذ،
+//     روابط) في أعمدة مستقلة ولا ندسّها داخل جملة عربية.
+// EN: The presentation layer. **No logic here** — colours, glyphs and number-to-text only.
+//     A directional note: terminal bidi is unreliable, so Latin values (paths, ports, URLs) stay in
+//     their own columns and are never embedded mid-Arabic-sentence.
+/** الألوان تُعطَّل تلقائيًا خارج الطرفية (CI أو مخرَج مُمرَّر بأنبوب). */
+export const isTty = Boolean(process.stdout.isTTY);
+export const c = {
+    ok: chalk.green,
+    bad: chalk.red,
+    warn: chalk.yellow,
+    dim: chalk.dim,
+    accent: chalk.hex("#FF5A1F"),
+    label: chalk.bold,
+    value: chalk.cyan,
+};
+/**
+ * AR: **هل تستطيع هذه الطرفية رسم ما هو خارج ASCII؟**
+ *
+ *     السؤال ليس ترفًا: على «موجّه الأوامر» التقليدي في ويندوز — وهو ما يفتحه الفنّي عند العميل —
+ *     كل محرف خارج ASCII يظهر ‎?‎. فيصير سطر الترحيب ‎52‎ علامة استفهام، وتصير كل علامة ‎✔‎ سؤالًا،
+ *     ويقرأ الفنّي شاشة تبدو معطوبة بينما كل شيء يعمل. قِيس على جهاز عميل حقيقي أثناء ٠١٨.
+ *
+ *     ولا نستطيع أن نسأل الطرفية، فنستدلّ: كل ما ليس ويندوز يرسم يونيكود، ونوافذ الطرفية الحديثة
+ *     (Windows Terminal، VS Code، ConEmu) تُعرّف عن نفسها بمتغيّرات بيئة. وما عداها يُفترَض قديمًا —
+ *     **والافتراض عند الشكّ هو الأبسط لا الأجمل**، لأن ثمن الخطأ متباعد: رمز ASCII في طرفية حديثة
+ *     أقلّ جمالًا بقليل، وعلامة استفهام عند عميل تبدو عطبًا.
+ * EN: **Can this terminal draw anything beyond ASCII?**
+ *
+ *     Not a cosmetic question: in Windows' classic Command Prompt — the one a technician opens at a
+ *     customer site — every non-ASCII character renders as `?`. The banner rule becomes 52 question
+ *     marks, every `✔` becomes a query, and the technician reads a screen that looks broken while
+ *     everything works. Measured on a real customer machine during 018.
+ *
+ *     We cannot ask the terminal, so we infer: everything that is not Windows draws Unicode, and
+ *     modern Windows terminals (Windows Terminal, VS Code, ConEmu) announce themselves through
+ *     environment variables. Anything else is assumed legacy — **and when in doubt the assumption is
+ *     the plainer one, not the prettier one**, because the costs are lopsided: an ASCII mark in a
+ *     modern terminal is slightly less handsome, a question mark at a customer looks like a fault.
+ */
+export const unicodeSafe = process.platform !== "win32" ||
+    Boolean(process.env.WT_SESSION) ||
+    Boolean(process.env.ConEmuANSI) ||
+    process.env.TERM_PROGRAM === "vscode" ||
+    Boolean(process.env.FANTASTIC_UTF8);
+/**
+ * AR: رموز المخرَج، **مكانًا واحدًا لا متناثرة**. كانت تُكتب حرفيًّا في إحدى وسبعين ملفًّا، فلم يكن
+ *     ثمّة موضع واحد يقرّر — ولا سبيل إلى بديل ASCII إلا بتعديل الجميع. البدائل أحادية المحرف كلّها
+ *     فتبقى الأعمدة محاذاة كما هي.
+ * EN: Output glyphs, **in one place rather than scattered**. They were written literally across
+ *     seventy-one files, so no single place decided — and no ASCII alternative was possible without
+ *     touching all of them. Every fallback is one character wide, so columns stay aligned.
+ */
+export const glyph = unicodeSafe
+    ? { ok: "●", bad: "●", warn: "●", step: "▸", none: "—", pass: "✔", fail: "✖", arrow: "→", rule: "━" }
+    : { ok: "*", bad: "*", warn: "*", step: ">", none: "-", pass: "+", fail: "x", arrow: ">", rule: "=" };
+/** الشرطة تعني «غير متاح» صراحةً. الصفر ادّعاء، والشرطة اعتراف. */
+export const NOT_REPORTED = glyph.none;
+export function formatDuration(seconds) {
+    if (seconds === undefined)
+        return NOT_REPORTED;
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = Math.floor(seconds % 60);
+    return [hours, minutes, secs].map((part) => String(part).padStart(2, "0")).join(":");
+}
+export function formatBytes(bytes) {
+    if (bytes === undefined)
+        return NOT_REPORTED;
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KB", "MB", "GB", "TB"];
+    let value = bytes / 1024;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value.toFixed(1)} ${units[unit]}`;
+}
+/** ألوان بادئات السجلات، ثابتة لكل خدمة حتى تُميَّز بالعين وحدها. */
+export const servicePrefixColor = {
+    live: chalk.magenta,
+    core: chalk.cyan,
+    portal: chalk.yellow,
+};
+//# sourceMappingURL=theme.js.map

package/dist/render/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/render/theme.ts"],"names":[],"mappings":"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"}

package/dist/runtime-guard.d.ts

@@ -0,0 +1,19 @@
+/** الحدّ الأدنى المُعلَن في ‎package.json‎. رقمٌ واحد لا رقمان: تعديلُ أحدهما وحده يُنتج وعدين. */
+export declare const MINIMUM_NODE_MAJOR = 20;
+export type RuntimeVerdict = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    remedy: string;
+};
+/**
+ * AR: يقارن الإصدار الجاري بالحدّ الأدنى. يُمرَّر الإصدار وسيطًا ليكون الفحص قابلًا للاختبار بلا
+ *     إشغال عملية Node ثانية — والاختبار هنا هو الدليل الوحيد، إذ لا أحد يشغّل Node ‏18 عمدًا
+ *     ليرى الرسالة.
+ * EN: Compares the running version against the minimum. The version is passed in so the check can be
+ *     tested without spawning a second Node process — and the test is the only proof available here,
+ *     since nobody runs Node 18 on purpose just to see the message.
+ */
+export declare function checkRuntime(version?: string): RuntimeVerdict;
+//# sourceMappingURL=runtime-guard.d.ts.map

package/dist/runtime-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guard.d.ts","sourceRoot":"","sources":["../src/runtime-guard.ts"],"names":[],"mappings":"AA8BA,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,MAAwB,GAAG,cAAc,CAiB9E"}

package/dist/runtime-guard.js

@@ -0,0 +1,57 @@
+// AR: **الشرط الوحيد الذي تفرضه هذه الأداة على جهاز العميل** (٠٢٦/FR-002).
+//
+//     قبل الفصل كانت الواجهة تُشحن داخل الحزمة وتعمل على ‎runtime\node.exe‎ المشحون معها، فلا
+//     يعنيها ما على الجهاز. وبعد الفصل صارت تُثبَّت من سِجلّ الحزم وتعمل على بيئة تشغيل العميل —
+//     وهذا هو الاستثناء الوحيد المنصوص عليه في فقرة النطاق بالمبدأ الأول، والخدمات كلّها ما زالت
+//     على البيئة المشحونة.
+//
+//     **والرفض المبكر ليس تشدّدًا بل رحمة.** بيئةٌ أقدم لا تنهار عند أوّل سطر، بل عند أوّل ميزةٍ
+//     لغويّة غير مدعومة — أي في منتصف تثبيتٍ يكتب على القرص، بأثرِ استدعاءٍ إنجليزيٍّ خامّ لا يقول
+//     للفنّي شيئًا عن السبب ولا عن العلاج. فحصٌ في أوّل سطرٍ يقول الاثنين معًا.
+//
+//     ولا يُنادى الفحص من ‎bin/run.js‎: ذلك الملفّ يُنفَّذ قبل أن يُحمَّل ‎dist/‎، وبيئةٌ قديمةٌ جدًّا
+//     قد تفشل في تحليله هو نفسه. موضعه هنا، في أساس كل أمر، وهو أبكر موضعٍ **مضمونٍ** أن يُبلغه
+//     التنفيذ.
+// EN: **The one requirement this tool places on a customer's machine** (026/FR-002).
+//
+//     Before the separation the CLI shipped inside the bundle and ran on the `runtime\node.exe`
+//     shipped with it, so what the machine carried was none of its business. After the separation it
+//     is installed from a package registry and runs on the customer's runtime — the single stated
+//     exception in principle I's scope paragraph, with every service still on the bundled runtime.
+//
+//     **And refusing early is mercy, not strictness.** An older runtime does not fail on the first
+//     line; it fails at the first unsupported language feature — that is, in the middle of an
+//     install already writing to disk, with a raw English stack trace that tells the technician
+//     nothing about the cause and nothing about the remedy. A check on the first line says both.
+//
+//     The check is not called from `bin/run.js`: that file runs before `dist/` is loaded, and a very
+//     old runtime may fail to parse it at all. Its home is here, in the base of every command — the
+//     earliest place execution is **guaranteed** to reach.
+/** الحدّ الأدنى المُعلَن في ‎package.json‎. رقمٌ واحد لا رقمان: تعديلُ أحدهما وحده يُنتج وعدين. */
+export const MINIMUM_NODE_MAJOR = 20;
+/**
+ * AR: يقارن الإصدار الجاري بالحدّ الأدنى. يُمرَّر الإصدار وسيطًا ليكون الفحص قابلًا للاختبار بلا
+ *     إشغال عملية Node ثانية — والاختبار هنا هو الدليل الوحيد، إذ لا أحد يشغّل Node ‏18 عمدًا
+ *     ليرى الرسالة.
+ * EN: Compares the running version against the minimum. The version is passed in so the check can be
+ *     tested without spawning a second Node process — and the test is the only proof available here,
+ *     since nobody runs Node 18 on purpose just to see the message.
+ */
+export function checkRuntime(version = process.version) {
+    const major = Number.parseInt(version.replace(/^v/, "").split(".")[0] ?? "", 10);
+    // AR: إصدارٌ لا يُقرأ **يمرّ**. بيئةٌ بترقيمٍ لا نتوقّعه (بناءٌ خاصّ، أو بديلٌ متوافق) قد تعمل
+    //     تمامًا، ومنعُها لأننا لم نفهم سلسلة نصّية منعٌ بلا دليل — والعطل الحقيقيّ سيظهر بنفسه.
+    // EN: An unreadable version **passes**. A runtime with numbering we do not expect (a custom build,
+    //     or a compatible alternative) may work perfectly, and refusing it because we failed to parse
+    //     a string is refusal without evidence — a real fault will announce itself.
+    if (!Number.isFinite(major))
+        return { ok: true };
+    if (major >= MINIMUM_NODE_MAJOR)
+        return { ok: true };
+    return {
+        ok: false,
+        message: `هذه الواجهة تحتاج Node ‏${MINIMUM_NODE_MAJOR} أو أحدث، والمثبَّت هنا ${version}.`,
+        remedy: `ثبّت الإصدار المدعوم ثم افتح طرفية جديدة:  winget install OpenJS.NodeJS.LTS`,
+    };
+}
+//# sourceMappingURL=runtime-guard.js.map

package/dist/runtime-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guard.js","sourceRoot":"","sources":["../src/runtime-guard.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,8FAA8F;AAC9F,iGAAiG;AACjG,iGAAiG;AACjG,2BAA2B;AAC3B,EAAE;AACF,iGAAiG;AACjG,mGAAmG;AACnG,gFAAgF;AAChF,EAAE;AACF,uGAAuG;AACvG,gGAAgG;AAChG,eAAe;AACf,qFAAqF;AACrF,EAAE;AACF,gGAAgG;AAChG,qGAAqG;AACrG,kGAAkG;AAClG,mGAAmG;AACnG,EAAE;AACF,mGAAmG;AACnG,8FAA8F;AAC9F,gGAAgG;AAChG,iGAAiG;AACjG,EAAE;AACF,qGAAqG;AACrG,oGAAoG;AACpG,2DAA2D;AAE3D,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAIrC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,OAAO,CAAC,OAAO;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEjF,+FAA+F;IAC/F,6FAA6F;IAC7F,mGAAmG;IACnG,kGAAkG;IAClG,gFAAgF;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAEjD,IAAI,KAAK,IAAI,kBAAkB;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAErD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,2BAA2B,kBAAkB,2BAA2B,OAAO,GAAG;QAC3F,MAAM,EAAE,6EAA6E;KACtF,CAAC;AACJ,CAAC"}

package/dist/shell/input-mode.d.ts

@@ -0,0 +1,25 @@
+export type KeypressListener = (char: unknown, key: {
+    name?: string;
+    sequence?: string;
+}) => void;
+/**
+ * ما نحتاجه من مجرى المُدخَل، مُصغَّرًا ليُمرَّر بديلٌ في الاختبار.
+ * الدوالّ بصيغة الطريقة لا بصيغة الخاصية عن قصد: الأولى تقبل تواقيع ‎ReadStream‎ الحقيقية، والثانية
+ * ترفضها تحت ‎strictFunctionTypes‎ على فروق في نوع الوسائط لا أثر لها هنا.
+ */
+export type ShellInput = {
+    isTTY?: boolean;
+    isRaw?: boolean;
+    setRawMode?(mode: boolean): unknown;
+    listeners(event: string): unknown[];
+    on(event: string, listener: KeypressListener): unknown;
+    resume(): unknown;
+};
+/**
+ * يعيد الوضع الخام ويُعيد ربط مُستمِع المفاتيح إن فُقد.
+ *
+ * **يُشترَط ألّا يُضاعِف المُستمِع**: يُستدعى بعد كل أمر، وإضافةٌ بلا فحص تعني عشرة مُستمِعين بعد عشرة
+ * أوامر — فتُرسَم اللوحة عشر مرّات فوق بعضها ويُحذّر Node من تسرّب مُستمِعين.
+ */
+export declare function restoreShellInput(input: ShellInput, listener: KeypressListener): void;
+//# sourceMappingURL=input-mode.d.ts.map

package/dist/shell/input-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-mode.d.ts","sourceRoot":"","sources":["../../src/shell/input-mode.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAElG;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACpC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACpC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACvD,MAAM,IAAI,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAUrF"}

package/dist/shell/input-mode.js

@@ -0,0 +1,17 @@
+import { emitKeypressEvents } from "node:readline";
+/**
+ * يعيد الوضع الخام ويُعيد ربط مُستمِع المفاتيح إن فُقد.
+ *
+ * **يُشترَط ألّا يُضاعِف المُستمِع**: يُستدعى بعد كل أمر، وإضافةٌ بلا فحص تعني عشرة مُستمِعين بعد عشرة
+ * أوامر — فتُرسَم اللوحة عشر مرّات فوق بعضها ويُحذّر Node من تسرّب مُستمِعين.
+ */
+export function restoreShellInput(input, listener) {
+    emitKeypressEvents(input);
+    if (!input.listeners("keypress").includes(listener)) {
+        input.on("keypress", listener);
+    }
+    if (input.isTTY && !input.isRaw)
+        input.setRawMode?.(true);
+    input.resume();
+}
+//# sourceMappingURL=input-mode.js.map

package/dist/shell/input-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-mode.js","sourceRoot":"","sources":["../../src/shell/input-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAyCnD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,QAA0B;IAC7E,kBAAkB,CAAC,KAAc,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1D,KAAK,CAAC,MAAM,EAAE,CAAC;AACjB,CAAC"}

package/dist/shell/parse-line.d.ts

@@ -0,0 +1,6 @@
+/**
+ * يقسّم سطرًا إلى وسائط. سطر فارغ أو مسافات وحدها يعطي مصفوفة فارغة.
+ * الاقتباس غير المغلَق يُقرأ حتى نهاية السطر بدل أن يُرمى: من نسي علامة إغلاق يريد ما كتبه، لا خطأً.
+ */
+export declare function splitCommandLine(line: string): string[];
+//# sourceMappingURL=parse-line.d.ts.map

package/dist/shell/parse-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-line.d.ts","sourceRoot":"","sources":["../../src/shell/parse-line.ts"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCvD"}