@net-protocol/profiles 0.1.3 → 0.1.5

package/README.md

@@ -104,6 +104,7 @@ function UpdateProfile() {
 | X Username | Your X (Twitter) handle | Stored without @ prefix (e.g., `myusername`) |
 | Bio | Short profile bio | Max 280 characters |
 | Display Name | User-chosen display name | Max 25 characters |
+| Token Address | ERC-20 token that represents you | Valid EVM address (0x-prefixed) |
 | Canvas | Custom HTML profile page | For advanced customization |
 
 ## Storage Keys
@@ -111,7 +112,8 @@ function UpdateProfile() {
 | Key | Description | Data Format |
 |-----|-------------|-------------|
 | `PROFILE_PICTURE_STORAGE_KEY` | Profile picture URL | Plain string (URL) |
-| `PROFILE_METADATA_STORAGE_KEY` | Profile metadata JSON | `{ x_username: "handle", bio: "...", display_name: "..." }` |
+| `PROFILE_X_USERNAME_STORAGE_KEY` | X username (legacy, prefer metadata) | Plain string |
+| `PROFILE_METADATA_STORAGE_KEY` | Profile metadata JSON | `{ x_username: "handle", bio: "...", display_name: "...", token_address: "0x..." }` |
 | `PROFILE_CANVAS_STORAGE_KEY` | Custom HTML canvas | HTML string |
 
 ## API Reference
@@ -121,7 +123,7 @@ function UpdateProfile() {
 - `useProfilePicture({ chainId, userAddress })` - Fetch profile picture URL
 - `useProfileXUsername({ chainId, userAddress })` - Fetch X username
 - `useProfileCanvas({ chainId, userAddress })` - Fetch canvas HTML
-- `useBasicUserProfileMetadata({ chainId, userAddress })` - Batch fetch picture & username
+- `useBasicUserProfileMetadata({ chainId, userAddress })` - Batch fetch picture, username, bio, display name, and token address
 
 ### Utilities (from `@net-protocol/profiles`)
 
@@ -136,6 +138,8 @@ function UpdateProfile() {
 - `isValidXUsername(username)` - Validate X username format
 - `isValidBio(bio)` - Validate bio format (max 280 chars, no control chars)
 - `isValidDisplayName(displayName)` - Validate display name format (max 25 chars, no control chars)
+- `getTokenAddressStorageArgs(tokenAddress)` - Prepare token address update args
+- `isValidTokenAddress(address)` - Validate EVM token address format
 
 ## Dependencies
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as ProfileStorageArgs, a as ProfileMetadata } from './types-DnEzx4eb.mjs';
-export { B as BasicUserProfileMetadata, b as UseProfileOptions, U as UserDisplayName, c as UserProfile } from './types-DnEzx4eb.mjs';
+import { P as ProfileStorageArgs, a as ProfileMetadata } from './types-DDKLfc0r.mjs';
+export { B as BasicUserProfileMetadata, b as UseProfileOptions, U as UserDisplayName, c as UserProfile } from './types-DDKLfc0r.mjs';
 export { STORAGE_CONTRACT } from '@net-protocol/storage';
 
 /**
@@ -22,6 +22,8 @@ declare const PROFILE_METADATA_STORAGE_KEY = "net-beta0.0.1-profile-metadata";
 declare const PROFILE_PICTURE_TOPIC = "profile-picture";
 declare const PROFILE_METADATA_TOPIC = "profile-metadata";
 declare const PROFILE_CANVAS_TOPIC = "profile-canvas";
+declare const PROFILE_CSS_STORAGE_KEY = "net-beta0.0.1-profile-css";
+declare const PROFILE_CSS_TOPIC = "profile-css";
 
 /**
  * Convert a string value to hex for storage
@@ -141,5 +143,93 @@ declare function getBioStorageArgs(bio: string): ProfileStorageArgs;
  * @returns Arguments for Storage.put()
  */
 declare function getDisplayNameStorageArgs(displayName: string): ProfileStorageArgs;
+/**
+ * Prepare transaction arguments for updating token address
+ * This is a convenience wrapper around getProfileMetadataStorageArgs
+ *
+ * @param tokenAddress - The ERC-20 token contract address (stored as lowercase)
+ * @returns Arguments for Storage.put()
+ */
+declare function getTokenAddressStorageArgs(tokenAddress: string): ProfileStorageArgs;
+/**
+ * Validate that a string is a valid EVM token address
+ * Returns true if valid (0x-prefixed, 40 hex characters)
+ */
+declare function isValidTokenAddress(address: string): boolean;
+/**
+ * Maximum CSS size in bytes (10KB — CSS should be small)
+ */
+declare const MAX_CSS_SIZE: number;
+/**
+ * Prepare transaction arguments for updating profile custom CSS
+ *
+ * @param cssContent - CSS string to store
+ * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]
+ *
+ * @example
+ * ```ts
+ * const args = getProfileCSSStorageArgs(".profile-themed { --primary: 210 40% 98%; }");
+ * writeContract({
+ *   abi: STORAGE_CONTRACT.abi,
+ *   address: STORAGE_CONTRACT.address,
+ *   functionName: "put",
+ *   args: [args.bytesKey, args.topic, args.bytesValue],
+ * });
+ * ```
+ */
+declare function getProfileCSSStorageArgs(cssContent: string): ProfileStorageArgs;
+/**
+ * Validate CSS content
+ * Returns true if valid (non-empty, within size limit, no script injection)
+ */
+declare function isValidCSS(css: string): boolean;
+
+/**
+ * Single source of truth for profile CSS theming.
+ *
+ * This file defines:
+ * 1. THEME_SELECTORS — the stable set of CSS selectors/variables available for theming
+ * 2. DEMO_THEMES — example CSS themes users can apply
+ * 3. buildCSSPrompt() — generates an AI prompt describing what can be themed
+ *
+ * When the profile page structure changes, update THEME_SELECTORS here and
+ * everything downstream (AI prompt, docs, validation) stays in sync.
+ */
+/**
+ * A themeable selector or CSS variable group
+ */
+interface ThemeSelector {
+    /** CSS selector or variable name */
+    selector: string;
+    /** Human-readable description of what it targets */
+    description: string;
+    /** Category for grouping in documentation */
+    category: "variable" | "layout" | "component";
+}
+/**
+ * All themeable selectors available for profile CSS.
+ *
+ * CSS variables (category: "variable") are the most stable —
+ * they survive page restructuring because they're part of the
+ * shadcn/Tailwind design system.
+ *
+ * Layout and component selectors may break when the page structure changes.
+ */
+declare const THEME_SELECTORS: ThemeSelector[];
+/**
+ * Demo themes that users can choose from as starting points.
+ * Each is a complete CSS string ready to store on-chain.
+ */
+declare const DEMO_THEMES: Record<string, {
+    name: string;
+    css: string;
+}>;
+/**
+ * Build an AI prompt that describes the available theming surface.
+ * Feed this to an LLM alongside a user's description to generate CSS.
+ *
+ * @returns A prompt string listing all available selectors and usage rules
+ */
+declare function buildCSSPrompt(): string;
 
-export { PROFILE_CANVAS_STORAGE_KEY, PROFILE_CANVAS_TOPIC, PROFILE_METADATA_STORAGE_KEY, PROFILE_METADATA_TOPIC, PROFILE_PICTURE_STORAGE_KEY, PROFILE_PICTURE_TOPIC, PROFILE_X_USERNAME_STORAGE_KEY, ProfileMetadata, ProfileStorageArgs, getBioStorageArgs, getBytesArgsForStorage, getDisplayNameStorageArgs, getProfileCanvasStorageArgs, getProfileMetadataStorageArgs, getProfilePictureStorageArgs, getValueArgForStorage, getXUsernameStorageArgs, isValidBio, isValidDisplayName, isValidUrl, isValidXUsername, parseProfileMetadata };
+export { DEMO_THEMES, MAX_CSS_SIZE, PROFILE_CANVAS_STORAGE_KEY, PROFILE_CANVAS_TOPIC, PROFILE_CSS_STORAGE_KEY, PROFILE_CSS_TOPIC, PROFILE_METADATA_STORAGE_KEY, PROFILE_METADATA_TOPIC, PROFILE_PICTURE_STORAGE_KEY, PROFILE_PICTURE_TOPIC, PROFILE_X_USERNAME_STORAGE_KEY, ProfileMetadata, ProfileStorageArgs, THEME_SELECTORS, type ThemeSelector, buildCSSPrompt, getBioStorageArgs, getBytesArgsForStorage, getDisplayNameStorageArgs, getProfileCSSStorageArgs, getProfileCanvasStorageArgs, getProfileMetadataStorageArgs, getProfilePictureStorageArgs, getTokenAddressStorageArgs, getValueArgForStorage, getXUsernameStorageArgs, isValidBio, isValidCSS, isValidDisplayName, isValidTokenAddress, isValidUrl, isValidXUsername, parseProfileMetadata };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProfileStorageArgs, a as ProfileMetadata } from './types-DnEzx4eb.js';
-export { B as BasicUserProfileMetadata, b as UseProfileOptions, U as UserDisplayName, c as UserProfile } from './types-DnEzx4eb.js';
+import { P as ProfileStorageArgs, a as ProfileMetadata } from './types-DDKLfc0r.js';
+export { B as BasicUserProfileMetadata, b as UseProfileOptions, U as UserDisplayName, c as UserProfile } from './types-DDKLfc0r.js';
 export { STORAGE_CONTRACT } from '@net-protocol/storage';
 
 /**
@@ -22,6 +22,8 @@ declare const PROFILE_METADATA_STORAGE_KEY = "net-beta0.0.1-profile-metadata";
 declare const PROFILE_PICTURE_TOPIC = "profile-picture";
 declare const PROFILE_METADATA_TOPIC = "profile-metadata";
 declare const PROFILE_CANVAS_TOPIC = "profile-canvas";
+declare const PROFILE_CSS_STORAGE_KEY = "net-beta0.0.1-profile-css";
+declare const PROFILE_CSS_TOPIC = "profile-css";
 
 /**
  * Convert a string value to hex for storage
@@ -141,5 +143,93 @@ declare function getBioStorageArgs(bio: string): ProfileStorageArgs;
  * @returns Arguments for Storage.put()
  */
 declare function getDisplayNameStorageArgs(displayName: string): ProfileStorageArgs;
+/**
+ * Prepare transaction arguments for updating token address
+ * This is a convenience wrapper around getProfileMetadataStorageArgs
+ *
+ * @param tokenAddress - The ERC-20 token contract address (stored as lowercase)
+ * @returns Arguments for Storage.put()
+ */
+declare function getTokenAddressStorageArgs(tokenAddress: string): ProfileStorageArgs;
+/**
+ * Validate that a string is a valid EVM token address
+ * Returns true if valid (0x-prefixed, 40 hex characters)
+ */
+declare function isValidTokenAddress(address: string): boolean;
+/**
+ * Maximum CSS size in bytes (10KB — CSS should be small)
+ */
+declare const MAX_CSS_SIZE: number;
+/**
+ * Prepare transaction arguments for updating profile custom CSS
+ *
+ * @param cssContent - CSS string to store
+ * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]
+ *
+ * @example
+ * ```ts
+ * const args = getProfileCSSStorageArgs(".profile-themed { --primary: 210 40% 98%; }");
+ * writeContract({
+ *   abi: STORAGE_CONTRACT.abi,
+ *   address: STORAGE_CONTRACT.address,
+ *   functionName: "put",
+ *   args: [args.bytesKey, args.topic, args.bytesValue],
+ * });
+ * ```
+ */
+declare function getProfileCSSStorageArgs(cssContent: string): ProfileStorageArgs;
+/**
+ * Validate CSS content
+ * Returns true if valid (non-empty, within size limit, no script injection)
+ */
+declare function isValidCSS(css: string): boolean;
+
+/**
+ * Single source of truth for profile CSS theming.
+ *
+ * This file defines:
+ * 1. THEME_SELECTORS — the stable set of CSS selectors/variables available for theming
+ * 2. DEMO_THEMES — example CSS themes users can apply
+ * 3. buildCSSPrompt() — generates an AI prompt describing what can be themed
+ *
+ * When the profile page structure changes, update THEME_SELECTORS here and
+ * everything downstream (AI prompt, docs, validation) stays in sync.
+ */
+/**
+ * A themeable selector or CSS variable group
+ */
+interface ThemeSelector {
+    /** CSS selector or variable name */
+    selector: string;
+    /** Human-readable description of what it targets */
+    description: string;
+    /** Category for grouping in documentation */
+    category: "variable" | "layout" | "component";
+}
+/**
+ * All themeable selectors available for profile CSS.
+ *
+ * CSS variables (category: "variable") are the most stable —
+ * they survive page restructuring because they're part of the
+ * shadcn/Tailwind design system.
+ *
+ * Layout and component selectors may break when the page structure changes.
+ */
+declare const THEME_SELECTORS: ThemeSelector[];
+/**
+ * Demo themes that users can choose from as starting points.
+ * Each is a complete CSS string ready to store on-chain.
+ */
+declare const DEMO_THEMES: Record<string, {
+    name: string;
+    css: string;
+}>;
+/**
+ * Build an AI prompt that describes the available theming surface.
+ * Feed this to an LLM alongside a user's description to generate CSS.
+ *
+ * @returns A prompt string listing all available selectors and usage rules
+ */
+declare function buildCSSPrompt(): string;
 
-export { PROFILE_CANVAS_STORAGE_KEY, PROFILE_CANVAS_TOPIC, PROFILE_METADATA_STORAGE_KEY, PROFILE_METADATA_TOPIC, PROFILE_PICTURE_STORAGE_KEY, PROFILE_PICTURE_TOPIC, PROFILE_X_USERNAME_STORAGE_KEY, ProfileMetadata, ProfileStorageArgs, getBioStorageArgs, getBytesArgsForStorage, getDisplayNameStorageArgs, getProfileCanvasStorageArgs, getProfileMetadataStorageArgs, getProfilePictureStorageArgs, getValueArgForStorage, getXUsernameStorageArgs, isValidBio, isValidDisplayName, isValidUrl, isValidXUsername, parseProfileMetadata };
+export { DEMO_THEMES, MAX_CSS_SIZE, PROFILE_CANVAS_STORAGE_KEY, PROFILE_CANVAS_TOPIC, PROFILE_CSS_STORAGE_KEY, PROFILE_CSS_TOPIC, PROFILE_METADATA_STORAGE_KEY, PROFILE_METADATA_TOPIC, PROFILE_PICTURE_STORAGE_KEY, PROFILE_PICTURE_TOPIC, PROFILE_X_USERNAME_STORAGE_KEY, ProfileMetadata, ProfileStorageArgs, THEME_SELECTORS, type ThemeSelector, buildCSSPrompt, getBioStorageArgs, getBytesArgsForStorage, getDisplayNameStorageArgs, getProfileCSSStorageArgs, getProfileCanvasStorageArgs, getProfileMetadataStorageArgs, getProfilePictureStorageArgs, getTokenAddressStorageArgs, getValueArgForStorage, getXUsernameStorageArgs, isValidBio, isValidCSS, isValidDisplayName, isValidTokenAddress, isValidUrl, isValidXUsername, parseProfileMetadata };

package/dist/index.js

@@ -12,6 +12,8 @@ var PROFILE_METADATA_STORAGE_KEY = "net-beta0.0.1-profile-metadata";
 var PROFILE_PICTURE_TOPIC = "profile-picture";
 var PROFILE_METADATA_TOPIC = "profile-metadata";
 var PROFILE_CANVAS_TOPIC = "profile-canvas";
+var PROFILE_CSS_STORAGE_KEY = "net-beta0.0.1-profile-css";
+var PROFILE_CSS_TOPIC = "profile-css";
 function getValueArgForStorage(value) {
   return viem.stringToHex(value);
 }
@@ -65,10 +67,12 @@ function parseProfileMetadata(jsonData) {
     const usernameWithoutAt = storedUsername?.startsWith("@") ? storedUsername.slice(1) : storedUsername;
     const bio = parsed?.bio && typeof parsed.bio === "string" && parsed.bio.length > 0 ? parsed.bio : void 0;
     const display_name = parsed?.display_name && typeof parsed.display_name === "string" && parsed.display_name.length > 0 ? parsed.display_name : void 0;
+    const token_address = parsed?.token_address && typeof parsed.token_address === "string" && parsed.token_address.length > 0 ? parsed.token_address.toLowerCase() : void 0;
     return {
       x_username: usernameWithoutAt,
       bio,
-      display_name
+      display_name,
+      token_address
     };
   } catch {
     return void 0;
@@ -106,28 +110,261 @@ function getBioStorageArgs(bio) {
 function getDisplayNameStorageArgs(displayName) {
   return getProfileMetadataStorageArgs({ display_name: displayName });
 }
+function getTokenAddressStorageArgs(tokenAddress) {
+  return getProfileMetadataStorageArgs({
+    token_address: tokenAddress.toLowerCase()
+  });
+}
+function isValidTokenAddress(address) {
+  if (!address) return false;
+  return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+var MAX_CSS_SIZE = 10 * 1024;
+function getProfileCSSStorageArgs(cssContent) {
+  const { bytesKey, bytesValue } = getBytesArgsForStorage(
+    PROFILE_CSS_STORAGE_KEY,
+    cssContent
+  );
+  return {
+    bytesKey,
+    topic: PROFILE_CSS_TOPIC,
+    bytesValue
+  };
+}
+function isValidCSS(css) {
+  if (!css || css.trim().length === 0) return false;
+  if (Buffer.byteLength(css, "utf-8") > MAX_CSS_SIZE) return false;
+  const lowerCSS = css.toLowerCase();
+  if (lowerCSS.includes("expression(")) return false;
+  if (lowerCSS.includes("behavior:")) return false;
+  if (lowerCSS.includes("javascript:")) return false;
+  if (/<script/i.test(css)) return false;
+  return true;
+}
+
+// src/theme-selectors.ts
+var THEME_SELECTORS = [
+  // --- CSS Variables (stable) ---
+  {
+    selector: "--background",
+    description: "Page background color (HSL values, e.g. '210 40% 2%')",
+    category: "variable"
+  },
+  {
+    selector: "--foreground",
+    description: "Default text color",
+    category: "variable"
+  },
+  {
+    selector: "--primary",
+    description: "Primary accent color (buttons, links, headings)",
+    category: "variable"
+  },
+  {
+    selector: "--primary-foreground",
+    description: "Text on primary-colored elements",
+    category: "variable"
+  },
+  {
+    selector: "--secondary",
+    description: "Secondary accent color",
+    category: "variable"
+  },
+  {
+    selector: "--secondary-foreground",
+    description: "Text on secondary-colored elements",
+    category: "variable"
+  },
+  {
+    selector: "--muted",
+    description: "Muted/subdued background",
+    category: "variable"
+  },
+  {
+    selector: "--muted-foreground",
+    description: "Text on muted backgrounds",
+    category: "variable"
+  },
+  {
+    selector: "--accent",
+    description: "Accent color for highlights",
+    category: "variable"
+  },
+  {
+    selector: "--accent-foreground",
+    description: "Text on accent-colored elements",
+    category: "variable"
+  },
+  {
+    selector: "--card",
+    description: "Card/panel background color",
+    category: "variable"
+  },
+  {
+    selector: "--card-foreground",
+    description: "Text inside cards",
+    category: "variable"
+  },
+  {
+    selector: "--border",
+    description: "Border color",
+    category: "variable"
+  },
+  {
+    selector: "--ring",
+    description: "Focus ring color",
+    category: "variable"
+  },
+  {
+    selector: "--radius",
+    description: "Border radius (e.g. '0.5rem')",
+    category: "variable"
+  },
+  // --- Layout selectors (may change with page restructuring) ---
+  {
+    selector: ".profile-themed",
+    description: "Root wrapper for all themed profile content",
+    category: "layout"
+  },
+  // --- Component selectors (may change with page restructuring) ---
+  {
+    selector: ".profile-themed .profile-header",
+    description: "Profile header area (name, picture, bio)",
+    category: "component"
+  },
+  {
+    selector: ".profile-themed .profile-tabs",
+    description: "Tab navigation bar",
+    category: "component"
+  },
+  {
+    selector: ".profile-themed .profile-content",
+    description: "Main content area below tabs",
+    category: "component"
+  }
+];
+var DEMO_THEMES = {
+  hotPink: {
+    name: "Hot Pink Scene",
+    css: `.profile-themed {
+  --background: 320 80% 4%;
+  --foreground: 320 20% 95%;
+  --primary: 330 100% 60%;
+  --primary-foreground: 0 0% 100%;
+  --secondary: 280 60% 20%;
+  --secondary-foreground: 320 20% 95%;
+  --muted: 320 40% 12%;
+  --muted-foreground: 320 20% 70%;
+  --accent: 330 100% 60%;
+  --accent-foreground: 0 0% 100%;
+  --card: 320 60% 6%;
+  --card-foreground: 320 20% 95%;
+  --border: 330 60% 25%;
+  --ring: 330 100% 60%;
+}`
+  },
+  midnightGrunge: {
+    name: "Midnight Grunge",
+    css: `.profile-themed {
+  --background: 220 30% 3%;
+  --foreground: 220 10% 80%;
+  --primary: 45 90% 55%;
+  --primary-foreground: 220 30% 5%;
+  --secondary: 220 20% 12%;
+  --secondary-foreground: 220 10% 80%;
+  --muted: 220 20% 8%;
+  --muted-foreground: 220 10% 50%;
+  --accent: 45 90% 55%;
+  --accent-foreground: 220 30% 5%;
+  --card: 220 25% 5%;
+  --card-foreground: 220 10% 80%;
+  --border: 220 15% 15%;
+  --ring: 45 90% 55%;
+}`
+  },
+  ocean: {
+    name: "Deep Ocean",
+    css: `.profile-themed {
+  --background: 200 60% 3%;
+  --foreground: 190 20% 90%;
+  --primary: 190 80% 50%;
+  --primary-foreground: 200 60% 5%;
+  --secondary: 210 40% 15%;
+  --secondary-foreground: 190 20% 90%;
+  --muted: 200 40% 8%;
+  --muted-foreground: 190 20% 55%;
+  --accent: 170 70% 45%;
+  --accent-foreground: 200 60% 5%;
+  --card: 200 50% 5%;
+  --card-foreground: 190 20% 90%;
+  --border: 200 30% 18%;
+  --ring: 190 80% 50%;
+}`
+  }
+};
+function buildCSSPrompt() {
+  const variableLines = THEME_SELECTORS.filter(
+    (s) => s.category === "variable"
+  ).map((s) => `  ${s.selector}: ${s.description}`).join("\n");
+  const layoutLines = THEME_SELECTORS.filter((s) => s.category === "layout").map((s) => `  ${s.selector} \u2014 ${s.description}`).join("\n");
+  const componentLines = THEME_SELECTORS.filter(
+    (s) => s.category === "component"
+  ).map((s) => `  ${s.selector} \u2014 ${s.description}`).join("\n");
+  return `You are a CSS theme generator for a user profile page.
+All styles MUST be scoped under the .profile-themed wrapper class.
+
+## CSS Variables (stable \u2014 preferred for theming)
+These use HSL values WITHOUT the hsl() wrapper (e.g. "210 40% 98%"):
+${variableLines}
+
+## Layout Selectors (may change across site updates)
+${layoutLines}
+
+## Component Selectors (may change across site updates)
+${componentLines}
+
+## Rules
+1. All selectors MUST start with .profile-themed
+2. CSS variables go inside .profile-themed { ... } as custom properties
+3. Use only valid CSS \u2014 no JavaScript, no expressions, no imports
+4. Keep the output under 10KB
+5. Prefer CSS variables over direct selector styling for durability
+6. HSL values are bare numbers: "210 40% 98%" not "hsl(210, 40%, 98%)"
+
+Given a user description, output ONLY the CSS (no explanation, no markdown fences).`;
+}
 
 Object.defineProperty(exports, "STORAGE_CONTRACT", {
   enumerable: true,
   get: function () { return storage.STORAGE_CONTRACT; }
 });
+exports.DEMO_THEMES = DEMO_THEMES;
+exports.MAX_CSS_SIZE = MAX_CSS_SIZE;
 exports.PROFILE_CANVAS_STORAGE_KEY = PROFILE_CANVAS_STORAGE_KEY;
 exports.PROFILE_CANVAS_TOPIC = PROFILE_CANVAS_TOPIC;
+exports.PROFILE_CSS_STORAGE_KEY = PROFILE_CSS_STORAGE_KEY;
+exports.PROFILE_CSS_TOPIC = PROFILE_CSS_TOPIC;
 exports.PROFILE_METADATA_STORAGE_KEY = PROFILE_METADATA_STORAGE_KEY;
 exports.PROFILE_METADATA_TOPIC = PROFILE_METADATA_TOPIC;
 exports.PROFILE_PICTURE_STORAGE_KEY = PROFILE_PICTURE_STORAGE_KEY;
 exports.PROFILE_PICTURE_TOPIC = PROFILE_PICTURE_TOPIC;
 exports.PROFILE_X_USERNAME_STORAGE_KEY = PROFILE_X_USERNAME_STORAGE_KEY;
+exports.THEME_SELECTORS = THEME_SELECTORS;
+exports.buildCSSPrompt = buildCSSPrompt;
 exports.getBioStorageArgs = getBioStorageArgs;
 exports.getBytesArgsForStorage = getBytesArgsForStorage;
 exports.getDisplayNameStorageArgs = getDisplayNameStorageArgs;
+exports.getProfileCSSStorageArgs = getProfileCSSStorageArgs;
 exports.getProfileCanvasStorageArgs = getProfileCanvasStorageArgs;
 exports.getProfileMetadataStorageArgs = getProfileMetadataStorageArgs;
 exports.getProfilePictureStorageArgs = getProfilePictureStorageArgs;
+exports.getTokenAddressStorageArgs = getTokenAddressStorageArgs;
 exports.getValueArgForStorage = getValueArgForStorage;
 exports.getXUsernameStorageArgs = getXUsernameStorageArgs;
 exports.isValidBio = isValidBio;
+exports.isValidCSS = isValidCSS;
 exports.isValidDisplayName = isValidDisplayName;
+exports.isValidTokenAddress = isValidTokenAddress;
 exports.isValidUrl = isValidUrl;
 exports.isValidXUsername = isValidXUsername;
 exports.parseProfileMetadata = parseProfileMetadata;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/utils.ts"],"names":["stringToHex","toBytes32"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Profile-related storage keys\n *\n * Using descriptive keys under 32 bytes to avoid hashing complexity and work seamlessly\n * with existing storage infrastructure. The key includes app prefix and versioning for\n * clarity and future-proofing.\n *\n * NOTE: if we change these keys, users will not be able to see their profile data\n */\nexport const PROFILE_CANVAS_STORAGE_KEY = \"net-beta0.0.1-profile-canvas\";\nexport const PROFILE_PICTURE_STORAGE_KEY = \"net-beta0.0.1-profile-picture\";\nexport const PROFILE_X_USERNAME_STORAGE_KEY =\n  \"net-beta0.0.1-profile-x-username\";\nexport const PROFILE_METADATA_STORAGE_KEY = \"net-beta0.0.1-profile-metadata\";\n\n/**\n * Topic strings used when writing to storage\n * These are the second argument to Storage.put()\n */\nexport const PROFILE_PICTURE_TOPIC = \"profile-picture\";\nexport const PROFILE_METADATA_TOPIC = \"profile-metadata\";\nexport const PROFILE_CANVAS_TOPIC = \"profile-canvas\";\n","import { stringToHex } from \"viem\";\nimport { toBytes32 } from \"@net-protocol/core\";\nimport {\n  PROFILE_PICTURE_STORAGE_KEY,\n  PROFILE_METADATA_STORAGE_KEY,\n  PROFILE_CANVAS_STORAGE_KEY,\n  PROFILE_PICTURE_TOPIC,\n  PROFILE_METADATA_TOPIC,\n  PROFILE_CANVAS_TOPIC,\n} from \"./constants\";\nimport type { ProfileMetadata, ProfileStorageArgs } from \"./types\";\n\n/**\n * Convert a string value to hex for storage\n */\nexport function getValueArgForStorage(value: string): `0x${string}` {\n  return stringToHex(value);\n}\n\n/**\n * Get storage args (key as bytes32, value as hex)\n */\nexport function getBytesArgsForStorage(\n  key: string,\n  value: string\n): { bytesKey: `0x${string}`; bytesValue: `0x${string}` } {\n  const bytesKey = toBytes32(key) as `0x${string}`;\n  const bytesValue = getValueArgForStorage(value);\n  return { bytesKey, bytesValue };\n}\n\n/**\n * Prepare transaction arguments for updating profile picture\n *\n * @param imageUrl - The URL of the profile picture\n * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]\n *\n * @example\n * ```ts\n * const args = getProfilePictureStorageArgs(\"https://example.com/image.jpg\");\n * // Use with wagmi writeContract:\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfilePictureStorageArgs(\n  imageUrl: string\n): ProfileStorageArgs {\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_PICTURE_STORAGE_KEY,\n    imageUrl\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_PICTURE_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Prepare transaction arguments for updating profile metadata (X username, etc.)\n *\n * @param metadata - Profile metadata object to store\n * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]\n *\n * @example\n * ```ts\n * const args = getProfileMetadataStorageArgs({ x_username: \"myusername\" });\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfileMetadataStorageArgs(\n  metadata: ProfileMetadata\n): ProfileStorageArgs {\n  const jsonString = JSON.stringify(metadata);\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_METADATA_STORAGE_KEY,\n    jsonString\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_METADATA_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Prepare transaction arguments for updating X username\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * Note: Username is stored WITHOUT the @ prefix. The @ is stripped if provided.\n *\n * @param username - X/Twitter username (with or without @)\n * @returns Arguments for Storage.put()\n */\nexport function getXUsernameStorageArgs(username: string): ProfileStorageArgs {\n  // Strip @ prefix if present - store username without @\n  const normalizedUsername = username.startsWith(\"@\")\n    ? username.slice(1)\n    : username;\n  return getProfileMetadataStorageArgs({ x_username: normalizedUsername });\n}\n\n/**\n * Prepare transaction arguments for updating profile canvas (HTML content)\n *\n * @param htmlContent - HTML content for the profile canvas\n * @returns Arguments for Storage.put()\n *\n * @example\n * ```ts\n * const args = getProfileCanvasStorageArgs(\"<div>My custom profile</div>\");\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfileCanvasStorageArgs(\n  htmlContent: string\n): ProfileStorageArgs {\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_CANVAS_STORAGE_KEY,\n    htmlContent\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_CANVAS_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Parse profile metadata JSON and extract profile data\n *\n * @param jsonData - JSON string from storage\n * @returns Parsed profile metadata or undefined if invalid\n */\nexport function parseProfileMetadata(\n  jsonData: string\n): ProfileMetadata | undefined {\n  try {\n    const parsed = JSON.parse(jsonData);\n    const storedUsername =\n      parsed?.x_username &&\n      typeof parsed.x_username === \"string\" &&\n      parsed.x_username.length > 0\n        ? parsed.x_username\n        : undefined;\n\n    // Strip @ if present for backwards compatibility with older stored data\n    const usernameWithoutAt = storedUsername?.startsWith(\"@\")\n      ? storedUsername.slice(1)\n      : storedUsername;\n\n    // Extract bio if present\n    const bio =\n      parsed?.bio && typeof parsed.bio === \"string\" && parsed.bio.length > 0\n        ? parsed.bio\n        : undefined;\n\n    // Extract display name if present\n    const display_name =\n      parsed?.display_name &&\n      typeof parsed.display_name === \"string\" &&\n      parsed.display_name.length > 0\n        ? parsed.display_name\n        : undefined;\n\n    return {\n      x_username: usernameWithoutAt,\n      bio,\n      display_name,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Validate that a string is a valid URL\n */\nexport function isValidUrl(url: string): boolean {\n  if (!url) return false;\n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate X/Twitter username format\n * Returns true if valid (alphanumeric and underscores, 1-15 chars)\n */\nexport function isValidXUsername(username: string): boolean {\n  if (!username) return false;\n  // Remove @ prefix if present\n  const cleanUsername = username.startsWith(\"@\") ? username.slice(1) : username;\n  // X usernames: 1-15 chars, alphanumeric and underscores only\n  return /^[a-zA-Z0-9_]{1,15}$/.test(cleanUsername);\n}\n\n/**\n * Validate bio format\n * Returns true if valid (max 280 chars, no control characters except newlines)\n */\nexport function isValidBio(bio: string): boolean {\n  if (!bio) return false;\n  if (bio.length > 280) return false;\n  // Allow printable characters, spaces, and newlines. Disallow other control chars.\n  // eslint-disable-next-line no-control-regex\n  const hasControlChars = /[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]/.test(bio);\n  return !hasControlChars;\n}\n\n/**\n * Validate display name format\n * Returns true if valid (1-25 characters, no control characters except spaces)\n */\nexport function isValidDisplayName(displayName: string): boolean {\n  if (!displayName) return false;\n  if (displayName.length > 25) return false;\n  // Disallow control characters\n  // eslint-disable-next-line no-control-regex\n  const hasControlChars = /[\\x00-\\x1F\\x7F]/.test(displayName);\n  return !hasControlChars;\n}\n\n/**\n * Prepare transaction arguments for updating bio\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * @param bio - The bio text\n * @returns Arguments for Storage.put()\n */\nexport function getBioStorageArgs(bio: string): ProfileStorageArgs {\n  return getProfileMetadataStorageArgs({ bio });\n}\n\n/**\n * Prepare transaction arguments for updating display name\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * @param displayName - The display name (max 25 characters)\n * @returns Arguments for Storage.put()\n */\nexport function getDisplayNameStorageArgs(\n  displayName: string\n): ProfileStorageArgs {\n  return getProfileMetadataStorageArgs({ display_name: displayName });\n}\n"]}
+{"version":3,"sources":["../src/constants.ts","../src/utils.ts","../src/theme-selectors.ts"],"names":["stringToHex","toBytes32"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Profile-related storage keys\n *\n * Using descriptive keys under 32 bytes to avoid hashing complexity and work seamlessly\n * with existing storage infrastructure. The key includes app prefix and versioning for\n * clarity and future-proofing.\n *\n * NOTE: if we change these keys, users will not be able to see their profile data\n */\nexport const PROFILE_CANVAS_STORAGE_KEY = \"net-beta0.0.1-profile-canvas\";\nexport const PROFILE_PICTURE_STORAGE_KEY = \"net-beta0.0.1-profile-picture\";\nexport const PROFILE_X_USERNAME_STORAGE_KEY =\n  \"net-beta0.0.1-profile-x-username\";\nexport const PROFILE_METADATA_STORAGE_KEY = \"net-beta0.0.1-profile-metadata\";\n\n/**\n * Topic strings used when writing to storage\n * These are the second argument to Storage.put()\n */\nexport const PROFILE_PICTURE_TOPIC = \"profile-picture\";\nexport const PROFILE_METADATA_TOPIC = \"profile-metadata\";\nexport const PROFILE_CANVAS_TOPIC = \"profile-canvas\";\nexport const PROFILE_CSS_STORAGE_KEY = \"net-beta0.0.1-profile-css\";\nexport const PROFILE_CSS_TOPIC = \"profile-css\";\n","import { stringToHex } from \"viem\";\nimport { toBytes32 } from \"@net-protocol/core\";\nimport {\n  PROFILE_PICTURE_STORAGE_KEY,\n  PROFILE_METADATA_STORAGE_KEY,\n  PROFILE_CANVAS_STORAGE_KEY,\n  PROFILE_CSS_STORAGE_KEY,\n  PROFILE_PICTURE_TOPIC,\n  PROFILE_METADATA_TOPIC,\n  PROFILE_CANVAS_TOPIC,\n  PROFILE_CSS_TOPIC,\n} from \"./constants\";\nimport type { ProfileMetadata, ProfileStorageArgs } from \"./types\";\n\n/**\n * Convert a string value to hex for storage\n */\nexport function getValueArgForStorage(value: string): `0x${string}` {\n  return stringToHex(value);\n}\n\n/**\n * Get storage args (key as bytes32, value as hex)\n */\nexport function getBytesArgsForStorage(\n  key: string,\n  value: string\n): { bytesKey: `0x${string}`; bytesValue: `0x${string}` } {\n  const bytesKey = toBytes32(key) as `0x${string}`;\n  const bytesValue = getValueArgForStorage(value);\n  return { bytesKey, bytesValue };\n}\n\n/**\n * Prepare transaction arguments for updating profile picture\n *\n * @param imageUrl - The URL of the profile picture\n * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]\n *\n * @example\n * ```ts\n * const args = getProfilePictureStorageArgs(\"https://example.com/image.jpg\");\n * // Use with wagmi writeContract:\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfilePictureStorageArgs(\n  imageUrl: string\n): ProfileStorageArgs {\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_PICTURE_STORAGE_KEY,\n    imageUrl\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_PICTURE_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Prepare transaction arguments for updating profile metadata (X username, etc.)\n *\n * @param metadata - Profile metadata object to store\n * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]\n *\n * @example\n * ```ts\n * const args = getProfileMetadataStorageArgs({ x_username: \"myusername\" });\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfileMetadataStorageArgs(\n  metadata: ProfileMetadata\n): ProfileStorageArgs {\n  const jsonString = JSON.stringify(metadata);\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_METADATA_STORAGE_KEY,\n    jsonString\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_METADATA_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Prepare transaction arguments for updating X username\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * Note: Username is stored WITHOUT the @ prefix. The @ is stripped if provided.\n *\n * @param username - X/Twitter username (with or without @)\n * @returns Arguments for Storage.put()\n */\nexport function getXUsernameStorageArgs(username: string): ProfileStorageArgs {\n  // Strip @ prefix if present - store username without @\n  const normalizedUsername = username.startsWith(\"@\")\n    ? username.slice(1)\n    : username;\n  return getProfileMetadataStorageArgs({ x_username: normalizedUsername });\n}\n\n/**\n * Prepare transaction arguments for updating profile canvas (HTML content)\n *\n * @param htmlContent - HTML content for the profile canvas\n * @returns Arguments for Storage.put()\n *\n * @example\n * ```ts\n * const args = getProfileCanvasStorageArgs(\"<div>My custom profile</div>\");\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfileCanvasStorageArgs(\n  htmlContent: string\n): ProfileStorageArgs {\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_CANVAS_STORAGE_KEY,\n    htmlContent\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_CANVAS_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Parse profile metadata JSON and extract profile data\n *\n * @param jsonData - JSON string from storage\n * @returns Parsed profile metadata or undefined if invalid\n */\nexport function parseProfileMetadata(\n  jsonData: string\n): ProfileMetadata | undefined {\n  try {\n    const parsed = JSON.parse(jsonData);\n    const storedUsername =\n      parsed?.x_username &&\n      typeof parsed.x_username === \"string\" &&\n      parsed.x_username.length > 0\n        ? parsed.x_username\n        : undefined;\n\n    // Strip @ if present for backwards compatibility with older stored data\n    const usernameWithoutAt = storedUsername?.startsWith(\"@\")\n      ? storedUsername.slice(1)\n      : storedUsername;\n\n    // Extract bio if present\n    const bio =\n      parsed?.bio && typeof parsed.bio === \"string\" && parsed.bio.length > 0\n        ? parsed.bio\n        : undefined;\n\n    // Extract display name if present\n    const display_name =\n      parsed?.display_name &&\n      typeof parsed.display_name === \"string\" &&\n      parsed.display_name.length > 0\n        ? parsed.display_name\n        : undefined;\n\n    // Extract token address if present (stored as lowercase)\n    const token_address =\n      parsed?.token_address &&\n      typeof parsed.token_address === \"string\" &&\n      parsed.token_address.length > 0\n        ? parsed.token_address.toLowerCase()\n        : undefined;\n\n    return {\n      x_username: usernameWithoutAt,\n      bio,\n      display_name,\n      token_address,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Validate that a string is a valid URL\n */\nexport function isValidUrl(url: string): boolean {\n  if (!url) return false;\n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate X/Twitter username format\n * Returns true if valid (alphanumeric and underscores, 1-15 chars)\n */\nexport function isValidXUsername(username: string): boolean {\n  if (!username) return false;\n  // Remove @ prefix if present\n  const cleanUsername = username.startsWith(\"@\") ? username.slice(1) : username;\n  // X usernames: 1-15 chars, alphanumeric and underscores only\n  return /^[a-zA-Z0-9_]{1,15}$/.test(cleanUsername);\n}\n\n/**\n * Validate bio format\n * Returns true if valid (max 280 chars, no control characters except newlines)\n */\nexport function isValidBio(bio: string): boolean {\n  if (!bio) return false;\n  if (bio.length > 280) return false;\n  // Allow printable characters, spaces, and newlines. Disallow other control chars.\n  // eslint-disable-next-line no-control-regex\n  const hasControlChars = /[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]/.test(bio);\n  return !hasControlChars;\n}\n\n/**\n * Validate display name format\n * Returns true if valid (1-25 characters, no control characters except spaces)\n */\nexport function isValidDisplayName(displayName: string): boolean {\n  if (!displayName) return false;\n  if (displayName.length > 25) return false;\n  // Disallow control characters\n  // eslint-disable-next-line no-control-regex\n  const hasControlChars = /[\\x00-\\x1F\\x7F]/.test(displayName);\n  return !hasControlChars;\n}\n\n/**\n * Prepare transaction arguments for updating bio\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * @param bio - The bio text\n * @returns Arguments for Storage.put()\n */\nexport function getBioStorageArgs(bio: string): ProfileStorageArgs {\n  return getProfileMetadataStorageArgs({ bio });\n}\n\n/**\n * Prepare transaction arguments for updating display name\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * @param displayName - The display name (max 25 characters)\n * @returns Arguments for Storage.put()\n */\nexport function getDisplayNameStorageArgs(\n  displayName: string\n): ProfileStorageArgs {\n  return getProfileMetadataStorageArgs({ display_name: displayName });\n}\n\n/**\n * Prepare transaction arguments for updating token address\n * This is a convenience wrapper around getProfileMetadataStorageArgs\n *\n * @param tokenAddress - The ERC-20 token contract address (stored as lowercase)\n * @returns Arguments for Storage.put()\n */\nexport function getTokenAddressStorageArgs(\n  tokenAddress: string\n): ProfileStorageArgs {\n  return getProfileMetadataStorageArgs({\n    token_address: tokenAddress.toLowerCase(),\n  });\n}\n\n/**\n * Validate that a string is a valid EVM token address\n * Returns true if valid (0x-prefixed, 40 hex characters)\n */\nexport function isValidTokenAddress(address: string): boolean {\n  if (!address) return false;\n  return /^0x[a-fA-F0-9]{40}$/.test(address);\n}\n\n/**\n * Maximum CSS size in bytes (10KB — CSS should be small)\n */\nexport const MAX_CSS_SIZE = 10 * 1024;\n\n/**\n * Prepare transaction arguments for updating profile custom CSS\n *\n * @param cssContent - CSS string to store\n * @returns Arguments for Storage.put() - [bytesKey, topic, bytesValue]\n *\n * @example\n * ```ts\n * const args = getProfileCSSStorageArgs(\".profile-themed { --primary: 210 40% 98%; }\");\n * writeContract({\n *   abi: STORAGE_CONTRACT.abi,\n *   address: STORAGE_CONTRACT.address,\n *   functionName: \"put\",\n *   args: [args.bytesKey, args.topic, args.bytesValue],\n * });\n * ```\n */\nexport function getProfileCSSStorageArgs(\n  cssContent: string\n): ProfileStorageArgs {\n  const { bytesKey, bytesValue } = getBytesArgsForStorage(\n    PROFILE_CSS_STORAGE_KEY,\n    cssContent\n  );\n  return {\n    bytesKey,\n    topic: PROFILE_CSS_TOPIC,\n    bytesValue,\n  };\n}\n\n/**\n * Validate CSS content\n * Returns true if valid (non-empty, within size limit, no script injection)\n */\nexport function isValidCSS(css: string): boolean {\n  if (!css || css.trim().length === 0) return false;\n  if (Buffer.byteLength(css, \"utf-8\") > MAX_CSS_SIZE) return false;\n  // Block script injection via CSS expressions/behavior/url(javascript:)\n  const lowerCSS = css.toLowerCase();\n  if (lowerCSS.includes(\"expression(\")) return false;\n  if (lowerCSS.includes(\"behavior:\")) return false;\n  if (lowerCSS.includes(\"javascript:\")) return false;\n  if (/<script/i.test(css)) return false;\n  return true;\n}\n","/**\n * Single source of truth for profile CSS theming.\n *\n * This file defines:\n * 1. THEME_SELECTORS — the stable set of CSS selectors/variables available for theming\n * 2. DEMO_THEMES — example CSS themes users can apply\n * 3. buildCSSPrompt() — generates an AI prompt describing what can be themed\n *\n * When the profile page structure changes, update THEME_SELECTORS here and\n * everything downstream (AI prompt, docs, validation) stays in sync.\n */\n\n/**\n * A themeable selector or CSS variable group\n */\nexport interface ThemeSelector {\n  /** CSS selector or variable name */\n  selector: string;\n  /** Human-readable description of what it targets */\n  description: string;\n  /** Category for grouping in documentation */\n  category: \"variable\" | \"layout\" | \"component\";\n}\n\n/**\n * All themeable selectors available for profile CSS.\n *\n * CSS variables (category: \"variable\") are the most stable —\n * they survive page restructuring because they're part of the\n * shadcn/Tailwind design system.\n *\n * Layout and component selectors may break when the page structure changes.\n */\nexport const THEME_SELECTORS: ThemeSelector[] = [\n  // --- CSS Variables (stable) ---\n  {\n    selector: \"--background\",\n    description: \"Page background color (HSL values, e.g. '210 40% 2%')\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--foreground\",\n    description: \"Default text color\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--primary\",\n    description: \"Primary accent color (buttons, links, headings)\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--primary-foreground\",\n    description: \"Text on primary-colored elements\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--secondary\",\n    description: \"Secondary accent color\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--secondary-foreground\",\n    description: \"Text on secondary-colored elements\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--muted\",\n    description: \"Muted/subdued background\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--muted-foreground\",\n    description: \"Text on muted backgrounds\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--accent\",\n    description: \"Accent color for highlights\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--accent-foreground\",\n    description: \"Text on accent-colored elements\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--card\",\n    description: \"Card/panel background color\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--card-foreground\",\n    description: \"Text inside cards\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--border\",\n    description: \"Border color\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--ring\",\n    description: \"Focus ring color\",\n    category: \"variable\",\n  },\n  {\n    selector: \"--radius\",\n    description: \"Border radius (e.g. '0.5rem')\",\n    category: \"variable\",\n  },\n\n  // --- Layout selectors (may change with page restructuring) ---\n  {\n    selector: \".profile-themed\",\n    description: \"Root wrapper for all themed profile content\",\n    category: \"layout\",\n  },\n\n  // --- Component selectors (may change with page restructuring) ---\n  {\n    selector: \".profile-themed .profile-header\",\n    description: \"Profile header area (name, picture, bio)\",\n    category: \"component\",\n  },\n  {\n    selector: \".profile-themed .profile-tabs\",\n    description: \"Tab navigation bar\",\n    category: \"component\",\n  },\n  {\n    selector: \".profile-themed .profile-content\",\n    description: \"Main content area below tabs\",\n    category: \"component\",\n  },\n];\n\n/**\n * Demo themes that users can choose from as starting points.\n * Each is a complete CSS string ready to store on-chain.\n */\nexport const DEMO_THEMES: Record<string, { name: string; css: string }> = {\n  hotPink: {\n    name: \"Hot Pink Scene\",\n    css: `.profile-themed {\n  --background: 320 80% 4%;\n  --foreground: 320 20% 95%;\n  --primary: 330 100% 60%;\n  --primary-foreground: 0 0% 100%;\n  --secondary: 280 60% 20%;\n  --secondary-foreground: 320 20% 95%;\n  --muted: 320 40% 12%;\n  --muted-foreground: 320 20% 70%;\n  --accent: 330 100% 60%;\n  --accent-foreground: 0 0% 100%;\n  --card: 320 60% 6%;\n  --card-foreground: 320 20% 95%;\n  --border: 330 60% 25%;\n  --ring: 330 100% 60%;\n}`,\n  },\n  midnightGrunge: {\n    name: \"Midnight Grunge\",\n    css: `.profile-themed {\n  --background: 220 30% 3%;\n  --foreground: 220 10% 80%;\n  --primary: 45 90% 55%;\n  --primary-foreground: 220 30% 5%;\n  --secondary: 220 20% 12%;\n  --secondary-foreground: 220 10% 80%;\n  --muted: 220 20% 8%;\n  --muted-foreground: 220 10% 50%;\n  --accent: 45 90% 55%;\n  --accent-foreground: 220 30% 5%;\n  --card: 220 25% 5%;\n  --card-foreground: 220 10% 80%;\n  --border: 220 15% 15%;\n  --ring: 45 90% 55%;\n}`,\n  },\n  ocean: {\n    name: \"Deep Ocean\",\n    css: `.profile-themed {\n  --background: 200 60% 3%;\n  --foreground: 190 20% 90%;\n  --primary: 190 80% 50%;\n  --primary-foreground: 200 60% 5%;\n  --secondary: 210 40% 15%;\n  --secondary-foreground: 190 20% 90%;\n  --muted: 200 40% 8%;\n  --muted-foreground: 190 20% 55%;\n  --accent: 170 70% 45%;\n  --accent-foreground: 200 60% 5%;\n  --card: 200 50% 5%;\n  --card-foreground: 190 20% 90%;\n  --border: 200 30% 18%;\n  --ring: 190 80% 50%;\n}`,\n  },\n};\n\n/**\n * Build an AI prompt that describes the available theming surface.\n * Feed this to an LLM alongside a user's description to generate CSS.\n *\n * @returns A prompt string listing all available selectors and usage rules\n */\nexport function buildCSSPrompt(): string {\n  const variableLines = THEME_SELECTORS.filter(\n    (s) => s.category === \"variable\"\n  )\n    .map((s) => `  ${s.selector}: ${s.description}`)\n    .join(\"\\n\");\n\n  const layoutLines = THEME_SELECTORS.filter((s) => s.category === \"layout\")\n    .map((s) => `  ${s.selector} — ${s.description}`)\n    .join(\"\\n\");\n\n  const componentLines = THEME_SELECTORS.filter(\n    (s) => s.category === \"component\"\n  )\n    .map((s) => `  ${s.selector} — ${s.description}`)\n    .join(\"\\n\");\n\n  return `You are a CSS theme generator for a user profile page.\nAll styles MUST be scoped under the .profile-themed wrapper class.\n\n## CSS Variables (stable — preferred for theming)\nThese use HSL values WITHOUT the hsl() wrapper (e.g. \"210 40% 98%\"):\n${variableLines}\n\n## Layout Selectors (may change across site updates)\n${layoutLines}\n\n## Component Selectors (may change across site updates)\n${componentLines}\n\n## Rules\n1. All selectors MUST start with .profile-themed\n2. CSS variables go inside .profile-themed { ... } as custom properties\n3. Use only valid CSS — no JavaScript, no expressions, no imports\n4. Keep the output under 10KB\n5. Prefer CSS variables over direct selector styling for durability\n6. HSL values are bare numbers: \"210 40% 98%\" not \"hsl(210, 40%, 98%)\"\n\nGiven a user description, output ONLY the CSS (no explanation, no markdown fences).`;\n}\n"]}