@wasmsoft/fantastic 1.0.0

package/dist/registry/local-registry.js

@@ -0,0 +1,252 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { readManifest } from "../packaging/manifest.js";
+import { MANIFEST_FILE } from "../packaging/layout.js";
+import { installerStamp } from "../version.js";
+// AR: سجلّ ما هو مثبَّت على هذه الآلة (٠٢٦).
+//
+//     **لماذا وُجد أصلًا:** ‎profiles/resolve.ts‎ كان يستنتج جذرًا واحدًا — إمّا مستودعٌ تحت المسار
+//     الحاليّ أو تثبيتٌ في المكان المعتاد. وهذا يكفي أداةً تخدم منتجًا واحدًا، ولا يكفي **مدير
+//     حزم**: من يدير أكثر من منتجٍ يحتاج أن يعرف ماذا رُكِّب، وأين، وبأيّ إصدار، وعلى أيّ منافذ —
+//     وأن يعرفه من أيّ مجلدٍ يقف فيه المستخدم.
+//
+//     **‎ProgramData‎ لا مجلد المستخدم**، وللسبب الذي جعل PATH يُسجَّل على مستوى الآلة في
+//     ‎packaging/machine-path.ts‎: جهاز العميل يُستعمل بحساباتٍ مختلفة، وفنّيٌّ يدخل بحسابٍ آخر يجب
+//     أن يجد ما ثُبِّت. سجلٌّ في ‎%AppData%‎ يعني نظامًا يعمل أمام عينَي فنّيٍّ ولا تراه أداته.
+//
+//     **ومرجعٌ مساعد لا مصدر حقيقة (FR-015).** مصدر الحقيقة شجرة التثبيت وبيانها؛ وهذا الملفّ
+//     اختصارُ بحث. فقدانه أو تلفه لا يجوز أن يعطّل نظامًا يعمل — يُعاد بناؤه بالمسح ويُكتب من
+//     جديد. هذه هي قاعدة «الفهرس ذاكرةٌ مؤقّتة» من المبدأ الثاني، مطبَّقةً على سجلّ الواجهة.
+// EN: The registry of what is installed on this machine (026).
+//
+//     **Why it exists at all:** `profiles/resolve.ts` used to infer a single root — either a
+//     repository under the current path or an installation in the usual place. That suffices for a
+//     tool serving one product; it does not suffice for a **package manager**: managing more than
+//     one product means knowing what was installed, where, at which version and on which ports —
+//     and knowing it from whatever directory the user happens to stand in.
+//
+//     **`ProgramData`, not the user's folder**, for the reason that put PATH at machine level in
+//     `packaging/machine-path.ts`: a customer's appliance is used from different accounts, and a
+//     technician signing in as someone else must still find what was installed. A registry under
+//     `%AppData%` means a running system in front of a technician that their own tool cannot see.
+//
+//     **And a helper index, never a source of truth (FR-015).** The truth is the install tree and
+//     its manifest; this file is a shortcut past a search. Losing or corrupting it must never
+//     disable a working system — it is rebuilt by scanning and written afresh. This is principle
+//     II's "the index is a cache" rule, applied to the CLI's own bookkeeping.
+/** ما نعرف كيف نقرؤه. رقمٌ أعلى يعني ملفًّا كتبته واجهةٌ أحدث — نتوقّف ولا نخمّن. */
+export const REGISTRY_SCHEMA_VERSION = 1;
+export const REGISTRY_DIR = join(process.env.ProgramData ?? "C:\\ProgramData", "Fantastic");
+export const REGISTRY_FILE = join(REGISTRY_DIR, "registry.json");
+/**
+ * AR: المواضع التي يُبحَث فيها عند إعادة البناء. **قائمة قصيرة مقصودة**: لا نمسح أقراص العميل
+ *     بحثًا عن تثبيتاتنا — مسحُ ‎D:\‎ كاملًا على جهازٍ فيه عشرة تيرابايت وسائط يستغرق دقائق ويبدو
+ *     للمستخدم تعليقًا. نبحث حيث نُثبِّت، ومن ثبّت في غير ذلك يمرّر ‎--root‎.
+ * EN: Where a rebuild looks. **A deliberately short list**: we do not sweep the customer's disks
+ *     hunting for our own installations — scanning all of `D:\` on a machine holding ten terabytes
+ *     of media takes minutes and reads to the user as a hang. We look where we install, and whoever
+ *     installed elsewhere passes `--root`.
+ */
+const SEARCH_ROOTS = [
+    join(process.env.SystemDrive ?? "C:", "\\Fantastic"),
+    join(process.env.ProgramFiles ?? "C:\\Program Files", "Fantastic"),
+];
+/**
+ * AR: قراءة الملفّ الخام. **كل فشلٍ هنا يُقرأ «لا سجلّ» لا «عطل»** — إلّا إصدار مخطّطٍ أحدث.
+ *
+ *     ملفٌّ غير موجود، أو نصفه مكتوب لأن الكهرباء انقطعت أثناء الكتابة، أو JSON تالف: كلّها تعني
+ *     أن الاختصار ضاع، والجواب إعادةُ بنائه لا إيقافُ المستخدم. أمّا ‎schemaVersion‎ أعلى ممّا
+ *     نعرف فحالةٌ أخرى تمامًا: **الملفّ سليم ونحن القديمون**، وتخمينُ محتواه قد يمحو تسجيل منتجٍ
+ *     كتبته واجهةٌ أحدث.
+ * EN: Reading the raw file. **Every failure here reads as "no registry", not as "a fault"** — with
+ *     one exception: a newer schema.
+ *
+ *     A missing file, a half-written one because the power went out mid-write, or corrupt JSON all
+ *     mean the shortcut is gone, and the answer is to rebuild it rather than to stop the user. A
+ *     `schemaVersion` higher than we know is an entirely different case: **the file is sound and we
+ *     are the old ones**, and guessing at its contents could erase a product a newer CLI recorded.
+ */
+function readRaw() {
+    if (!existsSync(REGISTRY_FILE))
+        return "unreadable";
+    try {
+        const parsed = JSON.parse(readFileSync(REGISTRY_FILE, "utf8"));
+        if (typeof parsed.schemaVersion !== "number")
+            return "unreadable";
+        if (parsed.schemaVersion > REGISTRY_SCHEMA_VERSION)
+            return "newer";
+        if (!Array.isArray(parsed.products))
+            return "unreadable";
+        return { schemaVersion: parsed.schemaVersion, products: parsed.products.filter(isProduct) };
+    }
+    catch {
+        return "unreadable";
+    }
+}
+function isProduct(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const row = value;
+    return typeof row.id === "string" && typeof row.root === "string" && typeof row.version === "string";
+}
+/**
+ * AR: الكتابة **ذرّية**: ملفٌّ مؤقّت ثم إحلال. انقطاع الكهرباء لحظة الكتابة يترك الملفّ القديم
+ *     كاملًا أو الجديد كاملًا، ولا يترك نصفه — ونصفُ JSON يُقرأ تلفًا فيُعاد البناء بلا داعٍ.
+ *     نفس ما تفعله ‎supervisor/state-files.ts‎ ولنفس السبب.
+ * EN: Writing is **atomic**: a temporary file, then a rename. A power cut mid-write leaves either
+ *     the whole old file or the whole new one, never half — and half a JSON file reads as corruption
+ *     and triggers a rebuild for nothing. The same thing `supervisor/state-files.ts` does, for the
+ *     same reason.
+ */
+function writeRaw(file) {
+    mkdirSync(REGISTRY_DIR, { recursive: true });
+    const temporary = `${REGISTRY_FILE}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify(file, null, 2)}\n`, "utf8");
+    rmSync(REGISTRY_FILE, { force: true });
+    renameSync(temporary, REGISTRY_FILE);
+}
+/**
+ * AR: يقرأ شجرة تثبيتٍ ويستنتج ما يعرفه عنها. **البيان هو الدليل**: مجلدٌ بلا ‎versions.json‎
+ *     صالح ليس تثبيتًا لنا مهما كان اسمه، وقبولُه يُدرِج في السجلّ مجلدًا عشوائيًّا.
+ * EN: Reads an install tree and infers what it can. **The manifest is the proof**: a directory
+ *     without a valid `versions.json` is not one of our installations whatever it is called, and
+ *     accepting it would list a random folder in the registry.
+ */
+export function inspectRoot(root, id = "estraha") {
+    if (!existsSync(join(root, MANIFEST_FILE)))
+        return undefined;
+    const manifest = readManifest(root);
+    if (!manifest)
+        return undefined;
+    let ports = { core: 80, live: 8081 };
+    try {
+        const config = JSON.parse(readFileSync(join(root, "config.json"), "utf8"));
+        ports = { core: config.corePort ?? ports.core, live: config.livePort ?? ports.live };
+    }
+    catch {
+        // إعداداتٌ غير مقروءة لا تُسقط تثبيتًا موجودًا؛ المنافذ الافتراضية تُعرَض ويصحّحها ‎doctor‎.
+    }
+    return {
+        id,
+        version: manifest.bundle.version,
+        root,
+        ports,
+        installedAt: manifest.bundle.builtAt,
+        installedBy: installerStamp(),
+    };
+}
+/**
+ * AR: يعيد بناء السجلّ من الأنظمة نفسها. يُستدعى حين يضيع الملفّ أو يتلف، **ولا يُستدعى في كل
+ *     أمر**: المسح أبطأ من قراءة ملفّ، والاختصار الذي يُحسَب في كل مرّة ليس اختصارًا.
+ * EN: Rebuilds the registry from the installations themselves. Called when the file is lost or
+ *     corrupt, **not on every command**: scanning is slower than reading a file, and a shortcut
+ *     recomputed every time is not a shortcut.
+ */
+export function rebuild(extraRoots = []) {
+    const found = [];
+    for (const root of [...SEARCH_ROOTS, ...extraRoots]) {
+        const product = inspectRoot(root);
+        if (product && !found.some((row) => row.root.toLowerCase() === product.root.toLowerCase())) {
+            found.push(product);
+        }
+    }
+    return found;
+}
+/**
+ * AR: **القراءة الوحيدة التي تُستعمل في الأوامر.** تقرأ، وتُسقط ما لم يعد موجودًا على القرص،
+ *     وتعيد البناء عند الحاجة.
+ *
+ *     وإسقاطُ الجذر المفقود مقصود: قرصٌ نُزع أو مجلدٌ حُذف بيد أحدهم يترك قيدًا يشير إلى لا شيء،
+ *     وأمرُ حالةٍ يقرؤه يُبلّغ عن نظامٍ لا وجود له. ولا يُحذف القيد من الملفّ في القراءة — القراءة
+ *     لا تكتب؛ يسقط من الجواب، ويُكتب الملفّ عند أول تسجيلٍ أو إزالة.
+ * EN: **The only read the commands use.** It reads, drops what no longer exists on disk, and
+ *     rebuilds when it must.
+ *
+ *     Dropping a missing root is deliberate: an unplugged disk or a folder somebody deleted leaves
+ *     an entry pointing at nothing, and a status command reading it reports an appliance that does
+ *     not exist. The entry is not deleted from the file during a read — reads do not write; it is
+ *     dropped from the answer, and the file is rewritten at the next record or removal.
+ */
+export function readRegistry() {
+    const raw = readRaw();
+    if (raw === "newer")
+        return { products: [], rebuilt: false, newerSchema: true };
+    if (raw === "unreadable") {
+        const products = rebuild();
+        // AR: **الكتابة قد تفشل، والفشل لا يجوز أن يُسقط أمرًا.**
+        //
+        //     ‎%ProgramData%\Fantastic‎ تحتاج صلاحيات مسؤول للكتابة على أغلب الأجهزة، وهذه الدالّة
+        //     تُنادى من استنتاج ملفّ التشغيل — أي من **كل أمر**. فحسابٌ عاديّ يكتب ‎fantastic status‎
+        //     على جهازٍ ضاع سجلّه كان سيرى ‎EPERM‎ خامًّا بدل حالة النظام.
+        //
+        //     وهذا بالضبط ما ينقضه تعليق هذا الملفّ نفسه: «فقدانه أو تلفه لا يجوز أن يعطّل نظامًا
+        //     يعمل». والفقدان كان محروسًا، وفشلُ **الكتابة** لم يكن — والقاعدة واحدة: الحفظ اختصارٌ،
+        //     وتعذّرُه يعني إعادة المسح في المرّة القادمة لا توقّف الأمر الآن.
+        // EN: **The write can fail, and its failure must not bring down a command.**
+        //
+        //     `%ProgramData%\Fantastic` needs administrator rights to write on most machines, and this
+        //     function is called from profile resolution — that is, from **every command**. So an
+        //     ordinary account typing `fantastic status` on a machine whose registry was lost would see a
+        //     raw `EPERM` instead of the system's state.
+        //
+        //     Which is precisely what this file's own comment forbids: "losing or corrupting it must
+        //     never disable a working system". Loss was guarded; a failed **write** was not — and the
+        //     rule is the same: saving is a shortcut, and being unable to means rescanning next time
+        //     rather than stopping the command now.
+        if (products.length > 0) {
+            try {
+                writeRaw({ schemaVersion: REGISTRY_SCHEMA_VERSION, products });
+            }
+            catch {
+                // لا شيء يُقال هنا: المسح أعطى الجواب، والحفظ وحده هو ما تعذّر.
+            }
+        }
+        return { products, rebuilt: true, newerSchema: false };
+    }
+    const alive = raw.products.filter((product) => existsSync(join(product.root, MANIFEST_FILE)));
+    return { products: alive, rebuilt: false, newerSchema: false };
+}
+/**
+ * AR: يسجّل منتجًا بعد **نجاح** تثبيته. الموضع في ‎install.ts‎ مقصود: بعد PATH ومهمّة الإقلاع، مع
+ *     بقيّة الآثار خارج مجلد التثبيت — فتثبيتٌ فشل وتراجع لا يترك قيدًا يشير إلى شجرةٍ حُذفت.
+ * EN: Records a product after its installation **succeeded**. Its placement in `install.ts` is
+ *     deliberate: after PATH and the boot task, with the rest of the traces outside the install
+ *     directory — so a failed, rolled-back install leaves no entry pointing at a deleted tree.
+ */
+export function recordInstall(product) {
+    const current = readRaw();
+    const products = current === "unreadable" || current === "newer" ? rebuild() : current.products;
+    const without = products.filter((row) => row.id !== product.id);
+    writeRaw({ schemaVersion: REGISTRY_SCHEMA_VERSION, products: [...without, product] });
+}
+/** يزيل قيد منتجٍ بعد نجاح إزالته. غيابه أصلًا ليس خطأً — الغاية بلوغ حالةٍ لا تنفيذ خطوة. */
+export function forgetInstall(id) {
+    const current = readRaw();
+    if (current === "unreadable" || current === "newer")
+        return;
+    writeRaw({
+        schemaVersion: REGISTRY_SCHEMA_VERSION,
+        products: current.products.filter((row) => row.id !== id),
+    });
+}
+/**
+ * AR: منتجٌ واحد يُستنتَج، وأكثر يُطلب تحديده. **ولا يُخمَّن عند التعدّد**: أمرُ إيقافٍ يصيب
+ *     الجهاز الخطأ في استراحةٍ تعمل أسوأ من أمرٍ يسأل.
+ * EN: One product is inferred; more than one must be named. **Never guessed when there are
+ *     several**: a stop command hitting the wrong appliance in a working rest-house is worse than a
+ *     command that asks.
+ */
+export function resolveProduct(products, requested) {
+    if (requested) {
+        const match = products.find((row) => row.id === requested);
+        return { product: match, ambiguous: false, unknown: !match };
+    }
+    if (products.length === 1)
+        return { product: products[0], ambiguous: false, unknown: false };
+    return { ambiguous: products.length > 1, unknown: products.length === 0 };
+}
+/** يُستعمل في الاختبارات وحدها: يمسح الملفّ. لا أمر ينادي هذه. */
+export function forgetEverything() {
+    rmSync(REGISTRY_FILE, { force: true });
+}
+//# sourceMappingURL=local-registry.js.map

