@hexclave/shared 1.0.13 → 1.0.15

package/dist/esm/interface/crud/projects.d.ts

@@ -52,15 +52,11 @@ declare const projectsCrudAdminReadSchema: yup$1.ObjectSchema<{
   onboarding_state: {
     selected_config_choice: "create-new" | "link-existing";
     selected_apps: string[];
-    selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+    selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
     selected_email_theme_id: string | null;
     selected_payments_country: "US" | "OTHER";
   } | null | undefined;
   config: {
-    domains: {
-      domain: string;
-      handler_path: string;
-    }[];
     oauth_providers: {
       client_id?: string | undefined;
       client_secret?: string | undefined;
@@ -71,6 +67,10 @@ declare const projectsCrudAdminReadSchema: yup$1.ObjectSchema<{
       id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
       provider_config_id: string;
     }[];
+    domains: {
+      domain: string;
+      handler_path: string;
+    }[];
     allow_localhost: boolean;
     sign_up_enabled: boolean;
     credential_enabled: boolean;
@@ -205,15 +205,11 @@ declare const projectsCrudAdminUpdateSchema: yup$1.ObjectSchema<{
   onboarding_state: {
     selected_config_choice: "create-new" | "link-existing";
     selected_apps: string[];
-    selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+    selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
     selected_email_theme_id: string | null;
     selected_payments_country: "US" | "OTHER";
   } | null | undefined;
   config: {
-    domains?: {
-      domain: string;
-      handler_path: string;
-    }[] | undefined;
     oauth_providers?: {
       client_id?: string | undefined;
       client_secret?: string | undefined;
@@ -223,6 +219,10 @@ declare const projectsCrudAdminUpdateSchema: yup$1.ObjectSchema<{
       type: "shared" | "standard";
       id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
     }[] | undefined;
+    domains?: {
+      domain: string;
+      handler_path: string;
+    }[] | undefined;
     allow_localhost?: boolean | undefined;
     sign_up_enabled?: boolean | undefined;
     credential_enabled?: boolean | undefined;
@@ -285,15 +285,11 @@ declare const projectsCrudAdminCreateSchema: yup$1.ObjectSchema<{
   onboarding_state: {
     selected_config_choice: "create-new" | "link-existing";
     selected_apps: string[];
-    selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+    selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
     selected_email_theme_id: string | null;
     selected_payments_country: "US" | "OTHER";
   } | null | undefined;
   config: {
-    domains?: {
-      domain: string;
-      handler_path: string;
-    }[] | undefined;
     oauth_providers?: {
       client_id?: string | undefined;
       client_secret?: string | undefined;
@@ -303,6 +299,10 @@ declare const projectsCrudAdminCreateSchema: yup$1.ObjectSchema<{
       type: "shared" | "standard";
       id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
     }[] | undefined;
+    domains?: {
+      domain: string;
+      handler_path: string;
+    }[] | undefined;
     allow_localhost?: boolean | undefined;
     sign_up_enabled?: boolean | undefined;
     credential_enabled?: boolean | undefined;
@@ -425,15 +425,11 @@ declare const projectsCrud: ______crud0.CrudSchemaFromOptions<{
     onboarding_state: {
       selected_config_choice: "create-new" | "link-existing";
       selected_apps: string[];
-      selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+      selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
       selected_email_theme_id: string | null;
       selected_payments_country: "US" | "OTHER";
     } | null | undefined;
     config: {
-      domains: {
-        domain: string;
-        handler_path: string;
-      }[];
       oauth_providers: {
         client_id?: string | undefined;
         client_secret?: string | undefined;
@@ -444,6 +440,10 @@ declare const projectsCrud: ______crud0.CrudSchemaFromOptions<{
         id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
         provider_config_id: string;
       }[];
+      domains: {
+        domain: string;
+        handler_path: string;
+      }[];
       allow_localhost: boolean;
       sign_up_enabled: boolean;
       credential_enabled: boolean;
@@ -540,15 +540,11 @@ declare const projectsCrud: ______crud0.CrudSchemaFromOptions<{
     onboarding_state: {
       selected_config_choice: "create-new" | "link-existing";
       selected_apps: string[];
-      selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+      selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
       selected_email_theme_id: string | null;
       selected_payments_country: "US" | "OTHER";
     } | null | undefined;
     config: {
-      domains?: {
-        domain: string;
-        handler_path: string;
-      }[] | undefined;
       oauth_providers?: {
         client_id?: string | undefined;
         client_secret?: string | undefined;
@@ -558,6 +554,10 @@ declare const projectsCrud: ______crud0.CrudSchemaFromOptions<{
         type: "shared" | "standard";
         id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
       }[] | undefined;
+      domains?: {
+        domain: string;
+        handler_path: string;
+      }[] | undefined;
       allow_localhost?: boolean | undefined;
       sign_up_enabled?: boolean | undefined;
       credential_enabled?: boolean | undefined;
@@ -648,15 +648,11 @@ declare const adminUserProjectsCrud: ______crud0.CrudSchemaFromOptions<{
     onboarding_state: {
       selected_config_choice: "create-new" | "link-existing";
       selected_apps: string[];
-      selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+      selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
       selected_email_theme_id: string | null;
       selected_payments_country: "US" | "OTHER";
     } | null | undefined;
     config: {
-      domains: {
-        domain: string;
-        handler_path: string;
-      }[];
       oauth_providers: {
         client_id?: string | undefined;
         client_secret?: string | undefined;
@@ -667,6 +663,10 @@ declare const adminUserProjectsCrud: ______crud0.CrudSchemaFromOptions<{
         id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
         provider_config_id: string;
       }[];
+      domains: {
+        domain: string;
+        handler_path: string;
+      }[];
       allow_localhost: boolean;
       sign_up_enabled: boolean;
       credential_enabled: boolean;
@@ -763,15 +763,11 @@ declare const adminUserProjectsCrud: ______crud0.CrudSchemaFromOptions<{
     onboarding_state: {
       selected_config_choice: "create-new" | "link-existing";
       selected_apps: string[];
-      selected_sign_in_methods: ("google" | "github" | "microsoft" | "passkey" | "credential" | "magicLink")[];
+      selected_sign_in_methods: ("passkey" | "google" | "github" | "microsoft" | "credential" | "magicLink")[];
       selected_email_theme_id: string | null;
       selected_payments_country: "US" | "OTHER";
     } | null | undefined;
     config: {
-      domains?: {
-        domain: string;
-        handler_path: string;
-      }[] | undefined;
       oauth_providers?: {
         client_id?: string | undefined;
         client_secret?: string | undefined;
@@ -781,6 +777,10 @@ declare const adminUserProjectsCrud: ______crud0.CrudSchemaFromOptions<{
         type: "shared" | "standard";
         id: "google" | "github" | "microsoft" | "spotify" | "facebook" | "discord" | "gitlab" | "bitbucket" | "linkedin" | "apple" | "x" | "twitch";
       }[] | undefined;
+      domains?: {
+        domain: string;
+        handler_path: string;
+      }[] | undefined;
       allow_localhost?: boolean | undefined;
       sign_up_enabled?: boolean | undefined;
       credential_enabled?: boolean | undefined;

package/dist/esm/interface/crud/team-member-profiles.d.ts

@@ -34,27 +34,27 @@ declare const teamMemberProfilesCrudServerReadSchema: yup$1.ObjectSchema<{
     is_anonymous: boolean;
     is_restricted: boolean;
     requires_totp_mfa: boolean;
+    country_code: string | null;
+    profile_image_url: string | null;
+    signed_up_at_millis: number;
+    last_active_at_millis: number;
     primary_email_verified: boolean;
     primary_email_auth_enabled: boolean;
-    profile_image_url: string | null;
     selected_team: {
       client_metadata?: {} | null | undefined;
       client_read_only_metadata?: {} | null | undefined;
       server_metadata?: {} | null | undefined;
       display_name: string;
       id: string;
-      profile_image_url: string | null;
       created_at_millis: number;
+      profile_image_url: string | null;
     } | null;
-    signed_up_at_millis: number;
     has_password: boolean;
     otp_auth_enabled: boolean;
     passkey_auth_enabled: boolean;
-    last_active_at_millis: number;
     restricted_by_admin: boolean;
     restricted_by_admin_reason: string | null;
     restricted_by_admin_private_details: string | null;
-    country_code: string | null;
     risk_scores: {
       sign_up: {
         bot: number;
@@ -157,27 +157,27 @@ declare const teamMemberProfilesCrud: ______crud0.CrudSchemaFromOptions<{
       is_anonymous: boolean;
       is_restricted: boolean;
       requires_totp_mfa: boolean;
+      country_code: string | null;
+      profile_image_url: string | null;
+      signed_up_at_millis: number;
+      last_active_at_millis: number;
       primary_email_verified: boolean;
       primary_email_auth_enabled: boolean;
-      profile_image_url: string | null;
       selected_team: {
         client_metadata?: {} | null | undefined;
         client_read_only_metadata?: {} | null | undefined;
         server_metadata?: {} | null | undefined;
         display_name: string;
         id: string;
-        profile_image_url: string | null;
         created_at_millis: number;
+        profile_image_url: string | null;
       } | null;
-      signed_up_at_millis: number;
       has_password: boolean;
       otp_auth_enabled: boolean;
       passkey_auth_enabled: boolean;
-      last_active_at_millis: number;
       restricted_by_admin: boolean;
       restricted_by_admin_reason: string | null;
       restricted_by_admin_private_details: string | null;
-      country_code: string | null;
       risk_scores: {
         sign_up: {
           bot: number;

package/dist/esm/interface/crud/users.d.ts

@@ -83,8 +83,8 @@ declare const usersCrudServerReadSchema: yup$1.ObjectSchema<{
     server_metadata?: {} | null | undefined;
     display_name: string;
     id: string;
-    profile_image_url: string | null;
     created_at_millis: number;
+    profile_image_url: string | null;
   } | null;
   selected_team_id: string | null;
   profile_image_url: string | null;
@@ -164,21 +164,21 @@ declare const usersCrudServerReadSchema: yup$1.ObjectSchema<{
 }, "">;
 declare const usersCrudServerCreateSchema: yup$1.ObjectSchema<{
   primary_email: string | null | undefined;
+  password: string | null | undefined;
   display_name: string | null | undefined;
   client_metadata: {} | null | undefined;
   client_read_only_metadata: {} | null | undefined;
   server_metadata: {} | null | undefined;
   is_anonymous: boolean | undefined;
-  password: string | null | undefined;
+  country_code: string | null | undefined;
+  profile_image_url: string | null | undefined;
   primary_email_verified: boolean | undefined;
   primary_email_auth_enabled: boolean | undefined;
-  profile_image_url: string | null | undefined;
   otp_auth_enabled: boolean | undefined;
   passkey_auth_enabled: boolean | undefined;
   restricted_by_admin: boolean | undefined;
   restricted_by_admin_reason: string | null | undefined;
   restricted_by_admin_private_details: string | null | undefined;
-  country_code: string | null | undefined;
   risk_scores: {
     sign_up: {
       bot: number;
@@ -236,8 +236,8 @@ declare const usersCrud: ______crud0.CrudSchemaFromOptions<{
       server_metadata?: {} | null | undefined;
       display_name: string;
       id: string;
-      profile_image_url: string | null;
       created_at_millis: number;
+      profile_image_url: string | null;
     } | null;
     selected_team_id: string | null;
     profile_image_url: string | null;
@@ -370,21 +370,21 @@ declare const usersCrud: ______crud0.CrudSchemaFromOptions<{
   }, "">;
   serverCreateSchema: yup$1.ObjectSchema<{
     primary_email: string | null | undefined;
+    password: string | null | undefined;
     display_name: string | null | undefined;
     client_metadata: {} | null | undefined;
     client_read_only_metadata: {} | null | undefined;
     server_metadata: {} | null | undefined;
     is_anonymous: boolean | undefined;
-    password: string | null | undefined;
+    country_code: string | null | undefined;
+    profile_image_url: string | null | undefined;
     primary_email_verified: boolean | undefined;
     primary_email_auth_enabled: boolean | undefined;
-    profile_image_url: string | null | undefined;
     otp_auth_enabled: boolean | undefined;
     passkey_auth_enabled: boolean | undefined;
     restricted_by_admin: boolean | undefined;
     restricted_by_admin_reason: string | null | undefined;
     restricted_by_admin_private_details: string | null | undefined;
-    country_code: string | null | undefined;
     risk_scores: {
       sign_up: {
         bot: number;
@@ -470,8 +470,8 @@ declare const userCreatedWebhookEvent: WebhookEvent<yup$1.ObjectSchema<{
     server_metadata?: {} | null | undefined;
     display_name: string;
     id: string;
-    profile_image_url: string | null;
     created_at_millis: number;
+    profile_image_url: string | null;
   } | null;
   selected_team_id: string | null;
   profile_image_url: string | null;
@@ -561,8 +561,8 @@ declare const userUpdatedWebhookEvent: WebhookEvent<yup$1.ObjectSchema<{
     server_metadata?: {} | null | undefined;
     display_name: string;
     id: string;
-    profile_image_url: string | null;
     created_at_millis: number;
+    profile_image_url: string | null;
   } | null;
   selected_team_id: string | null;
   profile_image_url: string | null;

package/dist/esm/interface/webhooks.d.ts

@@ -22,8 +22,8 @@ declare const webhookEvents: readonly [WebhookEvent<yup$1.ObjectSchema<{
     server_metadata?: {} | null | undefined;
     display_name: string;
     id: string;
-    profile_image_url: string | null;
     created_at_millis: number;
+    profile_image_url: string | null;
   } | null;
   selected_team_id: string | null;
   profile_image_url: string | null;
@@ -112,8 +112,8 @@ declare const webhookEvents: readonly [WebhookEvent<yup$1.ObjectSchema<{
     server_metadata?: {} | null | undefined;
     display_name: string;
     id: string;
-    profile_image_url: string | null;
     created_at_millis: number;
+    profile_image_url: string | null;
   } | null;
   selected_team_id: string | null;
   profile_image_url: string | null;

package/dist/esm/utils/analytics-clickmap-overlay.d.ts

@@ -0,0 +1,18 @@
+//#region src/utils/analytics-clickmap-overlay.d.ts
+/**
+ * Wire protocol for handing a clickmap overlay token from the dashboard to the
+ * in-page dev tool via `sessionStorage` + a window event.
+ *
+ * The token is a self-describing JWT: its payload already carries the
+ * `project_id` and `origin` it was minted for, so the reader derives both from
+ * the token itself and the writer only has to hand over a single value. The
+ * dashboard (writer) and the dev tool (reader) live in different packages but
+ * must agree on these exact names — this module is the single source of truth so
+ * they can never silently desync.
+ */
+declare const CLICKMAP_OVERLAY_TOKEN_STORAGE_KEY = "hexclave-clickmap-token";
+declare const CLICKMAP_OVERLAY_RESUME_STORAGE_KEY = "hexclave-clickmap-resume";
+declare const CLICKMAP_OVERLAY_TOKEN_UPDATED_EVENT = "hexclave:clickmap-token-updated";
+//#endregion
+export { CLICKMAP_OVERLAY_RESUME_STORAGE_KEY, CLICKMAP_OVERLAY_TOKEN_STORAGE_KEY, CLICKMAP_OVERLAY_TOKEN_UPDATED_EVENT };
+//# sourceMappingURL=analytics-clickmap-overlay.d.ts.map

package/dist/esm/utils/analytics-clickmap-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-clickmap-overlay.d.ts","names":[],"sources":["../../../src/utils/analytics-clickmap-overlay.tsx"],"mappings":";;AAYA;;;;;AACA;;;;;cADa,kCAAA;AAAA,cACA,mCAAA;AAAA,cACA,oCAAA"}

package/dist/esm/utils/analytics-clickmap-overlay.js

@@ -0,0 +1,19 @@
+//#region src/utils/analytics-clickmap-overlay.tsx
+/**
+* Wire protocol for handing a clickmap overlay token from the dashboard to the
+* in-page dev tool via `sessionStorage` + a window event.
+*
+* The token is a self-describing JWT: its payload already carries the
+* `project_id` and `origin` it was minted for, so the reader derives both from
+* the token itself and the writer only has to hand over a single value. The
+* dashboard (writer) and the dev tool (reader) live in different packages but
+* must agree on these exact names — this module is the single source of truth so
+* they can never silently desync.
+*/
+const CLICKMAP_OVERLAY_TOKEN_STORAGE_KEY = "hexclave-clickmap-token";
+const CLICKMAP_OVERLAY_RESUME_STORAGE_KEY = "hexclave-clickmap-resume";
+const CLICKMAP_OVERLAY_TOKEN_UPDATED_EVENT = "hexclave:clickmap-token-updated";
+
+//#endregion
+export { CLICKMAP_OVERLAY_RESUME_STORAGE_KEY, CLICKMAP_OVERLAY_TOKEN_STORAGE_KEY, CLICKMAP_OVERLAY_TOKEN_UPDATED_EVENT };
+//# sourceMappingURL=analytics-clickmap-overlay.js.map

package/dist/esm/utils/analytics-clickmap-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-clickmap-overlay.js","names":[],"sources":["../../../src/utils/analytics-clickmap-overlay.tsx"],"sourcesContent":["/**\n * Wire protocol for handing a clickmap overlay token from the dashboard to the\n * in-page dev tool via `sessionStorage` + a window event.\n *\n * The token is a self-describing JWT: its payload already carries the\n * `project_id` and `origin` it was minted for, so the reader derives both from\n * the token itself and the writer only has to hand over a single value. The\n * dashboard (writer) and the dev tool (reader) live in different packages but\n * must agree on these exact names — this module is the single source of truth so\n * they can never silently desync.\n */\n\nexport const CLICKMAP_OVERLAY_TOKEN_STORAGE_KEY = \"hexclave-clickmap-token\";\nexport const CLICKMAP_OVERLAY_RESUME_STORAGE_KEY = \"hexclave-clickmap-resume\";\nexport const CLICKMAP_OVERLAY_TOKEN_UPDATED_EVENT = \"hexclave:clickmap-token-updated\";\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,qCAAqC;AAClD,MAAa,sCAAsC;AACnD,MAAa,uCAAuC"}

package/dist/esm/utils/dev-tool.d.ts

@@ -0,0 +1,31 @@
+//#region src/utils/dev-tool.d.ts
+/**
+ * Shared identity of the Hexclave in-page dev tool / clickmap overlay.
+ *
+ * These constants are the single source of truth for "is this DOM / event /
+ * stored click part of the dev tool itself?". They are consumed across package
+ * boundaries:
+ *  - the dev tool mounts its root element with {@link DEV_TOOL_ROOT_ID} and
+ *    prefixes every generated class with {@link DEV_TOOL_CLASS_PREFIX};
+ *  - the event tracker uses them to skip self-clicks at ingest;
+ *  - the backend clickmap query uses them to filter dev-tool clicks out of
+ *    aggregate clickmaps server-side.
+ *
+ * Keep them here so a rename can never silently desync the SQL filter from the
+ * actual DOM identity.
+ */
+declare const DEV_TOOL_ROOT_ID = "__hexclave-dev-tool-root";
+/**
+ * Root element id of the standalone clickmap overlay. The clickmap is an
+ * independent feature with its own mount (it must survive the dev tool being
+ * removed), so it gets its own root — but its self-clicks need the exact same
+ * ingest/query exclusions as the dev tool's.
+ */
+declare const CLICKMAP_ROOT_ID = "__hexclave-clickmap-root";
+/** Prefix applied to every class/generated id the dev tool renders. */
+declare const DEV_TOOL_CLASS_PREFIX = "sdt-";
+/** Legacy class marker still present on older dev-tool builds. */
+declare const DEV_TOOL_LEGACY_CLASS = "stack-devtool";
+//#endregion
+export { CLICKMAP_ROOT_ID, DEV_TOOL_CLASS_PREFIX, DEV_TOOL_LEGACY_CLASS, DEV_TOOL_ROOT_ID };
+//# sourceMappingURL=dev-tool.d.ts.map

package/dist/esm/utils/dev-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-tool.d.ts","names":[],"sources":["../../../src/utils/dev-tool.tsx"],"mappings":";;AAeA;;;;;AAQA;;;;;AAGA;;;;cAXa,gBAAA;AAcb;;;;;;AAAA,cANa,gBAAA;;cAGA,qBAAA;;cAGA,qBAAA"}

package/dist/esm/utils/dev-tool.js

@@ -0,0 +1,32 @@
+//#region src/utils/dev-tool.tsx
+/**
+* Shared identity of the Hexclave in-page dev tool / clickmap overlay.
+*
+* These constants are the single source of truth for "is this DOM / event /
+* stored click part of the dev tool itself?". They are consumed across package
+* boundaries:
+*  - the dev tool mounts its root element with {@link DEV_TOOL_ROOT_ID} and
+*    prefixes every generated class with {@link DEV_TOOL_CLASS_PREFIX};
+*  - the event tracker uses them to skip self-clicks at ingest;
+*  - the backend clickmap query uses them to filter dev-tool clicks out of
+*    aggregate clickmaps server-side.
+*
+* Keep them here so a rename can never silently desync the SQL filter from the
+* actual DOM identity.
+*/
+const DEV_TOOL_ROOT_ID = "__hexclave-dev-tool-root";
+/**
+* Root element id of the standalone clickmap overlay. The clickmap is an
+* independent feature with its own mount (it must survive the dev tool being
+* removed), so it gets its own root — but its self-clicks need the exact same
+* ingest/query exclusions as the dev tool's.
+*/
+const CLICKMAP_ROOT_ID = "__hexclave-clickmap-root";
+/** Prefix applied to every class/generated id the dev tool renders. */
+const DEV_TOOL_CLASS_PREFIX = "sdt-";
+/** Legacy class marker still present on older dev-tool builds. */
+const DEV_TOOL_LEGACY_CLASS = "stack-devtool";
+
+//#endregion
+export { CLICKMAP_ROOT_ID, DEV_TOOL_CLASS_PREFIX, DEV_TOOL_LEGACY_CLASS, DEV_TOOL_ROOT_ID };
+//# sourceMappingURL=dev-tool.js.map

package/dist/esm/utils/dev-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-tool.js","names":[],"sources":["../../../src/utils/dev-tool.tsx"],"sourcesContent":["/**\n * Shared identity of the Hexclave in-page dev tool / clickmap overlay.\n *\n * These constants are the single source of truth for \"is this DOM / event /\n * stored click part of the dev tool itself?\". They are consumed across package\n * boundaries:\n *  - the dev tool mounts its root element with {@link DEV_TOOL_ROOT_ID} and\n *    prefixes every generated class with {@link DEV_TOOL_CLASS_PREFIX};\n *  - the event tracker uses them to skip self-clicks at ingest;\n *  - the backend clickmap query uses them to filter dev-tool clicks out of\n *    aggregate clickmaps server-side.\n *\n * Keep them here so a rename can never silently desync the SQL filter from the\n * actual DOM identity.\n */\nexport const DEV_TOOL_ROOT_ID = \"__hexclave-dev-tool-root\";\n\n/**\n * Root element id of the standalone clickmap overlay. The clickmap is an\n * independent feature with its own mount (it must survive the dev tool being\n * removed), so it gets its own root — but its self-clicks need the exact same\n * ingest/query exclusions as the dev tool's.\n */\nexport const CLICKMAP_ROOT_ID = \"__hexclave-clickmap-root\";\n\n/** Prefix applied to every class/generated id the dev tool renders. */\nexport const DEV_TOOL_CLASS_PREFIX = \"sdt-\";\n\n/** Legacy class marker still present on older dev-tool builds. */\nexport const DEV_TOOL_LEGACY_CLASS = \"stack-devtool\";\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAa,mBAAmB;;;;;;;AAQhC,MAAa,mBAAmB;;AAGhC,MAAa,wBAAwB;;AAGrC,MAAa,wBAAwB"}

package/dist/esm/utils/dom.d.ts

@@ -1,5 +1,11 @@
 //#region src/utils/dom.d.ts
 declare function hasClickableParent(element: HTMLElement): boolean;
+/**
+ * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.
+ * Prefers the native `CSS.escape` when available, falling back to a conservative
+ * backslash-escape for non-DOM environments (SSR, tests, older runtimes).
+ */
+declare function cssEscapeIdent(value: string): string;
 //#endregion
-export { hasClickableParent };
+export { cssEscapeIdent, hasClickableParent };
 //# sourceMappingURL=dom.d.ts.map

package/dist/esm/utils/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","names":[],"sources":["../../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAA,EAAS,WAAA"}
+{"version":3,"file":"dom.d.ts","names":[],"sources":["../../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAA,EAAS,WAAA;AAA5C;;;;;AAAA,iBAagB,cAAA,CAAe,KAAA"}

package/dist/esm/utils/dom.js

@@ -5,7 +5,26 @@ function hasClickableParent(element) {
 	if (parent.dataset.n2Clickable) return true;
 	return hasClickableParent(element.parentElement);
 }
+/**
+* Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.
+* Prefers the native `CSS.escape` when available, falling back to a conservative
+* backslash-escape for non-DOM environments (SSR, tests, older runtimes).
+*/
+function cssEscapeIdent(value) {
+	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return CSS.escape(value);
+	let escaped = "";
+	for (let i = 0; i < value.length; i += 1) {
+		const char = value.charAt(i);
+		const codeUnit = value.charCodeAt(i);
+		if (codeUnit === 0) escaped += "�";
+		else if (codeUnit >= 1 && codeUnit <= 31 || codeUnit === 127 || i === 0 && codeUnit >= 48 && codeUnit <= 57 || i === 1 && codeUnit >= 48 && codeUnit <= 57 && value.charCodeAt(0) === 45) escaped += `\\${codeUnit.toString(16)} `;
+		else if (i === 0 && codeUnit === 45 && value.length === 1) escaped += "\\-";
+		else if (codeUnit >= 128 || codeUnit === 45 || codeUnit === 95 || codeUnit >= 48 && codeUnit <= 57 || codeUnit >= 65 && codeUnit <= 90 || codeUnit >= 97 && codeUnit <= 122) escaped += char;
+		else escaped += `\\${char}`;
+	}
+	return escaped;
+}
 
 //#endregion
-export { hasClickableParent };
+export { cssEscapeIdent, hasClickableParent };
 //# sourceMappingURL=dom.js.map

package/dist/esm/utils/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":[],"sources":["../../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n"],"mappings":";AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,QAAQ,YAAa,QAAO;AAEvC,QAAO,mBAAmB,QAAQ,cAAc"}
+{"version":3,"file":"dom.js","names":[],"sources":["../../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n\n/**\n * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.\n * Prefers the native `CSS.escape` when available, falling back to a conservative\n * backslash-escape for non-DOM environments (SSR, tests, older runtimes).\n */\nexport function cssEscapeIdent(value: string): string {\n  if (typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\") {\n    return CSS.escape(value);\n  }\n\n  let escaped = \"\";\n  for (let i = 0; i < value.length; i += 1) {\n    const char = value.charAt(i);\n    const codeUnit = value.charCodeAt(i);\n\n    if (codeUnit === 0x0000) {\n      escaped += \"\\uFFFD\";\n    } else if (\n      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||\n      codeUnit === 0x007f ||\n      (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && value.charCodeAt(0) === 0x002d)\n    ) {\n      escaped += `\\\\${codeUnit.toString(16)} `;\n    } else if (i === 0 && codeUnit === 0x002d && value.length === 1) {\n      escaped += \"\\\\-\";\n    } else if (\n      codeUnit >= 0x0080 ||\n      codeUnit === 0x002d ||\n      codeUnit === 0x005f ||\n      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||\n      (codeUnit >= 0x0061 && codeUnit <= 0x007a)\n    ) {\n      escaped += char;\n    } else {\n      escaped += `\\\\${char}`;\n    }\n  }\n  return escaped;\n}\n"],"mappings":";AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,QAAQ,YAAa,QAAO;AAEvC,QAAO,mBAAmB,QAAQ,cAAc;;;;;;;AAQlD,SAAgB,eAAe,OAAuB;AACpD,KAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,WACtD,QAAO,IAAI,OAAO,MAAM;CAG1B,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,OAAO,MAAM,OAAO,EAAE;EAC5B,MAAM,WAAW,MAAM,WAAW,EAAE;AAEpC,MAAI,aAAa,EACf,YAAW;WAEV,YAAY,KAAU,YAAY,MACnC,aAAa,OACZ,MAAM,KAAK,YAAY,MAAU,YAAY,MAC7C,MAAM,KAAK,YAAY,MAAU,YAAY,MAAU,MAAM,WAAW,EAAE,KAAK,GAEhF,YAAW,KAAK,SAAS,SAAS,GAAG,CAAC;WAC7B,MAAM,KAAK,aAAa,MAAU,MAAM,WAAW,EAC5D,YAAW;WAEX,YAAY,OACZ,aAAa,MACb,aAAa,MACZ,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,IAEnC,YAAW;MAEX,YAAW,KAAK;;AAGpB,QAAO"}

package/dist/esm/utils/elements-chain.d.ts

@@ -0,0 +1,38 @@
+//#region src/utils/elements-chain.d.ts
+/**
+ * PostHog-style `elements_chain` format — the single owner of both halves of the
+ * contract. The event tracker {@link buildElementsChain serializes} a clicked
+ * element (and its ancestors) into a string; the clickmap overlay
+ * {@link parseElementsChain parses} that string back into structured segments so
+ * it can re-locate the element in a live DOM.
+ *
+ * Encode and decode MUST round-trip exactly, which is why they live together:
+ * the escaping applied here on the write side is reversed by the parser below,
+ * and a single round-trip test in `elements-chain.test.tsx` guards the pair.
+ *
+ * Segment shape (leaf-first, joined by `;`):
+ *   tag.class1.class2:nth-child="2":nth-of-type="1":text="Save":attr__id="x":href="..."
+ */
+type ElementsChainSegment = {
+  tag: string;
+  classes: string[];
+  attrs: Record<string, string>;
+  text: string | null;
+  nthChild: number | null;
+  nthOfType: number | null;
+  href: string | null;
+};
+declare const ELEMENTS_CHAIN_MAX_DEPTH = 8;
+declare const ELEMENTS_CHAIN_TEXT_MAX = 80;
+declare const ELEMENTS_CHAIN_ATTR_MAX = 200;
+declare const ELEMENTS_CHAIN_ATTRS: readonly ["id", "data-testid", "data-test-id", "data-hexclave-id", "name", "type", "role", "aria-label", "placeholder", "title"];
+/**
+ * Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}
+ * ancestors (leaf-first) into an `elements_chain` string.
+ */
+declare function buildElementsChain(element: Element): string;
+/** Parse an `elements_chain` string into structured, leaf-first segments. */
+declare function parseElementsChain(chain: string): ElementsChainSegment[];
+//#endregion
+export { ELEMENTS_CHAIN_ATTRS, ELEMENTS_CHAIN_ATTR_MAX, ELEMENTS_CHAIN_MAX_DEPTH, ELEMENTS_CHAIN_TEXT_MAX, ElementsChainSegment, buildElementsChain, parseElementsChain };
+//# sourceMappingURL=elements-chain.d.ts.map

package/dist/esm/utils/elements-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-chain.d.ts","names":[],"sources":["../../../src/utils/elements-chain.tsx"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,oBAAA;EACV,GAAA;EACA,OAAA;EACA,KAAA,EAAO,MAAA;EACP,IAAA;EACA,QAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGW,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cAKA,oBAAA;;;;AAAb;iBAyFgB,kBAAA,CAAmB,OAAA,EAAS,OAAA;;iBA0K5B,kBAAA,CAAmB,KAAA,WAAgB,oBAAA"}