@ibgib/web-gib 0.0.28 → 0.0.30

package/dist/AUTO-GENERATED-version.d.mts

@@ -10,5 +10,5 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export declare const AUTO_GENERATED_VERSION = "0.0.28";
+export declare const AUTO_GENERATED_VERSION = "0.0.30";
 //# sourceMappingURL=AUTO-GENERATED-version.d.mts.map

package/dist/AUTO-GENERATED-version.mjs

@@ -10,5 +10,5 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export const AUTO_GENERATED_VERSION = '0.0.28';
+export const AUTO_GENERATED_VERSION = '0.0.30';
 //# sourceMappingURL=AUTO-GENERATED-version.mjs.map

package/dist/app-bootstrap/bootstrap.d.mts

@@ -0,0 +1,90 @@
+/**
+ * @module bootstrap
+ *
+ * Shared bootstrap entry point for ibgib-based web apps.
+ * Collapses the metaspace, globalThis, and shell-init boilerplate.
+ */
+import { RCLIArgInfo, RCLIParamInfo } from "@ibgib/helper-gib/dist/rcli/rcli-types.mjs";
+import { TransformResult } from "@ibgib/ts-gib/dist/types.mjs";
+import { AppBase_V1 } from "@ibgib/core-gib/dist/witness/app/app-base-v1.mjs";
+import { MetaspaceService } from "@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "@ibgib/core-gib/dist/witness/space/space-base-v1.mjs";
+import { IbGibAmbientContextConfig, IbGibGlobalThis_IbGibApp, IbGibIdentityContext, RequestCommentIbGib_V1 } from "./types.mjs";
+export interface TagConfig {
+    text: string;
+    icon: string;
+    description: string;
+}
+export interface BootstrapIbGibAppOptions<TApp extends AppBase_V1<any, any, any, any, any, any, any, any>> {
+    /** Application context configuration (IndexedDB names, etc.) */
+    config: IbGibAmbientContextConfig;
+    /** Accessor for the application's typed globalThis slot */
+    getGlobalThis: (config?: IbGibAmbientContextConfig) => IbGibGlobalThis_IbGibApp;
+    /** The main application witness class */
+    AppClass: new (data?: any, rel8ns?: any) => TApp;
+    /**
+     * Default data used when generating the very first version of this app.
+     * Only applied if `fnGetOrCreateApp` is omitted.
+     */
+    defaultAppData: any;
+    /**
+     * Optional. Provide an array of parameters the application supports.
+     */
+    paramInfos?: RCLIParamInfo[];
+    /**
+     * Optional. Provide initial args for bootstrap.
+     * Defaults to `['--interactive']`.
+     */
+    getOpeningArgs?: () => Promise<string[]>;
+    /**
+     * Optional. RCLI argument validation hook.
+     */
+    validateArgInfos?: (opts: {
+        argInfos: RCLIArgInfo[];
+    }) => string | undefined;
+    /**
+     * Optional. Hook called before initializing the app, but after metaspace is ready.
+     * Can be used to check environment, space state, etc.
+     */
+    onBeforeCreate?: (metaspace: MetaspaceService, space: IbGibSpaceAny) => Promise<void>;
+    /**
+     * Optional. Hook called immediately after the application witness is loaded or created.
+     * A good place to execute migrations before returning the 'ready' app.
+     */
+    onAppLoaded?: (app: TApp, isNew: boolean) => Promise<TApp>;
+    /**
+     * Nuclear escape hatch. Provide this to replace the entire app get-or-create flow.
+     * If provided, `onBeforeCreate`, `onAppLoaded`, and `defaultAppData` are ignored.
+     */
+    fnGetOrCreateApp?: (metaspace: MetaspaceService, space: IbGibSpaceAny) => Promise<TApp>;
+    /**
+     * Optional. Hook called to initialize identity context (e.g., keystone based auth).
+     */
+    resolveIdentity?: (metaspace: MetaspaceService) => Promise<IbGibIdentityContext | undefined>;
+    /**
+     * Optional. The point at which the application logic dictates its readiness to UI components.
+     * Typically this executes `getAppShellSvc().onEngineReady()`.
+     */
+    onReady?: (app: TApp) => void | Promise<void>;
+    /**
+     * Tags verified to exist in the global user space at startup.
+     */
+    ensureTags?: TagConfig[];
+    /**
+     * The key prefix used for allocating new spaces (e.g. `test_app_space`).
+     */
+    localSpaceNamePrefix?: string;
+    /**
+     * Optional hook to register AI agent function tracking and deprecations.
+     */
+    registerAgentFunctionInfos?: () => void;
+}
+export declare function bootstrapIbGibApp<TApp extends AppBase_V1<any, any, any, any, any, any, any, any>>(opts: BootstrapIbGibAppOptions<TApp>): Promise<void>;
+export declare function createRequestCommentIbGib_Common({ args, interpretedArgInfos, }: {
+    args: string[];
+    interpretedArgInfos: RCLIArgInfo[];
+}): Promise<TransformResult<RequestCommentIbGib_V1>>;
+export declare function validateParamInfos({ paramInfos }: {
+    paramInfos: RCLIParamInfo[];
+}): string[];
+//# sourceMappingURL=bootstrap.d.mts.map

