@cranberry-money/shared-constants 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# @myportfolio/shared-constants
+
+Shared constants for the MyPortfolio platform, supporting both web (Blueberry) and mobile (Blackberry) applications.
+
+## Installation
+
+```bash
+npm install @myportfolio/shared-constants
+```
+
+## Usage
+
+```typescript
+import { 
+  CURRENCY_AUD, 
+  DEFAULT_CURRENCY, 
+  CHART_COLORS,
+  getChartColor,
+  TIME_RANGES 
+} from '@myportfolio/shared-constants';
+
+// Currency constants
+const defaultCurr = DEFAULT_CURRENCY; // 'AUD'
+
+// Chart colors for data visualization
+const portfolioColors = allocations.map((_, i) => getChartColor(i));
+
+// Time range configurations
+const availableRanges = TIME_RANGES; // [{ label: '1W', value: '1W', days: 7 }, ...]
+```
+
+## Available Constants
+
+### Common (`common.ts`)
+- Number formatting: `DECIMAL_PLACES`, quantity thresholds
+- Error types: `ERROR_TYPE_BUSINESS_LOGIC`, `ERROR_TYPE_PERMISSION`, etc.
+- Sort directions: `SORT_DIRECTION_ASC`, `SORT_DIRECTION_DESC`
+- Locale settings: `LOCALE_AUSTRALIA`
+
+### Currency (`currency.ts`)  
+- Currency codes: `CURRENCY_AUD`, `CURRENCY_USD`
+- Default currency: `DEFAULT_CURRENCY`
+- Currency info: `CURRENCIES` array with symbols and names
+- Helper: `getCurrencyInfo(code)` function
+
+### HTTP (`http.ts`)
+- HTTP headers: `HTTP_HEADER_CONTENT_TYPE`
+- Content types: `CONTENT_TYPE_APPLICATION_JSON`
+
+### Time (`time.ts`)
+- Time calculations: `MILLISECONDS_PER_DAY`
+- Default periods: `DEFAULT_RECENT_TRANSACTIONS_DAYS`
+- Time ranges: `TIME_RANGES` array with configurations
+- Types: `TimeRange`, `TimeRangeConfig`
+
+### UI Colors (`ui/colors.ts`)
+- Chart color palette: `CHART_COLORS` array
+- Dynamic color selection: `getChartColor(index)` function
+
+### UI Status (`ui/status.ts`)
+- Status type mappings: `STATUS_STATES` object
+- Platform-agnostic colors: `STATUS_COLORS` with hex values
+- Types: `StatusType`
+
+## Platform Compatibility
+
+This package is designed to work across:
+- Web applications (React) - Direct import of constants
+- Mobile applications (React Native) - Platform-agnostic hex colors and values
+- Node.js environments - For server-side consistency
+
+### Platform-Specific Adaptations
+
+#### Web (Tailwind CSS)
+```typescript
+import { STATUS_COLORS } from '@myportfolio/shared-constants';
+
+// Adapt hex colors to Tailwind classes
+const statusClasses = {
+  pending: 'text-warning-600',
+  success: 'text-success-600',
+  // ... map STATUS_COLORS to your design system
+};
+```
+
+#### Mobile (React Native)
+```typescript
+import { STATUS_COLORS, CHART_COLORS } from '@myportfolio/shared-constants';
+
+const styles = StyleSheet.create({
+  pendingStatus: {
+    color: STATUS_COLORS.pending, // Direct hex usage
+  },
+  chartData: {
+    backgroundColor: CHART_COLORS[0], // Direct hex usage
+  },
+});
+```
+
+## Development
+
+```bash
+# Build the package
+npm run build
+
+# Watch for changes  
+npm run dev
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT

package/dist/common.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Common shared constants for the MyPortfolio platform.
+ *
+ * Contains truly universal constants that don't fit into specific domains.
+ */
+export declare const DECIMAL_PLACES = 2;
+export declare const DEFAULT_NUMERIC_ZERO = 0;
+export declare const DEFAULT_EMPTY_STRING = "";
+export declare const QUANTITY_FORMAT_THRESHOLD_MILLION = 1000000;
+export declare const QUANTITY_FORMAT_THRESHOLD_THOUSAND = 1000;
+export declare const ERROR_TYPE_BUSINESS_LOGIC = "business_logic";
+export declare const ERROR_TYPE_PERMISSION = "permission";
+export declare const ERROR_TYPE_SERVER = "server";
+export declare const SORT_DIRECTION_ASC = "asc";
+export declare const SORT_DIRECTION_DESC = "desc";
+export type SortDirection = typeof SORT_DIRECTION_ASC | typeof SORT_DIRECTION_DESC;
+export declare const LOCALE_AUSTRALIA = "en-AU";
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY: {
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+};
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED: {
+    readonly signDisplay: "always";
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+};
+export declare const QUERY_PARAM_ORDER_BY = "order_by";
+export declare const ORDER_BY_CREATED_AT = "created_at";
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,cAAc,IAAI,CAAC;AAGhC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,iCAAiC,UAAU,CAAC;AACzD,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAGvD,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAG1C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,OAAO,kBAAkB,GAAG,OAAO,mBAAmB,CAAC;AAGnF,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAGxC,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,eAAO,MAAM,qCAAqC;;;;;CAGxC,CAAC;AAGX,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,mBAAmB,eAAe,CAAC"}

package/dist/common.js

@@ -0,0 +1,35 @@
+/**
+ * Common shared constants for the MyPortfolio platform.
+ *
+ * Contains truly universal constants that don't fit into specific domains.
+ */
+// Number formatting
+export const DECIMAL_PLACES = 2;
+// Default numeric values
+export const DEFAULT_NUMERIC_ZERO = 0;
+export const DEFAULT_EMPTY_STRING = '';
+// Quantity formatting thresholds
+export const QUANTITY_FORMAT_THRESHOLD_MILLION = 1000000;
+export const QUANTITY_FORMAT_THRESHOLD_THOUSAND = 1000;
+// Error types
+export const ERROR_TYPE_BUSINESS_LOGIC = 'business_logic';
+export const ERROR_TYPE_PERMISSION = 'permission';
+export const ERROR_TYPE_SERVER = 'server';
+// Sort directions
+export const SORT_DIRECTION_ASC = 'asc';
+export const SORT_DIRECTION_DESC = 'desc';
+// Locale and formatting constants
+export const LOCALE_AUSTRALIA = 'en-AU';
+// Number formatting options
+export const NUMBER_FORMAT_OPTIONS_CURRENCY = {
+    style: 'currency',
+    minimumFractionDigits: DECIMAL_PLACES,
+    maximumFractionDigits: DECIMAL_PLACES,
+};
+export const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED = {
+    ...NUMBER_FORMAT_OPTIONS_CURRENCY,
+    signDisplay: 'always',
+};
+// Query parameter constants
+export const QUERY_PARAM_ORDER_BY = 'order_by';
+export const ORDER_BY_CREATED_AT = 'created_at';

package/dist/currency.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Currency-related constants for the MyPortfolio platform.
+ *
+ * These constants should match backend constants where applicable.
+ */
+export declare const CURRENCY_AUD = "AUD";
+export declare const CURRENCY_USD = "USD";
+export declare const DEFAULT_CURRENCY = "AUD";
+export declare const CURRENCY_LABEL_AUD = "Australian Dollar";
+export declare const CURRENCY_LABEL_USD = "US Dollar";
+export type CurrencyCode = typeof CURRENCY_AUD | typeof CURRENCY_USD;
+export interface CurrencyInfo {
+    code: CurrencyCode;
+    name: string;
+    symbol: string;
+}
+export declare const CURRENCIES: CurrencyInfo[];
+export declare const getCurrencyInfo: (code: CurrencyCode) => CurrencyInfo | undefined;
+//# sourceMappingURL=currency.d.ts.map

package/dist/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../src/currency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAGlC,eAAO,MAAM,gBAAgB,QAAe,CAAC;AAG7C,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAG9C,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,GAAG,OAAO,YAAY,CAAC;AAGrE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,UAAU,EAAE,YAAY,EAGpC,CAAC;AAGF,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,KAAG,YAAY,GAAG,SAEnE,CAAC"}

package/dist/currency.js

@@ -0,0 +1,22 @@
+/**
+ * Currency-related constants for the MyPortfolio platform.
+ *
+ * These constants should match backend constants where applicable.
+ */
+// Currency constants - ISO 4217 codes
+export const CURRENCY_AUD = 'AUD';
+export const CURRENCY_USD = 'USD';
+// Default currency
+export const DEFAULT_CURRENCY = CURRENCY_AUD;
+// Currency label constants
+export const CURRENCY_LABEL_AUD = 'Australian Dollar';
+export const CURRENCY_LABEL_USD = 'US Dollar';
+// Available currencies with display information
+export const CURRENCIES = [
+    { code: CURRENCY_AUD, name: CURRENCY_LABEL_AUD, symbol: 'A$' },
+    { code: CURRENCY_USD, name: CURRENCY_LABEL_USD, symbol: '$' },
+];
+// Helper function to get currency info by code
+export const getCurrencyInfo = (code) => {
+    return CURRENCIES.find((currency) => currency.code === code);
+};

package/dist/http.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTTP and network-related constants for the MyPortfolio platform.
+ *
+ * Contains HTTP headers, content types, and other network-related constants.
+ */
+export declare const HTTP_HEADER_CONTENT_TYPE = "Content-Type";
+export declare const CONTENT_TYPE_APPLICATION_JSON = "application/json";
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAGvD,eAAO,MAAM,6BAA6B,qBAAqB,CAAC"}

package/dist/http.js

@@ -0,0 +1,9 @@
+/**
+ * HTTP and network-related constants for the MyPortfolio platform.
+ *
+ * Contains HTTP headers, content types, and other network-related constants.
+ */
+// HTTP Headers
+export const HTTP_HEADER_CONTENT_TYPE = 'Content-Type';
+// Content Types
+export const CONTENT_TYPE_APPLICATION_JSON = 'application/json';

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Centralized export of all shared constants
+ */
+export * from './common';
+export * from './time';
+export * from './currency';
+export * from './http';
+export * from './ui';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AAGvB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Centralized export of all shared constants
+ */
+// Re-export shared constants
+export * from './common';
+export * from './time';
+export * from './currency';
+export * from './http';
+// Re-export UI constants
+export * from './ui';

package/dist/time.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Time and time range constants for the MyPortfolio platform.
+ *
+ * Contains time-related constants for formatting, intervals, calculations,
+ * and time ranges used for charts, analytics, and filtering data by time periods.
+ */
+export declare const MILLISECONDS_PER_DAY: number;
+export declare const DEFAULT_RECENT_TRANSACTIONS_DAYS = 30;
+export declare const DATE_ISO_TIME_SEPARATOR = "T";
+export type TimeRange = '1W' | '1M' | '6M' | '1Y' | '3Y' | '5Y' | '10Y';
+export interface TimeRangeConfig {
+    label: string;
+    value: TimeRange;
+    days: number;
+}
+export declare const TIME_RANGES: TimeRangeConfig[];
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AAGxD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAGnD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAGxE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,eAAO,MAAM,WAAW,EAAE,eAAe,EAQxC,CAAC"}

package/dist/time.js

@@ -0,0 +1,22 @@
+/**
+ * Time and time range constants for the MyPortfolio platform.
+ *
+ * Contains time-related constants for formatting, intervals, calculations,
+ * and time ranges used for charts, analytics, and filtering data by time periods.
+ */
+// Time unit constants (in milliseconds) - only used constants
+export const MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;
+// Default time periods - only used constants
+export const DEFAULT_RECENT_TRANSACTIONS_DAYS = 30;
+// Date format patterns
+export const DATE_ISO_TIME_SEPARATOR = 'T';
+// Time range configurations with labels and day counts
+export const TIME_RANGES = [
+    { label: '1W', value: '1W', days: 7 },
+    { label: '1M', value: '1M', days: 30 },
+    { label: '6M', value: '6M', days: 180 },
+    { label: '1Y', value: '1Y', days: 365 },
+    { label: '3Y', value: '3Y', days: 1095 },
+    { label: '5Y', value: '5Y', days: 1825 },
+    { label: '10Y', value: '10Y', days: 3650 },
+];

package/dist/ui/colors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Chart colors for data visualizations
+ *
+ * This file provides programmatic access to chart colors for JavaScript/TypeScript code.
+ * These colors are specifically designed for data visualization and chart components.
+ *
+ * Usage:
+ * - Use CHART_COLORS array for static color assignments
+ * - Use getChartColor() function for dynamic color cycling
+ * - These can be adapted for platform-specific color systems
+ *
+ * For UI element styling:
+ * - Web: Use Tailwind classes (bg-surface-primary, text-content-primary, etc.)
+ * - Mobile: Adapt to React Native StyleSheet or theme system
+ */
+/**
+ * Chart color palette for data visualizations
+ *
+ * These colors are carefully selected for:
+ * - Visual distinction in charts and graphs
+ * - Accessibility and contrast
+ * - Brand consistency
+ */
+export declare const CHART_COLORS: readonly ["#3B82F6", "#EF4444", "#10B981", "#F59E0B", "#8B5CF6", "#EC4899", "#06B6D4", "#84CC16", "#F97316", "#6366F1"];
+/**
+ * Get a chart color by index with automatic cycling
+ *
+ * Useful for assigning colors to dynamic data sets where you don't know
+ * the number of items in advance. Automatically cycles through the palette.
+ *
+ * @param index - Zero-based index for color selection
+ * @returns Hex color string from the chart palette
+ *
+ * @example
+ * // Assign colors to portfolio allocations
+ * allocations.map((item, i) => ({
+ *   ...item,
+ *   color: getChartColor(i)
+ * }));
+ *
+ * // Colors cycle automatically:
+ * getChartColor(0);  // '#3B82F6' (blue)
+ * getChartColor(1);  // '#EF4444' (red)
+ * getChartColor(10); // '#3B82F6' (cycles back to blue)
+ */
+export declare const getChartColor: (index: number) => string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/ui/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,yHAWf,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAE7C,CAAC"}

package/dist/ui/colors.js

@@ -0,0 +1,59 @@
+/**
+ * Chart colors for data visualizations
+ *
+ * This file provides programmatic access to chart colors for JavaScript/TypeScript code.
+ * These colors are specifically designed for data visualization and chart components.
+ *
+ * Usage:
+ * - Use CHART_COLORS array for static color assignments
+ * - Use getChartColor() function for dynamic color cycling
+ * - These can be adapted for platform-specific color systems
+ *
+ * For UI element styling:
+ * - Web: Use Tailwind classes (bg-surface-primary, text-content-primary, etc.)
+ * - Mobile: Adapt to React Native StyleSheet or theme system
+ */
+/**
+ * Chart color palette for data visualizations
+ *
+ * These colors are carefully selected for:
+ * - Visual distinction in charts and graphs
+ * - Accessibility and contrast
+ * - Brand consistency
+ */
+export const CHART_COLORS = [
+    '#3B82F6', // Blue - primary data color
+    '#EF4444', // Red - negative/loss indicators
+    '#10B981', // Green - positive/gain indicators
+    '#F59E0B', // Amber - warning/volatility
+    '#8B5CF6', // Purple - volume/secondary metrics
+    '#EC4899', // Pink - accent data
+    '#06B6D4', // Cyan - info/neutral data
+    '#84CC16', // Lime - growth indicators
+    '#F97316', // Orange - emphasis data
+    '#6366F1', // Indigo - brand accent
+];
+/**
+ * Get a chart color by index with automatic cycling
+ *
+ * Useful for assigning colors to dynamic data sets where you don't know
+ * the number of items in advance. Automatically cycles through the palette.
+ *
+ * @param index - Zero-based index for color selection
+ * @returns Hex color string from the chart palette
+ *
+ * @example
+ * // Assign colors to portfolio allocations
+ * allocations.map((item, i) => ({
+ *   ...item,
+ *   color: getChartColor(i)
+ * }));
+ *
+ * // Colors cycle automatically:
+ * getChartColor(0);  // '#3B82F6' (blue)
+ * getChartColor(1);  // '#EF4444' (red)
+ * getChartColor(10); // '#3B82F6' (cycles back to blue)
+ */
+export const getChartColor = (index) => {
+    return CHART_COLORS[index % CHART_COLORS.length];
+};

package/dist/ui/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Centralized export of UI constants
+ */
+export * from './colors';
+export * from './status';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,5 @@
+/**
+ * Centralized export of UI constants
+ */
+export * from './colors';
+export * from './status';

package/dist/ui/status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Status constants for withdrawal and trade entities
+ *
+ * These constants map status states to consistent styling.
+ * Platform-specific implementations should adapt these to their styling systems:
+ * - Web: Convert to Tailwind classes or CSS variables
+ * - Mobile: Adapt to React Native StyleSheet or theme colors
+ *
+ * All color references should be adapted to platform-specific design systems.
+ */
+export type StatusType = 'pending' | 'processing' | 'success' | 'error' | 'neutral';
+export declare const STATUS_STATES: {
+    readonly PENDING: "pending";
+    readonly AWAITING: "pending";
+    readonly PROCESSING: "processing";
+    readonly IN_PROGRESS: "processing";
+    readonly APPROVED: "success";
+    readonly COMPLETED: "success";
+    readonly REJECTED: "error";
+    readonly FAILED: "error";
+    readonly CANCELLED: "neutral";
+    readonly DEFAULT: "neutral";
+};
+export declare const STATUS_COLORS: {
+    readonly pending: "#F59E0B";
+    readonly processing: "#3B82F6";
+    readonly success: "#10B981";
+    readonly error: "#EF4444";
+    readonly neutral: "#6B7280";
+};
+//# sourceMappingURL=status.d.ts.map

package/dist/ui/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/ui/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAGpF,eAAO,MAAM,aAAa;;;;;;;;;;;CAoBhB,CAAC;AAGX,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC"}

package/dist/ui/status.js

@@ -0,0 +1,36 @@
+/**
+ * Status constants for withdrawal and trade entities
+ *
+ * These constants map status states to consistent styling.
+ * Platform-specific implementations should adapt these to their styling systems:
+ * - Web: Convert to Tailwind classes or CSS variables
+ * - Mobile: Adapt to React Native StyleSheet or theme colors
+ *
+ * All color references should be adapted to platform-specific design systems.
+ */
+// Status state mappings
+export const STATUS_STATES = {
+    // Pending/Waiting states
+    PENDING: 'pending',
+    AWAITING: 'pending',
+    // Active/Processing states  
+    PROCESSING: 'processing',
+    IN_PROGRESS: 'processing',
+    // Success states
+    APPROVED: 'success',
+    COMPLETED: 'success',
+    // Error states
+    REJECTED: 'error',
+    FAILED: 'error',
+    // Neutral states
+    CANCELLED: 'neutral',
+    DEFAULT: 'neutral',
+};
+// Platform-agnostic status colors (hex values)
+export const STATUS_COLORS = {
+    pending: '#F59E0B', // Amber/Warning
+    processing: '#3B82F6', // Blue/Primary  
+    success: '#10B981', // Green/Success
+    error: '#EF4444', // Red/Error
+    neutral: '#6B7280', // Gray/Neutral
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@cranberry-money/shared-constants",
+  "version": "1.0.0",
+  "description": "Shared constants for MyPortfolio platform",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "keywords": [
+    "typescript",
+    "constants",
+    "shared",
+    "portfolio"
+  ],
+  "author": "MyPortfolio Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/cranberry.git",
+    "directory": "packages/shared-constants"
+  }
+}