@syncbridge/common 1.1.3 → 2.0.0

package/models/profile/log-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-options.js","sourceRoot":"","sources":["../../../src/models/profile/log-options.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IACrB,YAAY,IAA0B;QACpC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAMD,KAAK,CAAY;IAMjB,UAAU,CAAW;CACtB,CAAA;AAPC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,0BAA0B;KACxC,CAAC;;yCACe;AAMjB;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,iDAAiD;KAC/D,CAAC;;8CACmB;AAfV,UAAU;IADtB,WAAW,EAAE;;GACD,UAAU,CAgBtB;;AAED;;GAEG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,IAAiC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAMD,UAAU,CAAW;CACtB,CAAA;AADC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,0DAA0D;KACxE,CAAC;;qDACmB;AATV,iBAAiB;IAD7B,WAAW,EAAE;;GACD,iBAAiB,CAU7B"}
+{"version":3,"file":"log-options.js","sourceRoot":"","sources":["../../../src/models/profile/log-options.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAAY,IAAkC;QAC5C,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAGD,OAAO,CAAW;IAGlB,KAAK,CAAY;IAGjB,aAAa,CAAU;IAOvB,MAAM,CAAY;CACnB,CAAA;AAdC;IADC,QAAQ,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;mDACtC;AAGlB;IADC,QAAQ,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;;iDAC9C;AAGjB;IADC,QAAQ,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;yDAChC;AAOvB;IALC,QAAQ,CAAC;QACR,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;QACvB,WAAW,EACT,uHAAuH;KAC1H,CAAC;;kDACgB;AAnBP,kBAAkB;IAD9B,WAAW,EAAE;;GACD,kBAAkB,CAoB9B;;AAED;;GAEG;AAKI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;CAEpC,CAAA;AAFY,wBAAwB;IAJpC,WAAW,CAAC;QACX,WAAW,EAAE,uCAAuC;QACpD,gBAAgB,EAAE,GAAG,EAAE,CAAC,kBAAkB;KAC3C,CAAC;GACW,wBAAwB,CAEpC;;AAED;;GAEG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IACrB,YAAY,IAA0B;QACpC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAMD,KAAK,CAAY;IAMjB,UAAU,CAAW;IAMrB,QAAQ,CAA4B;CACrC,CAAA;AAbC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,0BAA0B;KACxC,CAAC;;yCACe;AAMjB;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,iDAAiD;KAC/D,CAAC;;8CACmB;AAMrB;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,yDAAyD;KACvE,CAAC;8BACS,wBAAwB;4CAAC;AArBzB,UAAU;IADtB,WAAW,EAAE;;GACD,UAAU,CAsBtB;;AAED;;GAEG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,IAAiC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAMD,UAAU,CAAW;CACtB,CAAA;AADC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,0DAA0D;KACxE,CAAC;;qDACmB;AATV,iBAAiB;IAD7B,WAAW,EAAE;;GACD,iBAAiB,CAU7B"}

package/models/profile/profile.d.ts

@@ -15,8 +15,8 @@ export declare class Profile {
     constructor(init?: Partial<Profile>);
     id: string;
     displayName: string;
-    processorUri: string;
-    processorVersion?: string;
+    appUri: string;
+    appVersion?: string;
     group?: string;
     description?: string;
     iconUrl?: string;

package/models/profile/profile.js

@@ -16,14 +16,14 @@ let ProfileSettings = class ProfileSettings {
 __decorate([
     ApiField({
         label: 'Auto Start',
-        description: 'Determines if the processor will be auto started or not',
+        description: 'Determines if the app will be auto started or not',
     }),
     __metadata("design:type", Boolean)
 ], ProfileSettings.prototype, "autostart", void 0);
 __decorate([
     ApiField({
         label: 'Logs',
-        description: 'Log settings of the processor',
+        description: 'Log settings of the app',
     }),
     __metadata("design:type", ProfileLogOptions)
 ], ProfileSettings.prototype, "logs", void 0);
@@ -59,19 +59,19 @@ __decorate([
 ], Profile.prototype, "displayName", void 0);
 __decorate([
     ApiField({
-        label: 'Processor URI',
-        description: 'URI of the processor',
+        label: 'App URI',
+        description: 'URI of the app',
         required: true,
     }),
     __metadata("design:type", String)
-], Profile.prototype, "processorUri", void 0);
+], Profile.prototype, "appUri", void 0);
 __decorate([
     ApiField({
-        label: 'Processor Version',
+        label: 'App Version',
         description: 'Determines which installed version will be used. This value accepts semver format. https://semver.npmjs.com/',
     }),
     __metadata("design:type", String)
-], Profile.prototype, "processorVersion", void 0);
+], Profile.prototype, "appVersion", void 0);
 __decorate([
     ApiField({
         label: 'Group',
@@ -104,14 +104,14 @@ __decorate([
 __decorate([
     ApiField({
         label: 'Components',
-        description: 'Components of the processor',
+        description: 'Components of the app',
     }),
     __metadata("design:type", ProfileComponentRecord)
 ], Profile.prototype, "components", void 0);
 __decorate([
     ApiField({
         label: 'Settings',
-        description: 'Settings of the processor',
+        description: 'Settings of the app',
     }),
     __metadata("design:type", ProfileSettings)
 ], Profile.prototype, "settings", void 0);

package/models/profile/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/models/profile/profile.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,YAAY,IAA+B;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAMD,SAAS,CAAW;IAMpB,IAAI,CAAqB;CAC1B,CAAA;AAPC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,yDAAyD;KACvE,CAAC;;kDACkB;AAMpB;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C,CAAC;8BACK,iBAAiB;6CAAC;AAfd,eAAe;IAD3B,WAAW,EAAE;;GACD,eAAe,CAgB3B;;AAED;;GAEG;AAEI,IAAM,OAAO,GAAb,MAAM,OAAO;IAClB,YAAY,IAAuB;QACjC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;CAkEF,CAAA;AA3DS;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,iCAAiC;QAC9C,QAAQ,EAAE,IAAI;KACf,CAAC;;mCACiB;AAOX;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,IAAI;KACf,CAAC;;4CAC0B;AAOpB;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,sBAAsB;QACnC,QAAQ,EAAE,IAAI;KACf,CAAC;;6CAC2B;AAOrB;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,8GAA8G;KACjH,CAAC;;iDACgC;AAM1B;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,0DAA0D;KACxE,CAAC;;sCACqB;AAMf;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,kBAAkB;KAChC,CAAC;;4CAC2B;AAMrB;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,UAAU;KACxB,CAAC;;wCACuB;AAOjB;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,QAAQ;KACf,CAAC;;uCACmC;AAM7B;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,6BAA6B;KAC3C,CAAC;8BACmB,sBAAsB;2CAAC;AAMpC;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,2BAA2B;KACzC,CAAC;8BACiB,eAAe;yCAAC;AApExB,OAAO;IADnB,WAAW,EAAE;;GACD,OAAO,CAqEnB"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/models/profile/profile.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,YAAY,IAA+B;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAMD,SAAS,CAAW;IAMpB,IAAI,CAAqB;CAC1B,CAAA;AAPC;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,mDAAmD;KACjE,CAAC;;kDACkB;AAMpB;IAJC,QAAQ,CAAC;QACR,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,yBAAyB;KACvC,CAAC;8BACK,iBAAiB;6CAAC;AAfd,eAAe;IAD3B,WAAW,EAAE;;GACD,eAAe,CAgB3B;;AAED;;GAEG;AAEI,IAAM,OAAO,GAAb,MAAM,OAAO;IAClB,YAAY,IAAuB;QACjC,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;CAkEF,CAAA;AA3DS;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,iCAAiC;QAC9C,QAAQ,EAAE,IAAI;KACf,CAAC;;mCACiB;AAOX;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,IAAI;KACf,CAAC;;4CAC0B;AAOpB;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,IAAI;KACf,CAAC;;uCACqB;AAOf;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,8GAA8G;KACjH,CAAC;;2CAC0B;AAMpB;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,0DAA0D;KACxE,CAAC;;sCACqB;AAMf;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,kBAAkB;KAChC,CAAC;;4CAC2B;AAMrB;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,UAAU;KACxB,CAAC;;wCACuB;AAOjB;IALP,QAAQ,CAAC;QACR,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,QAAQ;KACf,CAAC;;uCACmC;AAM7B;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uBAAuB;KACrC,CAAC;8BACmB,sBAAsB;2CAAC;AAMpC;IAJP,QAAQ,CAAC;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,qBAAqB;KACnC,CAAC;8BACiB,eAAe;yCAAC;AApExB,OAAO;IADnB,WAAW,EAAE;;GACD,OAAO,CAqEnB"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@syncbridge/common",
-  "version": "1.1.3",
+  "version": "2.0.0",
   "description": "SyncBridge Common utilities",
   "author": "Panates Inc",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/panates/syncbridge.git",
+    "url": "git+https://github.com/syncbridge-io/syncbridge.git",
     "directory": "packages/common"
   },
   "dependencies": {

package/registry/docs-sidebar.d.ts

@@ -0,0 +1,59 @@
+/**
+ * How a package's documents are listed, where its author tells it: a
+ * sidebar.json in docs/ (the package's own) or in docs/<ClassName>/ (an
+ * app's, component's or plugin's). Without one they are listed by their
+ * front matter's order and titles.
+ *
+ *   {
+ *     "items": [
+ *       "README.md",
+ *       { "doc": "user-guide.pdf",
+ *         "title": { "tr": "Kullanım kılavuzu", "en": "User guide" } },
+ *       { "label": { "tr": "Ağ", "en": "Network" },
+ *         "items": ["network.md", "firewall.md"] }
+ *     ]
+ *   }
+ *
+ * A document is named as it is in the package's own language, from where
+ * the sidebar is - its languages are found by its name (network.md for
+ * network.tr.md). A title is text, or text by language. A document not
+ * listed is read by a link to it alone.
+ */
+export declare const SIDEBAR_FILE = "sidebar.json";
+/** Text, or text by language: { "tr": "Ağ", "en": "Network" } */
+export type SidebarText = string | Record<string, string>;
+/** An item of a sidebar, as its author writes it */
+export type SidebarItemSource = string | {
+    doc: string;
+    title?: SidebarText;
+} | {
+    label: SidebarText;
+    items: SidebarItemSource[];
+};
+/** An item of a sidebar as kept: each document by its path in the package */
+export type SidebarItem = {
+    doc: string;
+    title?: SidebarText;
+} | {
+    label: SidebarText;
+    items: SidebarItem[];
+};
+/** A sidebar as kept: its items, each document by its path in the package */
+export interface DocsSidebar {
+    items: SidebarItem[];
+}
+/**
+ * Whose a sidebar is, by its path in the package: '' for docs/sidebar.json
+ * (the package's own), the class for docs/<ClassName>/sidebar.json; none
+ * if it is not where a sidebar may be
+ */
+export declare function sidebarOwner(file: string): string | undefined;
+/**
+ * Reads a sidebar: what its author wrote, each document found among `docs`
+ * - the paths, in the package's own language, the package's documents are
+ * read by (docs/Gw/network.md, for network.md and network.tr.md alike).
+ * Throws, telling every problem, when it is not one.
+ */
+export declare function parseSidebar(file: string, source: unknown, docs: ReadonlySet<string>): DocsSidebar;
+/** The documents a sidebar lists, by their paths */
+export declare function sidebarDocs(sidebar: DocsSidebar): string[];

package/registry/docs-sidebar.js

@@ -0,0 +1,170 @@
+import { SbError } from '../classes/sb-error.js';
+import { CLASS_DIR_PATTERN, DOCS_DIR, isDocsLanguage } from './package-docs.js';
+/**
+ * How a package's documents are listed, where its author tells it: a
+ * sidebar.json in docs/ (the package's own) or in docs/<ClassName>/ (an
+ * app's, component's or plugin's). Without one they are listed by their
+ * front matter's order and titles.
+ *
+ *   {
+ *     "items": [
+ *       "README.md",
+ *       { "doc": "user-guide.pdf",
+ *         "title": { "tr": "Kullanım kılavuzu", "en": "User guide" } },
+ *       { "label": { "tr": "Ağ", "en": "Network" },
+ *         "items": ["network.md", "firewall.md"] }
+ *     ]
+ *   }
+ *
+ * A document is named as it is in the package's own language, from where
+ * the sidebar is - its languages are found by its name (network.md for
+ * network.tr.md). A title is text, or text by language. A document not
+ * listed is read by a link to it alone.
+ */
+export const SIDEBAR_FILE = 'sidebar.json';
+/** Categories within categories, at most */
+const MAX_DEPTH = 3;
+/**
+ * Whose a sidebar is, by its path in the package: '' for docs/sidebar.json
+ * (the package's own), the class for docs/<ClassName>/sidebar.json; none
+ * if it is not where a sidebar may be
+ */
+export function sidebarOwner(file) {
+    const parts = file.split('/');
+    if (parts[0] !== DOCS_DIR || parts[parts.length - 1] !== SIDEBAR_FILE)
+        return;
+    if (parts.length === 2)
+        return '';
+    if (parts.length === 3 && CLASS_DIR_PATTERN.test(parts[1]))
+        return parts[1];
+}
+/**
+ * Reads a sidebar: what its author wrote, each document found among `docs`
+ * - the paths, in the package's own language, the package's documents are
+ * read by (docs/Gw/network.md, for network.md and network.tr.md alike).
+ * Throws, telling every problem, when it is not one.
+ */
+export function parseSidebar(file, source, docs) {
+    const owner = sidebarOwner(file);
+    if (owner === undefined)
+        throw new SbError(`${file}: a sidebar is ${DOCS_DIR}/${SIDEBAR_FILE} or ${DOCS_DIR}/<ClassName>/${SIDEBAR_FILE}`);
+    const dir = owner ? `${DOCS_DIR}/${owner}` : DOCS_DIR;
+    const errors = [];
+    const listed = new Set();
+    const text = (value, at) => {
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const entries = Object.entries(value);
+            const bad = entries.filter(([lang, t]) => !isDocsLanguage(lang) || typeof t !== 'string' || !t.trim());
+            if (entries.length && !bad.length)
+                return Object.fromEntries(entries.map(([l, t]) => [l, t.trim()]));
+        }
+        errors.push(`${at}: text, or text by language ({ "tr": "...", "en": "..." })`);
+    };
+    const doc = (name, at) => {
+        if (typeof name !== 'string' || !name) {
+            errors.push(`${at}: a document's name, from where the sidebar is`);
+            return;
+        }
+        const parts = dir.split('/');
+        for (const part of name.split('/')) {
+            if (part === '..')
+                parts.pop();
+            else if (part && part !== '.')
+                parts.push(part);
+        }
+        const path = parts.join('/');
+        if (!path.startsWith(dir + '/') || (!owner && isModuleDoc(path))) {
+            errors.push(`${at}: "${name}" is not ${owner ? `${owner}'s` : "the package's own"} - a sidebar lists the documents beside it`);
+            return;
+        }
+        if (!docs.has(path)) {
+            errors.push(`${at}: "${name}" is not a document of the package - named as in its own language, without one (network.md, not network.tr.md)`);
+            return;
+        }
+        if (listed.has(path)) {
+            errors.push(`${at}: "${name}" is listed twice`);
+            return;
+        }
+        listed.add(path);
+        return path;
+    };
+    const items = (value, at, depth) => {
+        if (!Array.isArray(value)) {
+            errors.push(`${at}: a list of items`);
+            return [];
+        }
+        const out = [];
+        value.forEach((item, i) => {
+            const here = `${at}[${i}]`;
+            if (typeof item === 'string') {
+                const path = doc(item, here);
+                if (path)
+                    out.push({ doc: path });
+                return;
+            }
+            if (!item || typeof item !== 'object' || Array.isArray(item)) {
+                errors.push(`${here}: a document's name, or an object`);
+                return;
+            }
+            const keys = Object.keys(item);
+            if ('doc' in item) {
+                const unknown = keys.filter(k => k !== 'doc' && k !== 'title');
+                if (unknown.length)
+                    errors.push(`${here}: "${unknown.join('", "')}" is not read`);
+                const path = doc(item.doc, `${here}.doc`);
+                const title = item.title === undefined
+                    ? undefined
+                    : text(item.title, `${here}.title`);
+                if (path)
+                    out.push(title ? { doc: path, title } : { doc: path });
+            }
+            else if ('label' in item) {
+                const unknown = keys.filter(k => k !== 'label' && k !== 'items');
+                if (unknown.length)
+                    errors.push(`${here}: "${unknown.join('", "')}" is not read`);
+                if (depth >= MAX_DEPTH)
+                    errors.push(`${here}: categories go ${MAX_DEPTH} deep at most`);
+                const label = text(item.label, `${here}.label`);
+                const inner = items(item.items, `${here}.items`, depth + 1);
+                if (label)
+                    out.push({ label, items: inner });
+            }
+            else
+                errors.push(`${here}: a document ("doc") or a category ("label" and "items")`);
+        });
+        return out;
+    };
+    let result = [];
+    if (!source || typeof source !== 'object' || Array.isArray(source))
+        errors.push(`${file}: an object, its "items" listed`);
+    else {
+        const unknown = Object.keys(source).filter(k => k !== 'items');
+        if (unknown.length)
+            errors.push(`${file}: "${unknown.join('", "')}" is not read`);
+        result = items(source.items, `${file}: items`, 0);
+    }
+    if (errors.length)
+        throw new SbError(errors.join('\n'));
+    return { items: result };
+}
+/** A path in docs/ that is a module's: in docs/<ClassName>/ */
+function isModuleDoc(path) {
+    const parts = path.split('/');
+    return parts.length > 2 && CLASS_DIR_PATTERN.test(parts[1]);
+}
+/** The documents a sidebar lists, by their paths */
+export function sidebarDocs(sidebar) {
+    const out = [];
+    const walk = (items) => {
+        for (const item of items)
+            if ('doc' in item)
+                out.push(item.doc);
+            else
+                walk(item.items);
+    };
+    walk(sidebar.items);
+    return out;
+}
+//# sourceMappingURL=docs-sidebar.js.map

package/registry/docs-sidebar.js.map

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

package/registry/extension-package.d.ts

@@ -1,10 +1,10 @@
 import 'reflect-metadata';
 import type { Type } from 'ts-gems';
+import { AppBase } from '../classes/app-base.js';
 import { BaseElement } from '../classes/base-element.js';
 import { ComponentBase } from '../classes/component-base.js';
-import { ProcessorBase } from '../classes/processor-base.js';
-import { ComponentMetadata, ElementMetadata, ProcessorMetadata } from '../models/index.js';
-import { type ExtensionPackageJson } from './package-manifest.js';
+import { AppMetadata, ComponentMetadata, ElementMetadata, PluginMetadata } from '../models/index.js';
+import type { ExtensionPackageJson, SyncBridgeManifest } from './package-manifest.js';
 /**
  *
  */
@@ -14,30 +14,37 @@ export declare class ExtensionPackage {
     description: string;
     path: string;
     entryPoint: string;
-    /** See `getManifestVersion`; `undefined` for a class registered directly */
-    manifestVersion?: number;
     /** Registry packages this one depends on: registry name -> semver range */
     registryDependencies: Record<string, string>;
     /** What the package expects the host to provide */
     peerDependencies: Record<string, string>;
     components: ComponentExtension[];
-    processors: ProcessorExtension[];
+    apps: AppExtension[];
+    plugins: PluginExtension[];
     errors: Error[];
+    /** What was passed over reading the package: fields of its manifest SyncBridge does not know */
+    warnings: string[];
     /**
-     * Takes the package's identity and dependencies from its `package.json`.
+     * Takes the package's identity and dependencies from its `package.json`
+     * and its manifest (see readExtensionManifest)
      */
-    assignManifest(pkgJson: ExtensionPackageJson): void;
+    assignManifest(pkgJson: ExtensionPackageJson, manifest?: SyncBridgeManifest): void;
 }
 /**
  *
  */
 export declare abstract class ExtensionBase {
-    abstract readonly kind: 'component' | 'processor';
+    abstract readonly kind: 'component' | 'app';
     protected _ctor?: Type;
     readonly pkg: ExtensionPackage;
     readonly exportName: string;
     readonly metadata: ElementMetadata;
     readonly className: string;
+    /**
+     * The module the class is exported from: its own, given in the manifest,
+     * or else the package's entry point
+     */
+    entryPoint?: string;
     protected constructor(pkg: ExtensionPackage, exportName: string, metadata: ElementMetadata, ctor?: Type<BaseElement>);
     get uri(): string;
     get displayName(): string;
@@ -56,10 +63,28 @@ export declare class ComponentExtension extends ExtensionBase {
 /**
  *
  */
-export declare class ProcessorExtension extends ExtensionBase {
-    readonly kind = "processor";
-    protected _ctor?: Type<ProcessorBase>;
-    readonly metadata: ProcessorMetadata;
-    constructor(pkg: ExtensionPackage, exportName: string, metadata: ProcessorMetadata, ctor?: Type<ProcessorBase>);
-    getClass(): Promise<Type<ProcessorBase>>;
+export declare class AppExtension extends ExtensionBase {
+    readonly kind = "app";
+    protected _ctor?: Type<AppBase>;
+    readonly metadata: AppMetadata;
+    constructor(pkg: ExtensionPackage, exportName: string, metadata: AppMetadata, ctor?: Type<AppBase>);
+    getClass(): Promise<Type<AppBase>>;
+}
+/**
+ * A plugin a package brings: it extends SyncBridge itself, loaded in the
+ * engine's main process, never in a worker
+ */
+export declare class PluginExtension {
+    readonly pkg: ExtensionPackage;
+    readonly exportName: string;
+    readonly metadata: PluginMetadata;
+    readonly kind = "plugin";
+    protected _ctor?: Type;
+    /** The module the class is exported from */
+    entryPoint?: string;
+    constructor(pkg: ExtensionPackage, exportName: string, metadata: PluginMetadata, ctor?: Type);
+    /** The name it is set by: `plugins.<name>` */
+    get name(): string;
+    get version(): string;
+    getClass(): Promise<Type>;
 }

package/registry/extension-package.js

@@ -1,11 +1,11 @@
 import 'reflect-metadata';
+import { AppBase } from '../classes/app-base.js';
 import { BaseElement } from '../classes/base-element.js';
 import { ComponentBase } from '../classes/component-base.js';
-import { ProcessorBase } from '../classes/processor-base.js';
 import { SbError } from '../classes/sb-error.js';
-import { ComponentMetadata, ElementMetadata, ProcessorMetadata, } from '../models/index.js';
-import { isComponentBase, isProcessorBase } from '../utils/type-guards.js';
-import { getManifestVersion, } from './package-manifest.js';
+import { CLASS_TYPE } from '../constants.js';
+import { AppMetadata, ComponentMetadata, ElementMetadata, PluginMetadata, } from '../models/index.js';
+import { isAppBase, isComponentBase } from '../utils/type-guards.js';
 /**
  *
  */
@@ -15,17 +15,20 @@ export class ExtensionPackage {
     /** What the package expects the host to provide */
     peerDependencies = {};
     components = [];
-    processors = [];
+    apps = [];
+    plugins = [];
     errors = [];
+    /** What was passed over reading the package: fields of its manifest SyncBridge does not know */
+    warnings = [];
     /**
-     * Takes the package's identity and dependencies from its `package.json`.
+     * Takes the package's identity and dependencies from its `package.json`
+     * and its manifest (see readExtensionManifest)
      */
-    assignManifest(pkgJson) {
-        this.name = pkgJson.syncbridge?.name || pkgJson.name;
+    assignManifest(pkgJson, manifest) {
+        this.name = manifest?.name || pkgJson.name;
         this.version = pkgJson.version;
         this.description = pkgJson.description;
-        this.manifestVersion = getManifestVersion(pkgJson);
-        this.registryDependencies = { ...pkgJson.syncbridge?.dependencies };
+        this.registryDependencies = { ...manifest?.dependencies };
         this.peerDependencies = { ...pkgJson.peerDependencies };
     }
 }
@@ -68,7 +71,7 @@ export class ComponentExtension extends ExtensionBase {
     async getClass() {
         if (this._ctor)
             return this._ctor;
-        const module = await import(this.pkg.entryPoint);
+        const module = await import(this.entryPoint || this.pkg.entryPoint);
         const ctor = module[this.exportName];
         if (!ctor)
             throw new SbError(`Exported component "${this.exportName}" not found in package "${this.pkg.name}"`);
@@ -83,26 +86,62 @@ export class ComponentExtension extends ExtensionBase {
 /**
  *
  */
-export class ProcessorExtension extends ExtensionBase {
-    kind = 'processor';
+export class AppExtension extends ExtensionBase {
+    kind = 'app';
     constructor(pkg, exportName, metadata, ctor) {
         super(pkg, exportName, metadata, ctor);
-        if (ctor && !isProcessorBase(ctor.prototype))
-            throw new SbError(`${ctor.name} does not extends ProcessorBase`);
+        if (ctor && !isAppBase(ctor.prototype))
+            throw new SbError(`${ctor.name} does not extends AppBase`);
     }
     async getClass() {
         if (this._ctor)
             return this._ctor;
-        const module = await import(this.pkg.entryPoint);
+        const module = await import(this.entryPoint || this.pkg.entryPoint);
         const ctor = module[this.exportName];
         if (!ctor)
-            throw new SbError(`Exported processor "${this.exportName}" not found in package "${this.pkg.name}"`);
+            throw new SbError(`Exported app "${this.exportName}" not found in package "${this.pkg.name}"`);
         if (typeof ctor !== 'function')
-            throw new SbError(`Exported processor "${this.exportName}" is not a class`);
-        if (!isProcessorBase(ctor.prototype))
-            throw new SbError(`Exported processor "${this.exportName}" does not extends ProcessorBase`);
+            throw new SbError(`Exported app "${this.exportName}" is not a class`);
+        if (!isAppBase(ctor.prototype))
+            throw new SbError(`Exported app "${this.exportName}" does not extends AppBase`);
         this._ctor = ctor;
         return this._ctor;
     }
 }
+/**
+ * A plugin a package brings: it extends SyncBridge itself, loaded in the
+ * engine's main process, never in a worker
+ */
+export class PluginExtension {
+    pkg;
+    exportName;
+    metadata;
+    kind = 'plugin';
+    _ctor;
+    constructor(pkg, exportName, metadata, ctor) {
+        this.pkg = pkg;
+        this.exportName = exportName;
+        this.metadata = metadata;
+        this._ctor = ctor;
+    }
+    /** The name it is set by: `plugins.<name>` */
+    get name() {
+        return this.metadata.name;
+    }
+    get version() {
+        return this.pkg.version;
+    }
+    async getClass() {
+        if (this._ctor)
+            return this._ctor;
+        const module = await import(this.entryPoint || this.pkg.entryPoint);
+        const ctor = module[this.exportName];
+        if (typeof ctor !== 'function')
+            throw new SbError(`Exported plugin "${this.exportName}" not found in package "${this.pkg.name}"`);
+        if (Reflect.getMetadata(CLASS_TYPE, ctor) !== 'plugin')
+            throw new SbError(`Exported plugin "${this.exportName}" is not decorated with @Plugin`);
+        this._ctor = ctor;
+        return ctor;
+    }
+}
 //# sourceMappingURL=extension-package.js.map

package/registry/extension-package.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-package.js","sourceRoot":"","sources":["../../src/registry/extension-package.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAEL,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAQ3B,2EAA2E;IAC3E,oBAAoB,GAA2B,EAAE,CAAC;IAClD,mDAAmD;IACnD,gBAAgB,GAA2B,EAAE,CAAC;IAC9C,UAAU,GAAyB,EAAE,CAAC;IACtC,UAAU,GAAyB,EAAE,CAAC;IACtC,MAAM,GAAY,EAAE,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,OAA6B;QAC1C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAY,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,oBAAoB,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;QACpE,IAAI,CAAC,gBAAgB,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAC1D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAgB,aAAa;IAEvB,KAAK,CAAQ;IACd,GAAG,CAAmB;IACtB,UAAU,CAAS;IACnB,QAAQ,CAAkB;IAC1B,SAAS,CAAS;IAE3B,YACE,GAAqB,EACrB,UAAkB,EAClB,QAAyB,EACzB,IAAwB;QAExB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACvD,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;IACnC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAC1C,IAAI,GAAG,WAAW,CAAC;IAI5B,YACE,GAAqB,EACrB,UAAkB,EAClB,QAA2B,EAC3B,IAA0B;QAE1B,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;YAC1C,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,iCAAiC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YACP,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,2BAA2B,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAClF,CAAC;QACJ,IAAI,OAAO,IAAI,KAAK,UAAU;YAC5B,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,kBAAkB,CACzD,CAAC;QACJ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;YAClC,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,kCAAkC,CACzE,CAAC;QACJ,IAAI,CAAC,KAAK,GAAG,IAAW,CAAC;QACzB,OAAO,IAAI,CAAC,KAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAC1C,IAAI,GAAG,WAAW,CAAC;IAI5B,YACE,GAAqB,EACrB,UAAkB,EAClB,QAA2B,EAC3B,IAA0B;QAE1B,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;YAC1C,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,iCAAiC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YACP,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,2BAA2B,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAClF,CAAC;QACJ,IAAI,OAAO,IAAI,KAAK,UAAU;YAC5B,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,kBAAkB,CACzD,CAAC;QACJ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;YAClC,MAAM,IAAI,OAAO,CACf,uBAAuB,IAAI,CAAC,UAAU,kCAAkC,CACzE,CAAC;QACJ,IAAI,CAAC,KAAK,GAAG,IAAW,CAAC;QACzB,OAAO,IAAI,CAAC,KAAM,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"extension-package.js","sourceRoot":"","sources":["../../src/registry/extension-package.ts"],"names":[],"mappings":"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"}