cbrowser 16.0.0 → 16.2.0

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export { getDefaultConfig, getPaths, ensureDirectories, mergeConfig } from "./co
 export type { CBrowserConfig, CBrowserPaths, BrowserType } from "./config.js";
 export * from "./types.js";
 export { BUILTIN_PERSONAS } from "./personas.js";
+export * from "./trait-reference.js";
 export { startMcpServer } from "./mcp-server.js";
 export { startDaemon, stopDaemon, getDaemonStatus, isDaemonRunning, sendToDaemon, runDaemonServer } from "./daemon.js";
 export * from "./visual/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIvH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG1E,cAAc,oBAAoB,CAAC;AAInC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIvH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG1E,cAAc,oBAAoB,CAAC;AAInC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -27,6 +27,8 @@ export { CBrowser } from "./browser.js";
 export { getDefaultConfig, getPaths, ensureDirectories, mergeConfig } from "./config.js";
 export * from "./types.js";
 export { BUILTIN_PERSONAS } from "./personas.js";
+// Trait Reference (v15.0.0) - Cognitive trait definitions and guidelines
+export * from "./trait-reference.js";
 export { startMcpServer } from "./mcp-server.js";
 export { startDaemon, stopDaemon, getDaemonStatus, isDaemonRunning, sendToDaemon, runDaemonServer } from "./daemon.js";
 // Modular exports (v7.3.0)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzF,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvH,2BAA2B;AAC3B,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAElC,iBAAiB;AACjB,cAAc,oBAAoB,CAAC;AAEnC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,qBAAqB;AACrB,cAAc,wBAAwB,CAAC;AAEvC,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E,2BAA2B;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,6CAA6C;AAC7C,uDAAuD;AACvD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzF,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,yEAAyE;AACzE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvH,2BAA2B;AAC3B,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAElC,iBAAiB;AACjB,cAAc,oBAAoB,CAAC;AAEnC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,qBAAqB;AACrB,cAAc,wBAAwB,CAAC;AAEvC,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E,2BAA2B;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,6CAA6C;AAC7C,uDAAuD;AACvD,cAAc,oBAAoB,CAAC"}

package/dist/stealth/index.d.ts

@@ -18,4 +18,5 @@
  */
 export { DEFAULT_STEALTH_CONFIG, MINIMUM_RATE_LIMITS, STEALTH_TERMS_OF_SERVICE, matchesDomainPattern, isProhibitedDomain, validateAcknowledgment, mergeStealthConfig, BaseConstitutionalEnforcer, NoOpConstitutionalEnforcer, } from "./framework.js";
 export type { StealthConfig, StealthAuthorization, StealthAcknowledgment, StealthRateLimits, StealthAuditEntry, StealthCheckResult, IConstitutionalEnforcer, } from "./framework.js";
+export { getEnforcer, getEnforcerSync, isEnterpriseAvailable, getEnterpriseVersion, printEnterpriseStatus, } from "./loader.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/stealth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stealth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stealth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/stealth/index.js

@@ -17,4 +17,6 @@
  * Full implementation available in cbrowser-enterprise.
  */
 export { DEFAULT_STEALTH_CONFIG, MINIMUM_RATE_LIMITS, STEALTH_TERMS_OF_SERVICE, matchesDomainPattern, isProhibitedDomain, validateAcknowledgment, mergeStealthConfig, BaseConstitutionalEnforcer, NoOpConstitutionalEnforcer, } from "./framework.js";
+// Enterprise loader (v15.0.0)
+export { getEnforcer, getEnforcerSync, isEnterpriseAvailable, getEnterpriseVersion, printEnterpriseStatus, } from "./loader.js";
 //# sourceMappingURL=index.js.map

package/dist/stealth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stealth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stealth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAYxB,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/stealth/loader.d.ts