package/dist/app-bootstrap/bootstrap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.mts","sourceRoot":"","sources":["../../src/app-bootstrap/bootstrap.mts"],"names":[],"mappings":"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"}

package/dist/app-bootstrap/bootstrap.mjs

@@ -0,0 +1,404 @@
+/**
+ * @module bootstrap
+ *
+ * Shared bootstrap entry point for ibgib-based web apps.
+ * Collapses the metaspace, globalThis, and shell-init boilerplate.
+ */
+import { clone, extractErrorMsg, getTimestamp, getUUID, pickRandom_Letters, } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { buildArgInfos } from "@ibgib/helper-gib/dist/rcli/rcli-helper.mjs";
+import { getIbAndGib, getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
+import { Factory_V1 as factory } from "@ibgib/ts-gib/dist/V1/factory.mjs";
+import { Rel8n } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { getFromSpace } from "@ibgib/core-gib/dist/witness/space/space-helper.mjs";
+import { createNewApp, getAppIb, getInfoFromAppIb } from "@ibgib/core-gib/dist/witness/app/app-helper.mjs";
+import { APP_REL8N_NAME } from '@ibgib/core-gib/dist/witness/app/app-constants.mjs';
+import { TAG_REL8N_NAME } from "@ibgib/core-gib/dist/common/tag/tag-constants.mjs";
+import { SPACE_NAME_REGEXP } from "@ibgib/core-gib/dist/witness/space/space-constants.mjs";
+import { SpecialIbGibType } from "@ibgib/core-gib/dist/common/other/other-types.mjs";
+import { alertUser, promptForSecret, promptForText } from "../helpers.web.mjs";
+import { Metaspace_Webspace } from "../witness/space/metaspace/metaspace-webspace/metaspace-webspace.mjs";
+import { LiveProxyIbGib } from "../witness/live-proxy-ibgib/live-proxy-ibgib-one-file.mjs";
+import { storageGet } from "../storage/storage-helpers.web.mjs";
+import { getIbGibGlobalThis_IbGib } from "../helpers.mjs";
+// ---------------------------------------------------------------------------
+// Main Flow
+// ---------------------------------------------------------------------------
+export async function bootstrapIbGibApp(opts) {
+    const lc = `[${bootstrapIbGibApp.name}]`;
+    const logalot = true; // Use a general log flag or derive from config
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const ibGibGlobalThis = opts.getGlobalThis(opts.config);
+        if (ibGibGlobalThis.bootstrapStarted) {
+            if (ibGibGlobalThis.bootstrapPromise) {
+                console.warn(`${lc} already bootstrapping — awaiting that promise.`);
+            }
+            else {
+                throw new Error(`(UNEXPECTED) bootstrapStarted but bootstrapPromise is falsy?`);
+            }
+        }
+        else {
+            ibGibGlobalThis.bootstrapStarted = true;
+            ibGibGlobalThis.bootstrapPromise = new Promise(async (resolve, reject) => {
+                try {
+                    const args = opts.getOpeningArgs
+                        ? await opts.getOpeningArgs()
+                        : ['--interactive'];
+                    const paramInfos = opts.paramInfos ?? [{ name: 'interactive', isFlag: true, argTypeName: 'boolean' }];
+                    const paramInfosErrors = validateParamInfos({ paramInfos });
+                    if (paramInfosErrors.length > 0) {
+                        throw new Error(`(UNEXPECTED) invalid PARAM_INFOS: ${paramInfosErrors.join('|')}`);
+                    }
+                    const argInfos = buildArgInfos({ args, paramInfos, logalot });
+                    if (opts.validateArgInfos) {
+                        const validationErrors = opts.validateArgInfos({ argInfos });
+                        if (validationErrors) {
+                            throw new Error(`Arg validation errors: ${validationErrors}`);
+                        }
+                    }
+                    await execFromArgs({ opts, args, argInfos, logalot });
+                    resolve();
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+        }
+        await ibGibGlobalThis.bootstrapPromise;
+        // Execute onReady securely outside the promise resolution to prevent deadlock
+        // when getComponentInstance is used by shell service.
+        if (opts.onReady) {
+            // Re-fetch the loaded app wrapper dynamically
+            const getApp = () => ibGibGlobalThis.appInstance || null;
+            await opts.onReady(getApp());
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`\n${lc} complete.`);
+        }
+    }
+}
+async function execFromArgs({ opts, args, argInfos, logalot, }) {
+    const lc = `[${execFromArgs.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const metaspace = await initMetaspace({ opts, logalot });
+        const ibgibGlobalThis_core = getIbGibGlobalThis_IbGib();
+        ibgibGlobalThis_core.metaspace = metaspace;
+        const ibgibGlobalThis = opts.getGlobalThis(opts.config);
+        ibgibGlobalThis.metaspace = metaspace;
+        if (opts.ensureTags) {
+            await ensureTagsExist({ metaspace, tags: opts.ensureTags, logalot });
+        }
+        if (opts.registerAgentFunctionInfos) {
+            opts.registerAgentFunctionInfos();
+        }
+        const resRequestCommentIbGib = await createRequestCommentIbGib_Common({
+            args, interpretedArgInfos: argInfos,
+        });
+        await metaspace.persistTransformResult({ resTransform: resRequestCommentIbGib });
+        ibgibGlobalThis.initialCommentIbGib = resRequestCommentIbGib.newIbGib;
+        const proxy = new LiveProxyIbGib();
+        await proxy.initialized;
+        proxy.setWrappedIbGib({ ibGib: resRequestCommentIbGib.newIbGib });
+        ibgibGlobalThis.initialCommentIbGibProxy = proxy;
+        if (opts.resolveIdentity) {
+            ibgibGlobalThis.identity = await opts.resolveIdentity(metaspace);
+        }
+        await execInteractive({ opts, resRequestCommentIbGib, metaspace, logalot });
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`\n${lc} complete.`);
+        }
+    }
+}
+async function initMetaspace({ opts, logalot }) {
+    const lc = `[${initMetaspace.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        let metaspace = new Metaspace_Webspace(/*cacheSvc*/ undefined);
+        const localSpaceNameKey = opts.localSpaceNamePrefix
+            ? `${opts.localSpaceNamePrefix}_local_space_name`
+            : `local_space_name`;
+        const existingLocalSpaceName = await storageGet({
+            dbName: opts.config.dbName,
+            storeName: opts.config.storeName,
+            key: localSpaceNameKey,
+        });
+        const prefix = opts.localSpaceNamePrefix ?? 'app_space';
+        const spaceName = existingLocalSpaceName
+            ? undefined
+            : await generateLocalSpaceName(prefix);
+        await metaspace.initialize({
+            spaceName,
+            metaspaceFactory: undefined,
+            getFnAlert: () => ({ title, msg }) => alertUser({ title, msg }),
+            getFnPrompt: () => ({ title, msg }) => promptForText({ title, msg, confirm: false }),
+            getFnPromptPassword: () => () => promptForSecret({ confirm: true }),
+        });
+        return metaspace;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+async function generateLocalSpaceName(prefix) {
+    const name = prefix + '_' + pickRandom_Letters({ count: 12 });
+    if (!SPACE_NAME_REGEXP.test(name)) {
+        throw new Error(`(UNEXPECTED) generated space name (${name}) failed regexp`);
+    }
+    return name;
+}
+async function execInteractive({ opts, resRequestCommentIbGib, metaspace, logalot }) {
+    const lc = `[${execInteractive.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const localUserSpace = await metaspace.getLocalUserSpace({ lock: false });
+        if (!localUserSpace) {
+            throw new Error(`(UNEXPECTED) localUserSpace falsy?`);
+        }
+        const app = opts.fnGetOrCreateApp
+            ? await opts.fnGetOrCreateApp(metaspace, localUserSpace)
+            : await defaultGetOrCreateApp({
+                AppClass: opts.AppClass,
+                defaultAppData: opts.defaultAppData,
+                onBeforeCreate: opts.onBeforeCreate,
+                onAppLoaded: opts.onAppLoaded,
+                metaspace,
+                space: localUserSpace,
+            });
+        // Track the app so `onReady` can access it cleanly
+        const ibgibGlobalThis = opts.getGlobalThis(opts.config);
+        ibgibGlobalThis.appInstance = app;
+        app.metaspace = metaspace;
+        await app.witness(resRequestCommentIbGib.newIbGib);
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+async function defaultGetOrCreateApp({ AppClass, defaultAppData, onBeforeCreate, onAppLoaded, metaspace, space, }) {
+    const lc = `[${defaultGetOrCreateApp.name}]`;
+    const logalot = true;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        let appsIbGib = await metaspace.getSpecialIbGib({
+            type: SpecialIbGibType.apps,
+            initialize: false, lock: false, space,
+        });
+        if (!appsIbGib) {
+            throw new Error(`(UNEXPECTED) no apps index ibgib`);
+        }
+        if (!appsIbGib.rel8ns) {
+            throw new Error(`(UNEXPECTED) appsIbGib.rel8ns falsy`);
+        }
+        const appAddrs = (appsIbGib.rel8ns[APP_REL8N_NAME] ?? [])
+            .filter(addr => {
+            const { ib } = getIbAndGib({ ibGibAddr: addr });
+            return getInfoFromAppIb({ appIb: ib }).appClassname === AppClass.name;
+        });
+        let app;
+        let appAddr;
+        let isNew = false;
+        if (appAddrs.length === 0) {
+            isNew = true;
+            if (onBeforeCreate) {
+                await onBeforeCreate(metaspace, space);
+            }
+            app = await createAndSaveNewApp({ AppClass, defaultAppData, metaspace, space });
+            appAddr = getIbGibAddr({ ibGib: app });
+        }
+        else if (appAddrs.length === 1) {
+            appAddr = appAddrs[0];
+        }
+        else {
+            const list = appAddrs
+                .map(a => getIbAndGib({ ibGibAddr: a }).ib)
+                .map((ib, idx) => `\n${idx}) ${ib}`);
+            let idx;
+            let retry = false;
+            do {
+                const response = await promptForText({
+                    title: 'Which App?',
+                    msg: `${retry ? 'huh? ' : ''}Multiple apps found. Which one?${list}`,
+                });
+                const parsed = Number.parseInt(response);
+                retry = Number.isNaN(parsed) || parsed >= appAddrs.length;
+                if (!retry) {
+                    idx = parsed;
+                }
+            } while (retry);
+            appAddr = appAddrs[idx];
+        }
+        const resGet = await getFromSpace({ addr: appAddr, space });
+        if (resGet.success && resGet.ibGibs?.length === 1) {
+            app = resGet.ibGibs[0];
+        }
+        else {
+            throw new Error(`Couldn't get app (${appAddr}).`);
+        }
+        if (!app.witness) {
+            const witness = new AppClass(undefined, undefined);
+            await witness.loadIbGibDto(app);
+            app = witness;
+        }
+        if (onAppLoaded) {
+            app = await onAppLoaded(app, isNew);
+        }
+        return app;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+async function createAndSaveNewApp({ AppClass, defaultAppData, metaspace, space, }) {
+    const lc = `[${createAndSaveNewApp.name}]`;
+    const logalot = true;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const fnPromptApp = (() => {
+            return async () => {
+                const name = `${AppClass.name}_${pickRandom_Letters({ count: 8 })}`;
+                const data = clone(defaultAppData);
+                data.name = name;
+                data.uuid = await getUUID();
+                const rel8ns = undefined; // App templates usually have DEFAULT_APP_REL8NS as undefined
+                const { classname } = data;
+                const ib = getAppIb({ appData: data, classname });
+                return await factory.firstGen({
+                    ib,
+                    parentIbGib: factory.primitive({ ib: `app ${classname}` }),
+                    data, rel8ns,
+                    dna: true,
+                    linkedRel8ns: [Rel8n.ancestor, Rel8n.past],
+                    nCounter: true,
+                    tjp: { timestamp: true },
+                });
+            };
+        })();
+        const app = await createNewApp({
+            fnPromptApp,
+            space,
+            ibgibs: metaspace,
+        });
+        if (!app) {
+            throw new Error(`Failed to create app (falsy).`);
+        }
+        if (app?.data?.classname !== AppClass.name) {
+            throw new Error(`(UNEXPECTED) wrong app classname.`);
+        }
+        return app;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+async function ensureTagsExist({ metaspace, tags, logalot }) {
+    const lc = `[${ensureTagsExist.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const tagIbGibs = await metaspace.getSpecialRel8dIbGibs({
+            type: "tags", rel8nName: TAG_REL8N_NAME,
+        });
+        for (const tag of tags) {
+            if (!tagIbGibs.some(x => x.data?.text === tag.text)) {
+                await metaspace.createTagIbGib({
+                    text: tag.text,
+                    icon: tag.icon,
+                    description: tag.description,
+                    space: undefined,
+                });
+            }
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export async function createRequestCommentIbGib_Common({ args, interpretedArgInfos, }) {
+    const text = args.join(' ');
+    const data = {
+        uuid: await getUUID(),
+        text,
+        args,
+        interpretedArgInfos,
+        textTimestamp: getTimestamp(),
+    };
+    return await factory.firstGen({
+        parentIbGib: factory.primitive({ ib: 'comment' }),
+        ib: `comment ${text.substring(0, 32).replace(/ /g, '_')}`,
+        data,
+        dna: true,
+        tjp: { uuid: true, timestamp: true },
+        nCounter: true,
+    });
+}
+export function validateParamInfos({ paramInfos }) {
+    const errors = [];
+    const identifiers = [];
+    paramInfos.forEach(p => {
+        const names = [p.name, ...(p.synonyms ?? [])];
+        names.forEach(name => {
+            if (identifiers.includes(name.toLowerCase())) {
+                errors.push(`Duplicate identifier found: ${name}`);
+            }
+            identifiers.push(name.toLowerCase());
+        });
+    });
+    return errors;
+}
+//# sourceMappingURL=bootstrap.mjs.map

package/dist/app-bootstrap/bootstrap.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.mjs","sourceRoot":"","sources":["../../src/app-bootstrap/bootstrap.mts"],"names":[],"mappings":"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"}

package/dist/app-bootstrap/init-orchestration.d.mts

@@ -0,0 +1,75 @@
+/**
+ * @module init-orchestration
+ *
+ * Shared web orchestration functions for booting ibgib-based frontend apps.
+ *
+ * ## what belongs here
+ *
+ * Functions that define the startup sequence and are identical across all
+ * ibgib apps. These depend only on the IbGibAmbientContextConfig seam.
+ * App-specific logic (typed globalThis accessors, component helpers) belongs
+ * in each app's own helpers.web.mts.
+ */
+import { IbGibDynamicComponentMetaCtorOpts } from "../ui/component/component-types.mjs";
+import { IbGibAmbientContextConfig, IbGibGlobalThis_Common, IbGibGlobalThis_IbGibApp } from "./types.mjs";
+/**
+ * Initializes the IndexedDB stores required by an ibgib app.
+ *
+ * Call once on DOMContentLoaded, before the bootstrap script is dynamically
+ * loaded. This ensures storage is available when the metaspace initializes.
+ */
+export declare function initIbGibStorage(config: IbGibAmbientContextConfig): Promise<void>;
+/**
+ * Sets up globalThis.ibgib.[globalThisKey] for the given app config.
+ *
+ * Idempotent — safe to call multiple times. The root `globalThis.ibgib` object
+ * is created if it doesn't exist, then the per-app sub-key is populated.
+ *
+ * @param config  The app's ambient context config.
+ * @param globalThisKey  The snake_case key for this app's namespace under
+ *   `globalThis.ibgib` (e.g. `'my_app'`, `'cool_new_thing'`).
+ * @param version  Optional semver string (from AUTO_GENERATED_VERSION).
+ */
+export declare function initIbGibGlobalThis(config: IbGibAmbientContextConfig, globalThisKey: string, version?: string): void;
+/**
+ * Returns the raw IbGibGlobalThis_Common for the given key.
+ * Typed as the Common base — use the app-specific typed accessor for
+ * full-type access.
+ */
+export declare function getIbGibGlobalThis_Common(globalThisKey: string): IbGibGlobalThis_Common;
+/**
+ * Returns the IbGibGlobalThis_IbGibApp for the given key, initializing it
+ * from config if not yet present.
+ */
+export declare function getIbGibGlobalThis_IbGibApp(globalThisKey: string, config?: IbGibAmbientContextConfig, version?: string): IbGibGlobalThis_IbGibApp;
+/**
+ * Returns a function that retrieves the AI API key from storage at call time.
+ * The globalThisKey links back to the per-app namespace for DB/store/key names.
+ */
+export declare function getDefaultFnGetAPIKey(globalThisKey: string): () => Promise<string>;
+/**
+ * Dynamically imports the bootstrap module at the given path and calls the
+ * named export bootstrap function.
+ *
+ * Called after DOMContentLoaded so the heavy ibgib import graph does not block
+ * first paint.
+ *
+ * @param path  Path to bootstrap.mjs (relative to the app's index.mts).
+ * @param bootstrapFnName  The exported async function to call. Defaults to
+ *   `'bootstrapApp'` — override with the app-specific function name
+ *   (e.g. `'bootstrapMyAppApp'`).
+ */
+export declare function dynamicallyLoadBootstrapScript(path: string, bootstrapFnName?: string): Promise<void>;
+/**
+ * Returns the standard ctor options object for IbGib dynamic components.
+ *
+ * Provides two things components need at construction time:
+ * 1. `fnGetMetaspace` — accesses the global metaspace once initialized
+ * 2. `bootstrapPromise` — components can await this to defer their own init
+ *    until the App witness and metaspace are fully ready
+ *
+ * @param globalThisKey  The per-app namespace key used to find the bootstrap
+ *   promise on globalThis.
+ */
+export declare function getComponentCtorArg(globalThisKey: string): IbGibDynamicComponentMetaCtorOpts;
+//# sourceMappingURL=init-orchestration.d.mts.map

package/dist/app-bootstrap/init-orchestration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-orchestration.d.mts","sourceRoot":"","sources":["../../src/app-bootstrap/init-orchestration.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAExF,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAM1G;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAevF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACjB,IAAI,CAkCN;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,sBAAsB,CAOvF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,MAAM,GACjB,wBAAwB,CAU1B;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,MAAM,GACtB,MAAM,OAAO,CAAC,MAAM,CAAC,CASvB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,8BAA8B,CAChD,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAuB,GACzC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,iCAAiC,CA4B5F"}