@ibgib/web-gib 0.0.42 → 0.0.43

package/src/ui/ui-helpers.mts

@@ -2,8 +2,9 @@ import { delay, extractErrorMsg, } from "@ibgib/helper-gib/dist/helpers/utils-he
 
 import { GLOBAL_LOG_A_LOT } from "../constants.mjs";
 import { UIThemeInfo } from "./ui-types.mjs";
-import { storageGet } from "../storage/storage-helpers.web.mjs";
+import { storageGet, storagePut } from "../storage/storage-helpers.web.mjs";
 import { UI_THEME_INFO_KEY } from "./ui-constants.mjs";
+import type { getGlobalDbName, getGlobalStoreName } from "../helpers.web.mjs";
 
 const logalot = GLOBAL_LOG_A_LOT;
 
@@ -182,6 +183,18 @@ export async function showFullscreenDialog(opts: {
     }
 }
 
+/**
+ * Gets {@link UIThemeInfo} if it exists in the db ({@link dbName}) and store
+ * ({@link storeName}) at the given {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link putUIInfoInStore}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
 export async function getExistingUIInfo({
     dbName,
     storeName,
@@ -220,3 +233,46 @@ export async function getExistingUIInfo({
         if (logalot) { console.log(`${lc} complete.`); }
     }
 }
+
+/**
+ * Complementing {@link getExistingUIInfo}, this puts {@link newUIInfo} in the
+ * db ({@link dbName}) and into the store ({@link storeName}) at the given
+ * {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link getExistingUIInfo}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
+export async function putUIInfoInStore({
+    dbName,
+    storeName,
+    key = UI_THEME_INFO_KEY,
+    newUIInfo,
+}: {
+    dbName: string,
+    storeName: string,
+    key?: string,
+    newUIInfo: UIThemeInfo,
+}): Promise<void> {
+    const lc = `[${putUIInfoInStore.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: 79c9ee707e426fd8c861c4ff4cf16826)`); }
+
+        await storagePut({
+            dbName,
+            storeName,
+            key,
+            value: JSON.stringify(newUIInfo),
+        });
+
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+};

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-core/templates/constants.mts.template

@@ -1,7 +1,7 @@
 import { tagTextToIb } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
 import { ZERO_SPACE_ID } from "@ibgib/core-gib/dist/witness/space/space-constants.mjs";
 
-import { IbGibAmbientContextConfig } from "./types.mjs";
+import { IbGibAmbientContextConfig } from "@ibgib/web-gib/dist/app-bootstrap/types.mjs";
 
 // ---------------------------------------------------------------------------
 // Logging / debug

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-core/templates/helpers.web.mts.template

@@ -18,11 +18,11 @@ import { delay } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
 
 import { GLOBAL_LOG_A_LOT } from "./constants.mjs";
 import { AUTO_GENERATED_VERSION } from "./AUTO-GENERATED-version.mjs";
-import {
+import { IbGibGlobalThis_{{APP_CLASSNAME_PREFIX}} } from "./types.mjs";
+import { 
     IbGibAmbientContextConfig,
-    IbGibGlobalThis_{{APP_CLASSNAME_PREFIX}},
     IbGibGlobalThis_Common,
-} from "./types.mjs";
+} from "@ibgib/web-gib/dist/app-bootstrap/types.mjs";
 
 const logalot = GLOBAL_LOG_A_LOT;
 

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-core/templates/index.mts.template

@@ -20,7 +20,7 @@ const logalot = GLOBAL_LOG_A_LOT;
  * Sequence:
  *   1. Init IndexedDB storage
  *   2. (Optional) trigger shell / router
- *   3. Dynamically import bootstrap.mts — the heavy ibgib graph loads here
+ *   3. Dynamically import bootstrap.mjs — the heavy ibgib graph loads here
  */
 async function spinOffStartup(): Promise<void> {
     const lc = `[${spinOffStartup.name}]`;

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-core/templates/types.mts.template

@@ -1,118 +1,4 @@
-import { CommentData_V1 } from "@ibgib/core-gib/dist/common/comment/comment-types.mjs";
-import { MetaspaceService } from "@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs";
-import { RCLIArgInfo } from "@ibgib/helper-gib/dist/rcli/rcli-types.mjs";
-import { IbGibRel8ns_V1, IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
-import { LiveProxyIbGib } from "@ibgib/web-gib/dist/witness/live-proxy-ibgib/live-proxy-ibgib-one-file.mjs";
-import { IbGibGlobalThisInfo } from "@ibgib/web-gib/dist/types.mjs";
-
-// ---------------------------------------------------------------------------
-// App-level ambient context config
-// ---------------------------------------------------------------------------
-
-/**
- * Configuration for the application's global state and storage substrates.
- */
-export interface IbGibAmbientContextConfig {
-    /** Target IndexedDB database name */
-    dbName: string;
-    /** Primary object store name */
-    storeName: string;
-    /** Additional stores that need to be initialized (e.g., zero space ID) */
-    additionalStoreNames?: string[];
-    /** The IndexedDB key under which the AI API key is persisted */
-    apiKeyName: string;
-}
-
-// ---------------------------------------------------------------------------
-// Bootstrap request comment (RCLI plumbing)
-// ---------------------------------------------------------------------------
-
-export interface RequestCommentData_V1 extends CommentData_V1 {
-    args: string[];
-    interpretedArgInfos: RCLIArgInfo[];
-}
-
-export interface RequestCommentRel8ns_V1 extends IbGibRel8ns_V1 {}
-
-/**
- * Special Comment that acts as a "request" — the command analog from RCLI.
- */
-export interface RequestCommentIbGib_V1
-    extends IbGib_V1<RequestCommentData_V1, RequestCommentRel8ns_V1> {
-    oneOff: boolean;
-}
-
-// ---------------------------------------------------------------------------
-// Space shim (RCLI pathing compat)
-// ---------------------------------------------------------------------------
-
-export interface SpaceShimGlobalInfo {
-    initialCwd: string;
-    cwd: string;
-}
-
-// ---------------------------------------------------------------------------
-// Identity (optional — only populate if the app uses identity)
-// ---------------------------------------------------------------------------
-
-/**
- * Framework-level identity interface.
- *
- * ## notes
- *
- * The implementation is entirely consumer-supplied. The framework only defines
- * the shape of the slot so that shells and components can react to auth state
- * without being coupled to a specific identity mechanism.
- *
- * For ibgib apps, the typical implementation will be keystone-based (a
- * Merkle DAG proof of identity), not token-based.
- */
-export interface IbGibIdentityContext {
-    /** Whether identity resolution has completed (does not imply authenticated). */
-    resolved: boolean;
-    /** Whether the user has a verified identity in this session. */
-    authenticated: boolean;
-    /**
-     * App-specific identity payload.
-     * For ibgib: typically includes keystoneAddr, userIbGibAddr, etc.
-     */
-    data?: Record<string, any>;
-}
-
-// ---------------------------------------------------------------------------
-// GlobalThis state
-// ---------------------------------------------------------------------------
-
-/**
- * Base layer: fields shared across ALL ibgib web apps.
- *
- * NOTE: This is a superset of IbGibGlobalThisInfo from @ibgib/web-gib.
- * Intended to be upstreamed eventually.
- */
-export interface IbGibGlobalThis_Common extends IbGibGlobalThisInfo {
-    bootstrapStarted?: boolean;
-    bootstrapPromise?: Promise<void>;
-    chronologysComponent?: any;
-}
-
-/**
- * Mid-layer: fields shared by any app that uses the ibgib App witness pattern.
- *
- * NOTE: Intended to be upstreamed into @ibgib/web-gib as IbGibGlobalThis_IbGibApp.
- */
-export interface IbGibGlobalThis_IbGibApp extends IbGibGlobalThis_Common {
-    version?: string;
-    spaceShim: { [spaceId: string]: SpaceShimGlobalInfo };
-    verbose?: boolean;
-    fnDefaultGetAPIKey: () => Promise<string>;
-    initialCommentIbGib?: IbGib_V1;
-    initialCommentIbGibProxy?: LiveProxyIbGib;
-    /**
-     * Optional. Populated by the consumer's resolveIdentity() callback.
-     * Undefined = identity not configured. Null = unresolved/unauthenticated.
-     */
-    identity?: IbGibIdentityContext | null;
-}
+import { IbGibGlobalThis_IbGibApp } from "@ibgib/web-gib/dist/app-bootstrap/types.mjs";
 
 // ---------------------------------------------------------------------------
 // App-specific globalThis — add only what this app uniquely needs below

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-witness/templates/witness/app/app-v1.mts.template

@@ -17,7 +17,7 @@ import {
     isRequestComment,
 } from './{{APP_DIR_NAME}}-helper.mjs';
 import { PARAM_INFO_INTERACTIVE, {{APP_CLASSNAME_PREFIX}}Command } from './{{APP_DIR_NAME}}-constants.mjs';
-import { RequestCommentData_V1, RequestCommentIbGib_V1 } from '../../../types.mjs';
+import { RequestCommentData_V1, RequestCommentIbGib_V1 } from "@ibgib/web-gib/dist/app-bootstrap/types.mjs";
 
 const logalot = GLOBAL_LOG_A_LOT;
 

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-witness/templates/witness/app/helper.mts.template

@@ -7,7 +7,7 @@ import { TransformResult } from '@ibgib/ts-gib/dist/types.mjs';
 import { isComment } from '@ibgib/core-gib/dist/common/comment/comment-helper.mjs';
 import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
 
-import { RequestCommentData_V1, RequestCommentIbGib_V1 } from '../../../types.mjs';
+import { RequestCommentData_V1, RequestCommentIbGib_V1 } from "@ibgib/web-gib/dist/app-bootstrap/types.mjs";
 
 /**
  * Validates that no duplicate parameter identifiers exist in the config.