@@ -0,0 +1,60 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ *
+ * Copyright (c) 2026 WF Media (Alexandria Eden)
+ * Email: alexandria.shai.eden@gmail.com
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Enterprise Loader (v15.0.0)
+ *
+ * Dynamically loads cbrowser-enterprise if installed.
+ * Falls back to NoOpConstitutionalEnforcer for public-only users.
+ */
+import type { IConstitutionalEnforcer, StealthConfig } from "../types.js";
+/**
+ * Check if enterprise module is available
+ */
+export declare function isEnterpriseAvailable(): Promise<boolean>;
+/**
+ * Get enterprise version if available
+ */
+export declare function getEnterpriseVersion(): string | null;
+/**
+ * Get the appropriate constitutional enforcer
+ *
+ * Returns EnterpriseConstitutionalEnforcer if cbrowser-enterprise is installed,
+ * otherwise returns NoOpConstitutionalEnforcer.
+ *
+ * @param config - Optional stealth configuration
+ * @returns Constitutional enforcer instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect enterprise
+ * const enforcer = await getEnforcer();
+ *
+ * // With custom config
+ * const enforcer = await getEnforcer({
+ *   enabled: true,
+ *   authorization: {
+ *     authorizedDomains: ["*.mycompany.com"],
+ *   },
+ * });
+ * ```
+ */
+export declare function getEnforcer(config?: Partial<StealthConfig>): Promise<IConstitutionalEnforcer>;
+/**
+ * Create enforcer synchronously (uses cached module)
+ *
+ * Must call isEnterpriseAvailable() first to load module.
+ * If called before loading, returns NoOp enforcer.
+ */
+export declare function getEnforcerSync(config?: Partial<StealthConfig>): IConstitutionalEnforcer;
+/**
+ * Print enterprise status for diagnostics
+ */
+export declare function printEnterpriseStatus(): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/stealth/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/stealth/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa1E;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAW9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AA4CD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CASlC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,uBAAuB,CAMzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB3D"}

package/dist/stealth/loader.js

