@ibgib/web-gib 0.0.28 → 0.0.29

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../../src/app-bootstrap/constants.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAEjF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACnD,yDAAyD,CAAC;AAE9D,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAC9B,qEAAqE,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAExD,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * @module helpers.web
+ *
+ * Shared web helper functions for ibgib-based frontend apps.
+ *
+ * ## what belongs here
+ *
+ * Functions that are identical across all ibgib apps and 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=helpers.web.d.mts.map

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

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

package/dist/app-bootstrap/helpers.web.mjs

@@ -0,0 +1,210 @@
+/**
+ * @module helpers.web
+ *
+ * Shared web helper functions for ibgib-based frontend apps.
+ *
+ * ## what belongs here
+ *
+ * Functions that are identical across all ibgib apps and depend only on the
+ * IbGibAmbientContextConfig seam. App-specific logic (typed globalThis
+ * accessors, component helpers) belongs in each app's own helpers.web.mts.
+ */
+import { delay, extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { storageGet } from "../storage/storage-helpers.web.mjs";
+import { initAppStorage } from "../helpers.web.mjs";
+import { getGlobalMetaspace_waitIfNeeded } from "../helpers.mjs";
+// ---------------------------------------------------------------------------
+// Storage initialization
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function initIbGibStorage(config) {
+    const lc = `[${initIbGibStorage.name}]`;
+    try {
+        await initAppStorage({
+            infos: [
+                {
+                    dbName: config.dbName,
+                    storeNames: [config.storeName, ...(config.additionalStoreNames ?? [])],
+                },
+            ],
+        });
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// globalThis initialization
+// ---------------------------------------------------------------------------
+/**
+ * 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 function initIbGibGlobalThis(config, globalThisKey, version) {
+    const lc = `[${initIbGibGlobalThis.name}]`;
+    try {
+        // Ensure the root ibgib object exists
+        if (!globalThis.ibgib) {
+            globalThis.ibgib = {
+                dbName_hack: config.dbName,
+                apiKeyName_hack: config.apiKeyName,
+                storeName_hack: config.storeName,
+            };
+        }
+        // Populate the per-app namespace
+        if (!globalThis.ibgib[globalThisKey]) {
+            globalThis.ibgib[globalThisKey] = {
+                version,
+                spaceShim: {},
+                fnDefaultGetAPIKey: async () => {
+                    const apiKey = await storageGet({
+                        dbName: config.dbName,
+                        storeName: config.storeName,
+                        key: config.apiKeyName,
+                    });
+                    return apiKey ?? '';
+                },
+                dbName_hack: config.dbName,
+                apiKeyName_hack: config.apiKeyName,
+                storeName_hack: config.storeName,
+            };
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// globalThis accessors
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getIbGibGlobalThis_Common(globalThisKey) {
+    const lc = `[${getIbGibGlobalThis_Common.name}]`;
+    const g = globalThis.ibgib?.[globalThisKey];
+    if (!g) {
+        throw new Error(`${lc} (UNEXPECTED) globalThis.ibgib.${globalThisKey} not initialized. (E: 8d621732ibgib-commonfe25)`);
+    }
+    return g;
+}
+/**
+ * Returns the IbGibGlobalThis_IbGibApp for the given key, initializing it
+ * from config if not yet present.
+ */
+export function getIbGibGlobalThis_IbGibApp(globalThisKey, config, version) {
+    if (!globalThis.ibgib?.[globalThisKey]) {
+        if (!config) {
+            throw new Error(`Global context not initialized and config not provided for key '${globalThisKey}'.`);
+        }
+        initIbGibGlobalThis(config, globalThisKey, version);
+    }
+    return globalThis.ibgib[globalThisKey];
+}
+// ---------------------------------------------------------------------------
+// API key helper
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getDefaultFnGetAPIKey(globalThisKey) {
+    return async () => {
+        const gb = getIbGibGlobalThis_IbGibApp(globalThisKey);
+        return (await storageGet({
+            dbName: gb.dbName_hack,
+            storeName: gb.storeName_hack,
+            key: gb.apiKeyName_hack,
+        })) ?? '';
+    };
+}
+// ---------------------------------------------------------------------------
+// Dynamic bootstrap loading
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function dynamicallyLoadBootstrapScript(path, bootstrapFnName = 'bootstrapApp') {
+    const lc = `[${dynamicallyLoadBootstrapScript.name}]`;
+    try {
+        const module = await import(path);
+        const fn = module[bootstrapFnName];
+        if (typeof fn !== 'function') {
+            throw new Error(`${lc} Bootstrap function '${bootstrapFnName}' not found in '${path}'. ` +
+                `Available exports: ${Object.keys(module).join(', ')} (E: 9136085eibgib-common26)`);
+        }
+        await fn();
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// Component constructor args helper
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getComponentCtorArg(globalThisKey) {
+    const fnGetMetaspace = async () => getGlobalMetaspace_waitIfNeeded();
+    const bootstrapPromiseWrapper = new Promise(async (resolve, reject) => {
+        try {
+            let maxTries = 100_000;
+            let counter = 0;
+            let bootstrapPromise;
+            do {
+                bootstrapPromise =
+                    getIbGibGlobalThis_IbGibApp(globalThisKey)?.bootstrapPromise;
+                counter++;
+                if (counter > maxTries) {
+                    break;
+                }
+                await delay(10);
+            } while (bootstrapPromise === undefined);
+            if (!bootstrapPromise) {
+                throw new Error(`Timed out waiting for bootstrapPromise on key '${globalThisKey}'. (E: 4048ce92ibgib-common26)`);
+            }
+            await bootstrapPromise;
+            resolve();
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+    return { fnGetMetaspace, bootstrapPromise: bootstrapPromiseWrapper };
+}
+//# sourceMappingURL=helpers.web.mjs.map

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

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

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

@@ -0,0 +1,163 @@
+/**
+ * @module types
+ *
+ * Shared type definitions for ibgib-based frontend apps.
+ *
+ * ## notes
+ *
+ * Three layers of globalThis state:
+ *   IbGibGlobalThisInfo          (@ibgib/web-gib — the root ibgib slot)
+ *       └── IbGibGlobalThis_Common     (bootstrap promise tracking)
+ *               └── IbGibGlobalThis_IbGibApp  (all ibgib App witness apps)
+ *                       └── IbGibGlobalThis_[AppName]   (per-app extensions)
+ */
+import { IbGibRel8ns_V1, IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { CommentData_V1 } from "@ibgib/core-gib/dist/common/comment/comment-types.mjs";
+import { RCLIArgInfo } from "@ibgib/helper-gib/dist/rcli/rcli-types.mjs";
+import { LiveProxyIbGib } from "../witness/live-proxy-ibgib/live-proxy-ibgib-one-file.mjs";
+import { IbGibGlobalThisInfo } from "../types.mjs";
+/**
+ * Configuration object that parameterizes an ibgib app's storage substrates.
+ *
+ * This is the primary seam between the framework layer and a specific app.
+ * Every downstream app creates exactly one APP_CONFIG and passes it to the
+ * framework helpers.
+ *
+ * ## notes
+ *
+ * Intended to be upstreamed into @ibgib/web-gib.
+ */
+export interface IbGibAmbientContextConfig {
+    /** Target IndexedDB database name */
+    dbName: string;
+    /** Primary object store name */
+    storeName: string;
+    /** Additional stores to initialize alongside the primary (e.g., ZERO_SPACE_ID) */
+    additionalStoreNames?: string[];
+    /** The IndexedDB key under which the AI API key is persisted */
+    apiKeyName: string;
+}
+/**
+ * Per-space shim that mimics a filesystem CWD context for ibgib RCLI compat.
+ */
+export interface SpaceShimGlobalInfo {
+    /**
+     * The initial cwd() value when the RCLI was started. Used as the context
+     * path the user types commands from.
+     */
+    initialCwd: string;
+    /** The active CWD, updated by pass-through `cd` commands. */
+    cwd: string;
+}
+/** @see {@link RequestCommentIbGib_V1} */
+export interface RequestCommentData_V1 extends CommentData_V1 {
+    /** As close to the raw args as we can get. */
+    args: string[];
+    /** Interpreted infos for args. */
+    interpretedArgInfos: RCLIArgInfo[];
+}
+export interface RequestCommentRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+/**
+ * Special Comment ibgib that acts as a "request" — the command analog from RCLI.
+ *
+ * The raw text of the command is `text` from `CommentData_V1`.
+ */
+export interface RequestCommentIbGib_V1 extends IbGib_V1<RequestCommentData_V1, RequestCommentRel8ns_V1> {
+    /** Kluge for one-off commandlines during initial development. */
+    oneOff: boolean;
+}
+/**
+ * Framework-level identity interface.
+ *
+ * ## design notes
+ *
+ * The implementation is entirely consumer-supplied. The framework defines only
+ * the shape of the slot so shells and components can react to auth state
+ * without coupling to a specific identity mechanism.
+ *
+ * For ibgib apps, the typical implementation will be keystone-based (a Merkle
+ * DAG proof of cryptographic identity continuity), not token-based.
+ *
+ * ## WIP caveat (atow April 2026)
+ *
+ * The keystone identity implementation in @ibgib/core-gib is still under
+ * active development. This interface represents the intended framework
+ * contract. Check the ibgib-libs sync/keystone module for the current
+ * implementation status before using.
+ */
+export interface IbGibIdentityContext {
+    /** Whether identity resolution has completed (does not imply authenticated). */
+    resolved: boolean;
+    /** Whether the current session has a verified identity. */
+    authenticated: boolean;
+    /**
+     * App-specific identity payload.
+     * For ibgib: typically `{ keystoneAddr, userIbGibAddr }`.
+     */
+    data?: Record<string, any>;
+}
+/**
+ * Layer 1: Fields shared across ALL ibgib web apps.
+ *
+ * Extends IbGibGlobalThisInfo from @ibgib/web-gib (the root ibgib slot).
+ * Intended to be upstreamed into @ibgib/web-gib.
+ */
+export interface IbGibGlobalThis_Common extends IbGibGlobalThisInfo {
+    /**
+     * Set to true when bootstrap has been triggered.
+     * There is no "bootstrapComplete" — await {@link bootstrapPromise} instead.
+     */
+    bootstrapStarted?: boolean;
+    /**
+     * The promise returned by the bootstrap function. Components await this
+     * to defer initialization until the App witness and metaspace are ready.
+     */
+    bootstrapPromise?: Promise<void>;
+    /**
+     * Singleton chronologys component. Should not be destroyed for the
+     * duration of the page session.
+     */
+    chronologysComponent?: any;
+}
+/**
+ * Layer 2: Fields shared by any app that follows the ibgib App witness pattern.
+ *
+ * Apps using the bootstrap factory pattern extend this interface and add only
+ * their app-specific fields.
+ *
+ * ## notes
+ *
+ * Intended to be upstreamed into @ibgib/web-gib as IbGibGlobalThis_IbGibApp.
+ */
+export interface IbGibGlobalThis_IbGibApp extends IbGibGlobalThis_Common {
+    /** Semver string generated at build time. */
+    version?: string;
+    /** Per-space RCLI pathing shim. */
+    spaceShim: {
+        [spaceId: string]: SpaceShimGlobalInfo;
+    };
+    /** When true, verbose output is enabled for the session. */
+    verbose?: boolean;
+    /**
+     * Looks up the AI API key from IndexedDB storage.
+     * Stored as a function so the key is never cached in memory at the global level.
+     */
+    fnDefaultGetAPIKey: () => Promise<string>;
+    /** The initial "command" comment ibgib created at bootstrap time. */
+    initialCommentIbGib?: IbGib_V1;
+    /** Live proxy wrapping {@link initialCommentIbGib} for reactive subscriptions. */
+    initialCommentIbGibProxy?: LiveProxyIbGib;
+    /**
+     * Optional identity context. Populated by the consumer's resolveIdentity()
+     * callback in the bootstrap options.
+     *
+     * - `undefined`: no identity mechanism configured
+     * - `null`: identity resolution was attempted; user is unauthenticated
+     * - `IbGibIdentityContext`: identity resolved (check `.authenticated`)
+     *
+     * @see {@link IbGibIdentityContext}
+     */
+    identity?: IbGibIdentityContext | null;
+}
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/app-bootstrap/types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACtC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACf;AAMD,0CAA0C;AAC1C,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IACzD,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kCAAkC;IAClC,mBAAmB,EAAE,WAAW,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc;CAAI;AAEnE;;;;GAIG;AACH,MAAM,WAAW,sBACb,SAAQ,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;IAChE,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,oBAAoB;IACjC,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IAC/D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,GAAG,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACpE,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAA;KAAE,CAAC;IACtD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,QAAQ,CAAC;IAC/B,kFAAkF;IAClF,wBAAwB,CAAC,EAAE,cAAc,CAAC;IAC1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC1C"}

package/dist/app-bootstrap/types.mjs

@@ -0,0 +1,15 @@
+/**
+ * @module types
+ *
+ * Shared type definitions for ibgib-based frontend apps.
+ *
+ * ## notes
+ *
+ * Three layers of globalThis state:
+ *   IbGibGlobalThisInfo          (@ibgib/web-gib — the root ibgib slot)
+ *       └── IbGibGlobalThis_Common     (bootstrap promise tracking)
+ *               └── IbGibGlobalThis_IbGibApp  (all ibgib App witness apps)
+ *                       └── IbGibGlobalThis_[AppName]   (per-app extensions)
+ */
+export {};
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/app-bootstrap/types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "Framework for creating agentic ibGib web apps. Contains plumbing for ibgib components, agentic framework (currently only Gemini implemented), web-based IndexedDB storage substrate, and more.",
   "funding": {
     "type": "individual",

package/src/AUTO-GENERATED-version.mts

@@ -11,4 +11,4 @@
 /**
  * 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.29';