package/dist/registry/local-registry.js.map

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

package/dist/render/banner.d.ts

@@ -0,0 +1,13 @@
+import { type BrandContext } from "./brand.js";
+export type BannerContext = BrandContext & {
+    /** يُعرَض تحت الشعار حين يُعرَف: «‏Welcome back, …». غيابه يعني ترحيبًا عامًّا لا اسمًا مخترَعًا. */
+    ownerName?: string;
+};
+/**
+ * البانر الكامل: الشعار، ثم الاسم والوصف، ثم الترحيب والسياق.
+ *
+ * يُعيد نصًّا فارغًا خارج الطرفية — زخرفةٌ داخل أنبوب تُفسد المخرَج الذي يقرؤه سكربت، والصمت هناك
+ * أصدق من الجمال (نفس قاعدة ‎renderBrand‎).
+ */
+export declare function renderBanner(context?: BannerContext): string;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/render/banner.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAyDhE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoBhE"}

package/dist/render/banner.js

@@ -0,0 +1,83 @@
+import { c, isTty } from "./theme.js";
+import { renderBrandLine } from "./brand.js";
+// AR: بانر الافتتاح. الشعار مولَّد بـ ‎figlet‎ (خطّ ‎ANSI Shadow‎) **مرّة واحدة وقت الكتابة، ومثبَّت
+//     هنا ثابتًا** — لا تُستدعى المكتبة وقت التشغيل. ثلاثة أسباب مقيسة لا تفضيل:
+//       ١. الكلمة واحدة لا تتغيّر. جلب مكتبة تقرأ ملفّ خطّ وتحلّله عند **كل** استدعاء لأمر يُكتب
+//          عشرات المرّات في اليوم ثمنٌ يُدفع دائمًا مقابل نتيجة ثابتة.
+//       ٢. حزمة الجهاز تُبنى لتُثبَّت بلا إنترنت؛ كل اعتمادية إضافية ملفّاتٌ تُشحن وتُقلَّم وتُدقَّق.
+//       ٣. ‎claude code‎ و‎gemini cli‎ — وهما المرجعان المطلوبان — يشحنان رسمًا مُعدًّا سلفًا لا
+//          مولِّدًا وقت التشغيل، للسبب الأول نفسه.
+//     أي أن المكتبة عملت عملها مرّة، ونتيجتها هي ما شُحن.
+//
+//     **وهذا يعكس قرارًا سابقًا مكتوبًا في ‎brand.ts‎** («لا figlet، فهي تجعل كل CLI يشبه غيره»).
+//     ذاك القرار كان عن **الطابع**، وهو صحيح عن مولِّد عام يُستدعى بخطّ افتراضي؛ أما شعارٌ مُعدّ
+//     ومصوغ بألواننا فهو علامتنا لا علامةَ أداةٍ عامّة. سطر العلامة المضغوط باقٍ كما هو ويُستعمل
+//     حيث لا يتّسع البانر.
+// EN: The opening banner. The wordmark is figlet-generated (ANSI Shadow) **once at authoring time and
+//     frozen here as a constant** — the library is never called at runtime. Three measured reasons,
+//     not a preference:
+//       1. The word never changes. Pulling in a library that reads and parses a font file on **every**
+//          invocation of a command typed dozens of times a day is a permanent cost for a fixed result.
+//       2. The appliance bundle is built to install with no internet; every extra dependency is files
+//          to ship, prune and audit.
+//       3. claude code and gemini cli — the two references asked for — ship pre-rendered art rather
+//          than a runtime generator, for the same first reason.
+//     The library did its work once; what ships is its output.
+//
+//     **This reverses an earlier decision written in brand.ts** ("no figlet, it makes every CLI look
+//     like every other"). That decision was about *character*, and it is right about a generic
+//     generator called with a default font; a wordmark that is authored and coloured in our own
+//     palette is our mark, not a generic tool's. The compact brand line stays and is used wherever
+//     the banner does not fit.
+/**
+ * ‎ANSI Shadow‎ لكلمة ‎Fantastic‎. عرضه 71 عمودًا، وهو ما تقيس عليه ‎MIN_BANNER_COLUMNS‎ أدناه.
+ * لا يُحرَّر بيد: يُعاد توليده بنفس الخطّ إن تغيّر الاسم.
+ */
+const WORDMARK_ART = [
+    "███████╗ █████╗ ███╗   ██╗████████╗ █████╗ ███████╗████████╗██╗ ██████╗",
+    "██╔════╝██╔══██╗████╗  ██║╚══██╔══╝██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝",
+    "█████╗  ███████║██╔██╗ ██║   ██║   ███████║███████╗   ██║   ██║██║",
+    "██╔══╝  ██╔══██║██║╚██╗██║   ██║   ██╔══██║╚════██║   ██║   ██║██║",
+    "██║     ██║  ██║██║ ╚████║   ██║   ██║  ██║███████║   ██║   ██║╚██████╗",
+    "╚═╝     ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝ ╚═════╝",
+];
+const ART_COLUMNS = 71;
+const GUTTER = " ";
+/**
+ * أضيق طرفية يُرسَم فيها البانر. تحتها **يُستبدَل لا يُقصّ**: رسمٌ ملفوف على سطرين ركامُ رموز لا
+ * شعار، وسطر العلامة المضغوط يقول الشيء نفسه ويقرأ في أي عرض.
+ */
+const MIN_BANNER_COLUMNS = ART_COLUMNS + GUTTER.length + 1;
+const PRODUCT_NAME = "Fantastic Media";
+const TAGLINE = "Your rest house's own cinema — served from this machine, over your own network.";
+function terminalColumns() {
+    return process.stdout.columns ?? 0;
+}
+function welcomeLine(ownerName) {
+    return ownerName ? `Welcome back, ${ownerName}.` : "Welcome.";
+}
+/**
+ * البانر الكامل: الشعار، ثم الاسم والوصف، ثم الترحيب والسياق.
+ *
+ * يُعيد نصًّا فارغًا خارج الطرفية — زخرفةٌ داخل أنبوب تُفسد المخرَج الذي يقرؤه سكربت، والصمت هناك
+ * أصدق من الجمال (نفس قاعدة ‎renderBrand‎).
+ */
+export function renderBanner(context = {}) {
+    if (!isTty)
+        return "";
+    const details = [context.profile, context.version, context.root].filter(Boolean).join(c.dim(" · "));
+    // طرفية ضيّقة: السطر المضغوط بدل رسمٍ ينكسر.
+    if (terminalColumns() < MIN_BANNER_COLUMNS) {
+        return ["", ` ${renderBrandLine(context)}`, ` ${c.dim(welcomeLine(context.ownerName))}`, ""].join("\n");
+    }
+    const art = WORDMARK_ART.map((row) => `${GUTTER}${c.accent(row)}`);
+    return [
+        "",
+        ...art,
+        "",
+        ` ${c.label(PRODUCT_NAME)}   ${c.dim(TAGLINE)}`,
+        ` ${welcomeLine(context.ownerName)}${details ? `   ${c.dim(details)}` : ""}`,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=banner.js.map

package/dist/render/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/render/banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAEhE,qGAAqG;AACrG,iFAAiF;AACjF,iGAAiG;AACjG,uEAAuE;AACvE,sGAAsG;AACtG,iGAAiG;AACjG,mDAAmD;AACnD,0DAA0D;AAC1D,EAAE;AACF,kGAAkG;AAClG,iGAAiG;AACjG,iGAAiG;AACjG,2BAA2B;AAC3B,sGAAsG;AACtG,oGAAoG;AACpG,wBAAwB;AACxB,uGAAuG;AACvG,uGAAuG;AACvG,sGAAsG;AACtG,qCAAqC;AACrC,oGAAoG;AACpG,gEAAgE;AAChE,+DAA+D;AAC/D,EAAE;AACF,qGAAqG;AACrG,+FAA+F;AAC/F,gGAAgG;AAChG,mGAAmG;AACnG,+BAA+B;AAE/B;;;GAGG;AACH,MAAM,YAAY,GAAG;IACnB,yEAAyE;IACzE,yEAAyE;IACzE,oEAAoE;IACpE,oEAAoE;IACpE,yEAAyE;IACzE,yEAAyE;CACjE,CAAC;AAEX,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,MAAM,GAAG,GAAG,CAAC;AAEnB;;;GAGG;AACH,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AAE3D,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,OAAO,GAAG,iFAAiF,CAAC;AAOlG,SAAS,eAAe;IACtB,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,SAA6B;IAChD,OAAO,SAAS,CAAC,CAAC,CAAC,iBAAiB,SAAS,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpG,6CAA6C;IAC7C,IAAI,eAAe,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAC3C,OAAO,CAAC,EAAE,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEnE,OAAO;QACL,EAAE;QACF,GAAG,GAAG;QACN,EAAE;QACF,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC/C,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5E,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/render/boot.render.d.ts

@@ -0,0 +1,123 @@
+import { networkInterfaces } from "node:os";
+import type { DeviceInfo } from "../contracts/core.js";
+import type { Profile } from "../profiles/types.js";
+import type { PortConflict } from "../probes/port.probe.js";
+import type { StartOutcome, StopStep } from "../supervisor/orchestrator.js";
+/**
+ * AR: عناوين هذه الآلة على الشبكة، **مرتّبةً بالأرجحية**.
+ *
+ *     كانت الدالّة تُعيد «أوّل عنوان IPv4 غير محلّي» — وهو ترتيبُ ويندوز لبطاقاته لا ترتيبُ
+ *     صلاحيتها. على آلة الاختبار كان الأوّل ‎192.168.56.1‎ (بطاقة VirtualBox المضيفة) بينما
+ *     الشبكة الحقيقية ‎192.168.1.6‎ على الواي-فاي؛ فالسطر المعروض للمالك ليكتبه في هاتفه كان
+ *     عنوانًا **لا يفتح شيئًا من أي هاتف** — وهو أسوأ من غياب السطر، لأن الفشل يُقرأ عطبًا في
+ *     النظام لا خطأً في العنوان.
+ * EN: This machine's addresses on the network, **ordered by likelihood**.
+ *
+ *     The function used to return "the first non-internal IPv4" — which is Windows' ordering of its
+ *     cards, not an ordering of their usefulness. On the test machine the first was `192.168.56.1`
+ *     (VirtualBox's host-only card) while the real network was `192.168.1.6` over Wi-Fi; so the line
+ *     printed for the owner to type into his phone was an address that **opens nothing from any
+ *     phone** — worse than no line at all, because the failure reads as a fault in the system rather
+ *     than a wrong address.
+ */
+export declare function lanAddresses(): string[];
+/** نواة الترتيب، مفصولةً عن ‎os‎ لتُختبَر بواجهاتٍ مُصطنعة بدل شبكة آلة البناء. */
+export declare function rankLanAddresses(interfaces: ReturnType<typeof networkInterfaces>): string[];
+/** أرجح عنوان: هو ما يكتبه المالك في هاتفه للدخول على الجهاز من الشبكة. */
+export declare function lanAddress(): string | undefined;
+/**
+ * AR: عنوان شاشة التفعيل على هذه الآلة. يُطبع كلّما كان الجهاز محجوبًا: **الرسالة التي تقول
+ *     «غير مفعَّل» بلا عنوانٍ يُفتح تترك الفنّي يخمّن المسار.** ‎undefined‎ حين لا منفذ في
+ *     ملفّ التشغيل أصلًا.
+ * EN: The activation screen's address on this machine. Printed whenever the appliance is blocked:
+ *     **a message saying "not activated" without an address to open leaves the technician guessing
+ *     the path.** `undefined` when the profile has no port at all.
+ */
+export declare function activationUrl(profile: Profile): string | undefined;
+/**
+ * AR: العناوين الأربعة التي يحتاجها من يقف أمام الجهاز — **وهي أربعة لا اثنان**.
+ *
+ *     ‎Portal‎ ما يفتحه الضيف، و‎Login‎ باب المالك، و‎Dashboard‎ اللوحة نفسها بعد الدخول،
+ *     و‎Network‎ العنوان الذي يُكتب في هاتفٍ على شبكة الاستراحة. كان السطران الأخيران غائبين:
+ *     المالك يعرف أن ثمّة لوحة ولا يعرف مسارها، ومن أراد الاختبار من جوّاله كان يقرأ
+ *     ‎localhost‎ — وهو على جهازه هو، لا على الجهاز.
+ * EN: The four addresses whoever stands at the machine needs — **four rather than two**.
+ *
+ *     `Portal` is what a guest opens, `Login` the owner's door, `Dashboard` the panel itself once
+ *     signed in, and `Network` the address typed into a phone on the rest-house network. The last
+ *     two were missing: the owner knew a dashboard existed without knowing its path, and anyone
+ *     testing from a phone read `localhost` — which is their own device, not the appliance.
+ */
+export type PortalUrls = {
+    portal: string;
+    login: string;
+    dashboard: string;
+    /** ‎null‎ حين لا واجهة شبكة خارجية على هذه الآلة — لا عنوان يُكتب في هاتف. */
+    network: string | null;
+    /**
+     * AR: بقيّة عناوين الآلة، مرتّبةً. **الترتيب ترجيحٌ لا يقين**، فآلةٌ عليها بطاقتان حقيقيّتان
+     *     (سلكية وواي-فاي) لا يعرف أحد أيّهما على شبكة الضيوف. طباعتها تجعل العنوان الخاطئ سطرًا
+     *     يُجرَّب غيرُه، لا طريقًا مسدودًا يُقرأ عطبًا في النظام.
+     * EN: The machine's remaining addresses, in order. **The ranking is a guess, not a certainty**, and
+     *     on a machine with two real cards (wired and Wi-Fi) nobody knows which one is on the guest
+     *     network. Printing them turns a wrong address into a line with an alternative beside it,
+     *     rather than a dead end that reads as a fault in the system.
+     */
+    networkAlternates: string[];
+};
+/**
+ * AR: العناوين كبيانات لا كنصّ مرسوم. مصدرٌ واحد يقرأه الجدولُ في الطرفية و‎--json‎ معًا، فلا
+ *     يقول أحدهما ‎/admin‎ ويسكت الآخر عنه يوم يتغيّر مسار.
+ * EN: The addresses as data rather than drawn text. One source read by both the terminal table and
+ *     `--json`, so one of them cannot say `/admin` while the other stays silent about it the day a
+ *     path changes.
+ */
+export declare function portalUrls(profile: Profile): PortalUrls | null;
+export declare function renderUrls(profile: Profile): string;
+/**
+ * AR: تنبيه الجهاز المحجوب — يُطبع في ‎start‎ و‎status‎ معًا، ويغيب تمامًا حين تكون الرخصة سارية.
+ *
+ *     **هذا هو السطر الذي كان ناقصًا.** الخدمات تُقلع على جهاز بلا رخصة — وهذا مقصود: النواة
+ *     يجب أن تعمل ليُفتَح المتصفّح على شاشة التفعيل أصلًا، وإيقاف الإقلاع كان سيمنع العلاج مع
+ *     المرض. لكن الطرفية كانت تقول «كل شيء يعمل» وتنتهي، فيفتح المالك البوّابة ويجد واجهةً
+ *     تنهار على كل نداء بلا كلمةٍ واحدة تشرح لماذا.
+ *
+ *     ‎null‎ حين لا شيء يُقال: رخصةٌ سارية، أو نواةٌ لم تُسأل بعد (‎device === null‎) — والادّعاء
+ *     بأن الجهاز غير مفعَّل لأننا لم نستطع السؤال كذبةٌ بنفس حجم إخفاء الحقيقة.
+ *
+ * EN: The blocked-appliance notice — printed by both `start` and `status`, and absent entirely when
+ *     the licence is valid.
+ *
+ *     **This is the line that was missing.** The services do start on an unlicensed machine, and
+ *     that is deliberate: the core must run for a browser to reach the activation screen at all, and
+ *     refusing to boot would withhold the cure along with the disease. But the terminal said
+ *     "everything is running" and stopped there, so the owner opened the portal and found an
+ *     interface collapsing on every call without one word explaining why.
+ *
+ *     `null` when there is nothing to say: a valid licence, or a core that was never asked
+ *     (`device === null`) — claiming the machine is unactivated because we could not ask is a lie of
+ *     exactly the same size as hiding the truth.
+ */
+export declare function renderActivationNotice(profile: Profile, device: DeviceInfo | null): string | null;
+/**
+ * AR: سطر الباقة عند الإقلاع — **يُطبع حين تكون هناك خدمةٌ غير مشمولة، ويُسكت حين تكون الباقة
+ *     شاملة.** سطرٌ يقول «كل شيء مشمول» في كل إقلاع ضجيجٌ يُتعلَّم تجاهله، ثم يُتجاهَل معه السطر
+ *     الذي كان يهمّ.
+ *
+ *     ومن يقرأ مخرَج ‎start‎ ثم يبحث عن خدمةٍ لا تعمل يجب أن يجد السبب هنا لا بعد ساعة من
+ *     التشخيص: خدمة البث المباشر التي «لا تستجيب» قد تكون ببساطة خارج الباقة، والفرق بين
+ *     التشخيصين هو الفرق بين مكالمة مبيعات وليلةٍ ضائعة.
+ * EN: The package line at boot — **printed when some service is not included, and silent when the
+ *     package covers everything.** A line saying "everything is included" on every boot is noise
+ *     that gets learned and ignored, and the line that mattered gets ignored with it.
+ *
+ *     And whoever reads `start`'s output and then goes looking for a service that is not running
+ *     should find the reason here rather than an hour into diagnosis: a live service that "does not
+ *     respond" may simply be outside the package, and the difference between those two diagnoses is
+ *     the difference between a sales call and a lost night.
+ */
+export declare function renderPackageNotice(device: DeviceInfo | null): string | null;
+export declare function renderConflicts(conflicts: PortConflict[]): string;
+export declare function renderStartOutcome(outcome: StartOutcome): string;
+export declare function renderStopOutcome(steps: StopStep[]): string;
+//# sourceMappingURL=boot.render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boot.render.d.ts","sourceRoot":"","sources":["../../src/render/boot.render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAwD5E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,GAAG,MAAM,EAAE,CAa3F;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAmBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAc9D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBnD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAcjG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAa5E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAajE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA2BhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CA0B3D"}