@@ -0,0 +1,139 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ *
+ * Copyright (c) 2026 WF Media (Alexandria Eden)
+ * Email: alexandria.shai.eden@gmail.com
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE file in the root directory of this source tree.
+ */
+import { NoOpConstitutionalEnforcer } from "./framework.js";
+/** Cache the loaded module */
+let enterpriseModule = null;
+let loadAttempted = false;
+/**
+ * Check if enterprise module is available
+ */
+export async function isEnterpriseAvailable() {
+    if (loadAttempted) {
+        return enterpriseModule !== null;
+    }
+    try {
+        await loadEnterpriseModule();
+        return enterpriseModule !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get enterprise version if available
+ */
+export function getEnterpriseVersion() {
+    return enterpriseModule?.version ?? null;
+}
+/**
+ * Attempt to load enterprise module
+ */
+async function loadEnterpriseModule() {
+    if (loadAttempted) {
+        return enterpriseModule;
+    }
+    loadAttempted = true;
+    try {
+        // Dynamic import of enterprise package
+        // This will fail gracefully if not installed
+        // Use string variable to prevent TypeScript from resolving at compile time
+        const enterprisePackage = "cbrowser-enterprise";
+        const module = await import(/* webpackIgnore: true */ enterprisePackage);
+        // Validate module shape
+        if (module.EnterpriseConstitutionalEnforcer &&
+            typeof module.EnterpriseConstitutionalEnforcer === "function") {
+            enterpriseModule = module;
+            console.log(`[CBrowser] Enterprise module loaded (v${module.version || "unknown"})`);
+            return enterpriseModule;
+        }
+        else {
+            console.warn("[CBrowser] Enterprise module found but invalid shape");
+            return null;
+        }
+    }
+    catch (error) {
+        // Not installed - this is expected for public-only users
+        if (error.code === "ERR_MODULE_NOT_FOUND") {
+            // Silent - enterprise not installed
+            return null;
+        }
+        // Unexpected error
+        console.warn("[CBrowser] Failed to load enterprise module:", error);
+        return null;
+    }
+}
+/**
+ * Get the appropriate constitutional enforcer
+ *
+ * Returns EnterpriseConstitutionalEnforcer if cbrowser-enterprise is installed,
+ * otherwise returns NoOpConstitutionalEnforcer.
+ *
+ * @param config - Optional stealth configuration
+ * @returns Constitutional enforcer instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect enterprise
+ * const enforcer = await getEnforcer();
+ *
+ * // With custom config
+ * const enforcer = await getEnforcer({
+ *   enabled: true,
+ *   authorization: {
+ *     authorizedDomains: ["*.mycompany.com"],
+ *   },
+ * });
+ * ```
+ */
+export async function getEnforcer(config) {
+    const enterprise = await loadEnterpriseModule();
+    if (enterprise) {
+        return new enterprise.EnterpriseConstitutionalEnforcer(config);
+    }
+    // Fall back to NoOp
+    return new NoOpConstitutionalEnforcer(config);
+}
+/**
+ * Create enforcer synchronously (uses cached module)
+ *
+ * Must call isEnterpriseAvailable() first to load module.
+ * If called before loading, returns NoOp enforcer.
+ */
+export function getEnforcerSync(config) {
+    if (enterpriseModule) {
+        return new enterpriseModule.EnterpriseConstitutionalEnforcer(config);
+    }
+    return new NoOpConstitutionalEnforcer(config);
+}
+/**
+ * Print enterprise status for diagnostics
+ */
+export async function printEnterpriseStatus() {
+    const available = await isEnterpriseAvailable();
+    if (available) {
+        console.log("╔══════════════════════════════════════════════════════════╗");
+        console.log("║  CBrowser Enterprise: ACTIVE                             ║");
+        console.log(`║  Version: ${(getEnterpriseVersion() || "unknown").padEnd(47)}║`);
+        console.log("║  Stealth capabilities: ENABLED                           ║");
+        console.log("╚══════════════════════════════════════════════════════════╝");
+    }
+    else {
+        console.log("╔══════════════════════════════════════════════════════════╗");
+        console.log("║  CBrowser Enterprise: NOT INSTALLED                      ║");
+        console.log("║  Stealth capabilities: DISABLED (NoOp mode)              ║");
+        console.log("║                                                          ║");
+        console.log("║  To enable enterprise features:                          ║");
+        console.log("║  npm install cbrowser-enterprise --registry <private>    ║");
+        console.log("║                                                          ║");
+        console.log("║  Contact: alexandria.shai.eden@gmail.com                 ║");
+        console.log("╚══════════════════════════════════════════════════════════╝");
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/stealth/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/stealth/loader.ts"],"names":[],"mappings":"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"}

package/dist/trait-reference.d.ts

@@ -0,0 +1,87 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ *
+ * Copyright (c) 2026 WF Media (Alexandria Eden)
+ * Email: alexandria.shai.eden@gmail.com
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Cognitive Trait Reference Matrix (v15.0.0)
+ *
+ * This module provides authoritative definitions for all 25 cognitive traits.
+ * Use this as a reference when creating custom personas.
+ *
+ * Scale Convention: All traits use 0.0 to 1.0
+ * - 0.0-0.2 = Very Low
+ * - 0.2-0.4 = Low
+ * - 0.4-0.6 = Medium
+ * - 0.6-0.8 = High
+ * - 0.8-1.0 = Very High
+ */
+export interface TraitDefinition {
+    /** Trait identifier (matches CognitiveTraits interface) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** What 0.0 represents */
+    lowEnd: string;
+    /** What 1.0 represents */
+    highEnd: string;
+    /** Primary research citation */
+    research: string;
+    /** Research DOI or URL */
+    researchUrl?: string;
+    /** Behavioral examples at different levels */
+    examples: {
+        veryLow: string;
+        low: string;
+        medium: string;
+        high: string;
+        veryHigh: string;
+    };
+    /** Which personas typically score high/low */
+    typicalScores: {
+        high: string[];
+        low: string[];
+    };
+    /** Related traits that often correlate */
+    correlates: string[];
+    /** Default value for new personas */
+    defaultValue: number;
+}
+/**
+ * Complete trait definitions for all 25 cognitive traits
+ */
+export declare const TRAIT_DEFINITIONS: Record<string, TraitDefinition>;
+/**
+ * Quick reference for recommended trait values by persona archetype.
+ * Use as starting point when creating custom personas.
+ */
+export declare const PERSONA_TRAIT_GUIDELINES: Record<string, Record<string, number>>;
+/**
+ * Get trait definition by name
+ */
+export declare function getTraitDefinition(traitName: string): TraitDefinition | undefined;
+/**
+ * Get all trait names
+ */
+export declare function getTraitNames(): string[];
+/**
+ * Validate trait value is in valid range
+ */
+export declare function isValidTraitValue(value: number): boolean;
+/**
+ * Get human-readable level description for a trait value
+ */
+export declare function getTraitLevel(value: number): "veryLow" | "low" | "medium" | "high" | "veryHigh";
+/**
+ * Get example behavior for trait at given value
+ */
+export declare function getTraitExample(traitName: string, value: number): string | undefined;
+/**
+ * Suggest trait value based on persona characteristics
+ */
+export declare function suggestTraitValue(traitName: string, techLevel: "beginner" | "intermediate" | "expert", ageGroup?: "young" | "middle" | "elderly"): number;
+//# sourceMappingURL=trait-reference.d.ts.map

package/dist/trait-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trait-reference.d.ts","sourceRoot":"","sources":["../src/trait-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,8CAA8C;IAC9C,aAAa,EAAE;QACb,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,GAAG,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;IACF,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAmiB7D,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyF3E,CAAC;AAMF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAM/F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,UAAU,GAAG,cAAc,GAAG,QAAQ,EACjD,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GACxC,MAAM,CAmBR"}