@fullstackcraftllc/floe 0.0.16 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,11 @@
1
1
  import { ExposurePerExpiry, IVSurface } from '../types';
2
2
  import { HedgeImpulseConfig, CharmIntegralConfig, HedgeFlowAnalysis } from './types';
3
3
  export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, } from './types';
4
+ export type { HedgeContractEstimates, PressureZone, RegimeEdge, PressureLevel, PressureCloudConfig, PressureCloud, } from './pressurecloud';
4
5
  export { deriveRegimeParams, interpolateIVAtStrike } from './regime';
5
6
  export { computeHedgeImpulseCurve } from './curve';
6
7
  export { computeCharmIntegral } from './charm';
8
+ export { computePressureCloud } from './pressurecloud';
7
9
  /**
8
10
  * Compute a complete hedge flow analysis for a single expiration.
9
11
  *
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = void 0;
3
+ exports.computePressureCloud = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = void 0;
4
4
  exports.analyzeHedgeFlow = analyzeHedgeFlow;
5
5
  const regime_1 = require("./regime");
6
6
  const curve_1 = require("./curve");
@@ -14,6 +14,9 @@ var curve_2 = require("./curve");
14
14
  Object.defineProperty(exports, "computeHedgeImpulseCurve", { enumerable: true, get: function () { return curve_2.computeHedgeImpulseCurve; } });
15
15
  var charm_2 = require("./charm");
16
16
  Object.defineProperty(exports, "computeCharmIntegral", { enumerable: true, get: function () { return charm_2.computeCharmIntegral; } });
17
+ // Re-export pressure cloud
18
+ var pressurecloud_1 = require("./pressurecloud");
19
+ Object.defineProperty(exports, "computePressureCloud", { enumerable: true, get: function () { return pressurecloud_1.computePressureCloud; } });
17
20
  /**
18
21
  * Compute a complete hedge flow analysis for a single expiration.
19
22
  *
@@ -0,0 +1,166 @@
1
+ import { HedgeImpulseCurve } from './types';
2
+ import { RegimeParams } from './types';
3
+ /**
4
+ * Expected dealer hedge volume in futures contracts for a 1-point spot move.
5
+ * Positive = dealers buying, negative = dealers selling.
6
+ */
7
+ export interface HedgeContractEstimates {
8
+ /** E-mini Nasdaq 100 (multiplier: 20) */
9
+ nq: number;
10
+ /** Micro E-mini Nasdaq 100 (multiplier: 2) */
11
+ mnq: number;
12
+ /** E-mini S&P 500 (multiplier: 50) */
13
+ es: number;
14
+ /** Micro E-mini S&P 500 (multiplier: 5) */
15
+ mes: number;
16
+ }
17
+ /**
18
+ * A zone where price is likely to stabilize (positive impulse)
19
+ * or accelerate (negative impulse).
20
+ */
21
+ export interface PressureZone {
22
+ /** Center price of the zone (peak of the impulse) */
23
+ center: number;
24
+ /** Lower bound of the zone (25th percentile of the peak width) */
25
+ lower: number;
26
+ /** Upper bound of the zone (75th percentile of the peak width) */
27
+ upper: number;
28
+ /** Normalized strength 0-1 (relative to the strongest zone found) */
29
+ strength: number;
30
+ /** Whether this zone is above or below current spot */
31
+ side: 'above-spot' | 'below-spot';
32
+ /**
33
+ * Trade type this zone favors:
34
+ * - Stability zones below spot → long (buy the bounce)
35
+ * - Stability zones above spot → short (sell the rejection)
36
+ * - Acceleration zones below spot → short (momentum downside)
37
+ * - Acceleration zones above spot → long (momentum upside / squeeze)
38
+ */
39
+ tradeType: 'long' | 'short';
40
+ /**
41
+ * Hedge execution type:
42
+ * - passive: dealers post resting limit orders (positive gamma → absorption)
43
+ * - aggressive: dealers send market orders (negative gamma → sweeping)
44
+ */
45
+ hedgeType: 'passive' | 'aggressive';
46
+ }
47
+ /**
48
+ * A regime boundary where behavior flips between mean-reverting and trend-amplifying.
49
+ */
50
+ export interface RegimeEdge {
51
+ /** Price at which the impulse curve crosses zero */
52
+ price: number;
53
+ /** Direction of the transition relative to a downward price move */
54
+ transitionType: 'stable-to-unstable' | 'unstable-to-stable';
55
+ }
56
+ /**
57
+ * Per-price-level detail for the full pressure overlay.
58
+ */
59
+ export interface PressureLevel {
60
+ /** Price level */
61
+ price: number;
62
+ /**
63
+ * Stability score: positive means mean-reverting pressure at this level.
64
+ * Higher = stronger buffering. Weighted by proximity to spot.
65
+ */
66
+ stabilityScore: number;
67
+ /**
68
+ * Acceleration score: positive means trend-amplifying pressure at this level.
69
+ * Higher = stronger momentum fuel. Weighted by proximity to spot.
70
+ */
71
+ accelerationScore: number;
72
+ /**
73
+ * Expected signed hedge contracts (positive = dealers buy, negative = dealers sell)
74
+ * for a 1-point spot move toward this level. Units depend on product.
75
+ * @deprecated Use hedgeContracts instead for multi-product estimates.
76
+ */
77
+ expectedHedgeContracts: number;
78
+ /** Multi-product hedge contract estimates */
79
+ hedgeContracts: HedgeContractEstimates;
80
+ /**
81
+ * Whether dealers would hedge passively (limit orders / absorption)
82
+ * or aggressively (market orders / sweeping) at this level.
83
+ */
84
+ hedgeType: 'passive' | 'aggressive';
85
+ }
86
+ /**
87
+ * Configuration for pressure cloud computation.
88
+ */
89
+ export interface PressureCloudConfig {
90
+ /**
91
+ * Product multiplier for contract conversion.
92
+ * NQ = 20, MNQ = 2, ES = 50, MES = 5, SPY = 100 (shares).
93
+ * Default: 20 (NQ)
94
+ */
95
+ contractMultiplier?: number;
96
+ /** Product type hint for primary contract display. Default: 'NQ' */
97
+ product?: 'NQ' | 'MNQ' | 'ES' | 'MES' | 'SPY';
98
+ /**
99
+ * How many expected-daily-moves to consider "reachable".
100
+ * Levels beyond this get heavily penalized. Default: 2.0
101
+ */
102
+ reachabilityMultiple?: number;
103
+ /**
104
+ * Minimum impulse magnitude (as fraction of mean abs impulse) to
105
+ * qualify as a zone. Default: 0.15
106
+ */
107
+ zoneThreshold?: number;
108
+ }
109
+ /**
110
+ * Complete pressure cloud analysis combining stability and acceleration zones.
111
+ */
112
+ export interface PressureCloud {
113
+ /** Current spot price */
114
+ spot: number;
115
+ /** Expiration timestamp */
116
+ expiration: number;
117
+ /** Timestamp when this cloud was computed */
118
+ computedAt: number;
119
+ /**
120
+ * Stability zones: levels where positive dealer impulse creates
121
+ * mean-reverting pressure. Price decelerates into these zones.
122
+ * Trade approach: reversal / bounce entries.
123
+ */
124
+ stabilityZones: PressureZone[];
125
+ /**
126
+ * Acceleration zones: levels where negative dealer impulse creates
127
+ * trend-amplifying pressure. Price accelerates through these zones.
128
+ * Trade approach: momentum / breakout continuation.
129
+ */
130
+ accelerationZones: PressureZone[];
131
+ /**
132
+ * Regime edges: prices where the impulse curve crosses zero,
133
+ * marking transitions between mean-reverting and trend-amplifying behavior.
134
+ */
135
+ regimeEdges: RegimeEdge[];
136
+ /**
137
+ * Per-price-level detail for the full chart overlay.
138
+ * Every point on the impulse curve grid, enriched with scores and contract estimates.
139
+ */
140
+ priceLevels: PressureLevel[];
141
+ }
142
+ /**
143
+ * Compute a pressure cloud from an existing hedge impulse curve.
144
+ *
145
+ * The pressure cloud translates the raw impulse curve into actionable
146
+ * trading zones:
147
+ *
148
+ * - **Stability zones** (positive impulse peaks, weighted by proximity):
149
+ * Where dealer hedging creates counter-trend flow. These are bounce/rejection
150
+ * targets — price decelerates into them and often stalls or reverses.
151
+ *
152
+ * - **Acceleration zones** (negative impulse troughs, weighted by proximity):
153
+ * Where dealer hedging creates with-trend flow. If price reaches these levels,
154
+ * dealers amplify the move. These are momentum/breakout zones — price
155
+ * accelerates through them.
156
+ *
157
+ * - **Regime edges** (zero crossings):
158
+ * Where behavior flips. Critical for understanding "if price breaks past X,
159
+ * the character of the tape changes."
160
+ *
161
+ * @param impulseCurve - A previously computed hedge impulse curve
162
+ * @param regimeParams - Regime parameters (for expected daily move / reachability)
163
+ * @param config - Optional tuning parameters
164
+ * @returns Complete pressure cloud analysis
165
+ */
166
+ export declare function computePressureCloud(impulseCurve: HedgeImpulseCurve, regimeParams: RegimeParams, config?: PressureCloudConfig): PressureCloud;
@@ -0,0 +1,243 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.computePressureCloud = computePressureCloud;
4
+ /** Product multipliers for contract conversion */
5
+ const PRODUCT_MULTIPLIERS = {
6
+ NQ: 20,
7
+ MNQ: 2,
8
+ ES: 50,
9
+ MES: 5,
10
+ };
11
+ /**
12
+ * Convert a dollar impulse value to hedge contracts for a given product multiplier.
13
+ * contracts = impulse / (multiplier * spot * 0.01)
14
+ */
15
+ function impulseToContracts(impulse, multiplier, spot) {
16
+ const denominator = multiplier * spot * 0.01;
17
+ return denominator > 0 ? sanitize(impulse / denominator) : 0;
18
+ }
19
+ /**
20
+ * Compute multi-product hedge contract estimates from a dollar impulse value.
21
+ */
22
+ function computeHedgeContractEstimates(impulse, spot) {
23
+ return {
24
+ nq: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.NQ, spot),
25
+ mnq: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.MNQ, spot),
26
+ es: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.ES, spot),
27
+ mes: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.MES, spot),
28
+ };
29
+ }
30
+ // ============================================================================
31
+ // Implementation
32
+ // ============================================================================
33
+ /**
34
+ * Compute a pressure cloud from an existing hedge impulse curve.
35
+ *
36
+ * The pressure cloud translates the raw impulse curve into actionable
37
+ * trading zones:
38
+ *
39
+ * - **Stability zones** (positive impulse peaks, weighted by proximity):
40
+ * Where dealer hedging creates counter-trend flow. These are bounce/rejection
41
+ * targets — price decelerates into them and often stalls or reverses.
42
+ *
43
+ * - **Acceleration zones** (negative impulse troughs, weighted by proximity):
44
+ * Where dealer hedging creates with-trend flow. If price reaches these levels,
45
+ * dealers amplify the move. These are momentum/breakout zones — price
46
+ * accelerates through them.
47
+ *
48
+ * - **Regime edges** (zero crossings):
49
+ * Where behavior flips. Critical for understanding "if price breaks past X,
50
+ * the character of the tape changes."
51
+ *
52
+ * @param impulseCurve - A previously computed hedge impulse curve
53
+ * @param regimeParams - Regime parameters (for expected daily move / reachability)
54
+ * @param config - Optional tuning parameters
55
+ * @returns Complete pressure cloud analysis
56
+ */
57
+ function computePressureCloud(impulseCurve, regimeParams, config = {}) {
58
+ const { contractMultiplier = 20, // NQ default
59
+ reachabilityMultiple = 2.0, zoneThreshold = 0.15, } = config;
60
+ const { spot, curve, extrema, zeroCrossings } = impulseCurve;
61
+ const expectedMove = regimeParams.expectedDailySpotMove * spot;
62
+ // Compute reachability-weighted scores for each price level
63
+ const priceLevels = computePriceLevels(curve, spot, expectedMove, reachabilityMultiple, contractMultiplier);
64
+ // Extract stability zones from positive impulse peaks
65
+ const stabilityZones = extractStabilityZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold);
66
+ // Extract acceleration zones from negative impulse troughs
67
+ const accelerationZones = extractAccelerationZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold);
68
+ // Convert zero crossings to regime edges
69
+ const regimeEdges = convertZeroCrossingsToEdges(zeroCrossings, spot);
70
+ return {
71
+ spot,
72
+ expiration: impulseCurve.expiration,
73
+ computedAt: Date.now(),
74
+ stabilityZones,
75
+ accelerationZones,
76
+ regimeEdges,
77
+ priceLevels,
78
+ };
79
+ }
80
+ /**
81
+ * Compute per-price-level detail from the impulse curve.
82
+ */
83
+ function computePriceLevels(curve, spot, expectedMove, reachabilityMultiple, contractMultiplier) {
84
+ const reachRange = expectedMove * reachabilityMultiple;
85
+ return curve.map((point) => {
86
+ const distance = Math.abs(point.price - spot);
87
+ const proximity = Math.exp(-((distance / reachRange) ** 2));
88
+ // Stability: positive impulse weighted by proximity
89
+ const stabilityScore = point.impulse > 0
90
+ ? point.impulse * proximity
91
+ : 0;
92
+ // Acceleration: negative impulse magnitude weighted by proximity
93
+ const accelerationScore = point.impulse < 0
94
+ ? Math.abs(point.impulse) * proximity
95
+ : 0;
96
+ // Convert dollar impulse to signed contract count.
97
+ // impulse is $ of hedging per 1% move. For contracts per 1 point:
98
+ // contracts = impulse / (contractMultiplier * spot * 0.01)
99
+ const contractDenominator = contractMultiplier * spot * 0.01;
100
+ const expectedHedgeContracts = contractDenominator > 0
101
+ ? point.impulse / contractDenominator
102
+ : 0;
103
+ return {
104
+ price: point.price,
105
+ stabilityScore,
106
+ accelerationScore,
107
+ expectedHedgeContracts: sanitize(expectedHedgeContracts),
108
+ hedgeContracts: computeHedgeContractEstimates(point.impulse, spot),
109
+ hedgeType: point.impulse >= 0 ? 'passive' : 'aggressive',
110
+ };
111
+ });
112
+ }
113
+ /**
114
+ * Extract stability zones from positive impulse peaks (basins).
115
+ */
116
+ function extractStabilityZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold) {
117
+ const basins = extrema.filter((e) => e.type === 'basin');
118
+ if (basins.length === 0)
119
+ return [];
120
+ const reachRange = expectedMove * reachabilityMultiple;
121
+ const maxImpulse = Math.max(...basins.map((b) => Math.abs(b.impulse)), 1e-10);
122
+ // Filter by threshold
123
+ const significant = basins.filter((b) => Math.abs(b.impulse) / maxImpulse >= zoneThreshold);
124
+ // Build zones
125
+ const zones = significant.map((basin) => {
126
+ const proximity = Math.exp(-((Math.abs(basin.price - spot) / reachRange) ** 2));
127
+ const rawStrength = (Math.abs(basin.impulse) / maxImpulse) * proximity;
128
+ // Find zone width: where impulse drops to 50% of peak
129
+ const halfPeak = basin.impulse * 0.5;
130
+ const { lower, upper } = findZoneBounds(curve, basin.price, halfPeak);
131
+ const side = basin.price >= spot ? 'above-spot' : 'below-spot';
132
+ const tradeType = side === 'below-spot' ? 'long' : 'short';
133
+ return {
134
+ center: basin.price,
135
+ lower,
136
+ upper,
137
+ strength: Math.min(1, rawStrength),
138
+ side,
139
+ tradeType,
140
+ hedgeType: 'passive',
141
+ };
142
+ });
143
+ // Sort by strength descending
144
+ return zones.sort((a, b) => b.strength - a.strength);
145
+ }
146
+ /**
147
+ * Extract acceleration zones from negative impulse troughs (peaks in the type system).
148
+ */
149
+ function extractAccelerationZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold) {
150
+ const peaks = extrema.filter((e) => e.type === 'peak');
151
+ if (peaks.length === 0)
152
+ return [];
153
+ const reachRange = expectedMove * reachabilityMultiple;
154
+ const maxImpulse = Math.max(...peaks.map((p) => Math.abs(p.impulse)), 1e-10);
155
+ const significant = peaks.filter((p) => Math.abs(p.impulse) / maxImpulse >= zoneThreshold);
156
+ const zones = significant.map((peak) => {
157
+ const proximity = Math.exp(-((Math.abs(peak.price - spot) / reachRange) ** 2));
158
+ const rawStrength = (Math.abs(peak.impulse) / maxImpulse) * proximity;
159
+ const halfTrough = peak.impulse * 0.5;
160
+ const { lower, upper } = findZoneBounds(curve, peak.price, halfTrough);
161
+ const side = peak.price >= spot ? 'above-spot' : 'below-spot';
162
+ // Acceleration below spot → momentum short (waterfall)
163
+ // Acceleration above spot → momentum long (squeeze)
164
+ const tradeType = side === 'below-spot' ? 'short' : 'long';
165
+ return {
166
+ center: peak.price,
167
+ lower,
168
+ upper,
169
+ strength: Math.min(1, rawStrength),
170
+ side,
171
+ tradeType,
172
+ hedgeType: 'aggressive',
173
+ };
174
+ });
175
+ return zones.sort((a, b) => b.strength - a.strength);
176
+ }
177
+ /**
178
+ * Find the price bounds where impulse drops to the given threshold
179
+ * around a peak/trough center price.
180
+ */
181
+ function findZoneBounds(curve, centerPrice, thresholdImpulse) {
182
+ // Find the center index
183
+ let centerIdx = 0;
184
+ let minDist = Infinity;
185
+ for (let i = 0; i < curve.length; i++) {
186
+ const d = Math.abs(curve[i].price - centerPrice);
187
+ if (d < minDist) {
188
+ minDist = d;
189
+ centerIdx = i;
190
+ }
191
+ }
192
+ const isPositive = thresholdImpulse > 0;
193
+ // Scan left for lower bound
194
+ let lowerIdx = centerIdx;
195
+ for (let i = centerIdx - 1; i >= 0; i--) {
196
+ if (isPositive ? curve[i].impulse < thresholdImpulse : curve[i].impulse > thresholdImpulse) {
197
+ lowerIdx = i;
198
+ break;
199
+ }
200
+ lowerIdx = i;
201
+ }
202
+ // Scan right for upper bound
203
+ let upperIdx = centerIdx;
204
+ for (let i = centerIdx + 1; i < curve.length; i++) {
205
+ if (isPositive ? curve[i].impulse < thresholdImpulse : curve[i].impulse > thresholdImpulse) {
206
+ upperIdx = i;
207
+ break;
208
+ }
209
+ upperIdx = i;
210
+ }
211
+ return {
212
+ lower: curve[lowerIdx].price,
213
+ upper: curve[upperIdx].price,
214
+ };
215
+ }
216
+ /**
217
+ * Convert impulse zero crossings into regime edge descriptors.
218
+ */
219
+ function convertZeroCrossingsToEdges(crossings, spot) {
220
+ return crossings.map((crossing) => {
221
+ // A "falling" crossing means impulse goes from positive to negative.
222
+ // If this is below spot, moving down into it means going from
223
+ // stable (positive impulse) to unstable (negative impulse).
224
+ // If above spot, it's the reverse perspective.
225
+ const isBelow = crossing.price < spot;
226
+ let transitionType;
227
+ if (crossing.direction === 'falling') {
228
+ // Impulse goes + → -
229
+ transitionType = isBelow ? 'stable-to-unstable' : 'unstable-to-stable';
230
+ }
231
+ else {
232
+ // Impulse goes - → +
233
+ transitionType = isBelow ? 'unstable-to-stable' : 'stable-to-unstable';
234
+ }
235
+ return {
236
+ price: crossing.price,
237
+ transitionType,
238
+ };
239
+ });
240
+ }
241
+ function sanitize(value) {
242
+ return isFinite(value) && !isNaN(value) ? value : 0;
243
+ }
package/dist/index.d.ts CHANGED
@@ -14,8 +14,8 @@ export { buildOCCSymbol, parseOCCSymbol, generateStrikesAroundSpot, generateOCCS
14
14
  export type { OCCSymbolParams, ParsedOCCSymbol, StrikeGenerationParams, } from './utils/occ';
15
15
  export { estimateImpliedProbabilityDistribution, estimateImpliedProbabilityDistributions, getProbabilityInRange, getCumulativeProbability, getQuantile, estimateExposureAdjustedPDF, getEdgeAtPrice, getSignificantAdjustmentLevels, DEFAULT_ADJUSTMENT_CONFIG, LOW_VOL_CONFIG, CRISIS_CONFIG, OPEX_CONFIG, } from './impliedpdf';
16
16
  export type { StrikeProbability, ImpliedProbabilityDistribution, ImpliedPDFResult, ExposureAdjustmentConfig, AdjustedPDFResult, PDFComparison, } from './impliedpdf';
17
- export { deriveRegimeParams, interpolateIVAtStrike, computeHedgeImpulseCurve, computeCharmIntegral, analyzeHedgeFlow, } from './hedgeflow';
18
- export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, } from './hedgeflow';
17
+ export { deriveRegimeParams, interpolateIVAtStrike, computeHedgeImpulseCurve, computeCharmIntegral, computePressureCloud, analyzeHedgeFlow, } from './hedgeflow';
18
+ export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, HedgeContractEstimates, PressureZone, RegimeEdge, PressureLevel, PressureCloudConfig, PressureCloud, } from './hedgeflow';
19
19
  export { FloeClient, Broker } from './client/FloeClient';
20
20
  export { TradierClient } from './client/brokers/TradierClient';
21
21
  export { TastyTradeClient } from './client/brokers/TastyTradeClient';
package/dist/index.js CHANGED
@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
20
20
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
21
21
  };
22
22
  Object.defineProperty(exports, "__esModule", { value: true });
23
- exports.computeRealizedVolatility = exports.computeImpliedVolatility = exports.computeVarianceSwapIV = exports.createOptionChain = exports.getAdapter = exports.brokerAdapters = exports.tdaAdapter = exports.ibkrAdapter = exports.schwabAdapter = exports.genericAdapter = exports.TradeStationClient = exports.TastyTradeClient = exports.TradierClient = exports.Broker = exports.FloeClient = exports.analyzeHedgeFlow = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = exports.OPEX_CONFIG = exports.CRISIS_CONFIG = exports.LOW_VOL_CONFIG = exports.DEFAULT_ADJUSTMENT_CONFIG = exports.getSignificantAdjustmentLevels = exports.getEdgeAtPrice = exports.estimateExposureAdjustedPDF = exports.getQuantile = exports.getCumulativeProbability = exports.getProbabilityInRange = exports.estimateImpliedProbabilityDistributions = exports.estimateImpliedProbabilityDistribution = exports.generateOCCSymbolsAroundSpot = exports.generateOCCSymbolsForStrikes = exports.generateStrikesAroundSpot = exports.parseOCCSymbol = exports.buildOCCSymbol = exports.normalPDF = exports.cumulativeNormalDistribution = exports.calculateSharesNeededToCover = exports.calculateGammaVannaCharmExposures = exports.smoothTotalVarianceSmile = exports.getIVForStrike = exports.getIVSurfaces = exports.getTimeToExpirationInYears = exports.getMillisecondsToExpiration = exports.calculateImpliedVolatility = exports.calculateGreeks = exports.blackScholes = void 0;
23
+ exports.computeRealizedVolatility = exports.computeImpliedVolatility = exports.computeVarianceSwapIV = exports.createOptionChain = exports.getAdapter = exports.brokerAdapters = exports.tdaAdapter = exports.ibkrAdapter = exports.schwabAdapter = exports.genericAdapter = exports.TradeStationClient = exports.TastyTradeClient = exports.TradierClient = exports.Broker = exports.FloeClient = exports.analyzeHedgeFlow = exports.computePressureCloud = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = exports.OPEX_CONFIG = exports.CRISIS_CONFIG = exports.LOW_VOL_CONFIG = exports.DEFAULT_ADJUSTMENT_CONFIG = exports.getSignificantAdjustmentLevels = exports.getEdgeAtPrice = exports.estimateExposureAdjustedPDF = exports.getQuantile = exports.getCumulativeProbability = exports.getProbabilityInRange = exports.estimateImpliedProbabilityDistributions = exports.estimateImpliedProbabilityDistribution = exports.generateOCCSymbolsAroundSpot = exports.generateOCCSymbolsForStrikes = exports.generateStrikesAroundSpot = exports.parseOCCSymbol = exports.buildOCCSymbol = exports.normalPDF = exports.cumulativeNormalDistribution = exports.calculateSharesNeededToCover = exports.calculateGammaVannaCharmExposures = exports.smoothTotalVarianceSmile = exports.getIVForStrike = exports.getIVSurfaces = exports.getTimeToExpirationInYears = exports.getMillisecondsToExpiration = exports.calculateImpliedVolatility = exports.calculateGreeks = exports.blackScholes = void 0;
24
24
  // Core types
25
25
  __exportStar(require("./types"), exports);
26
26
  // Black-Scholes pricing and Greeks
@@ -67,7 +67,7 @@ Object.defineProperty(exports, "DEFAULT_ADJUSTMENT_CONFIG", { enumerable: true,
67
67
  Object.defineProperty(exports, "LOW_VOL_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.LOW_VOL_CONFIG; } });
68
68
  Object.defineProperty(exports, "CRISIS_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.CRISIS_CONFIG; } });
69
69
  Object.defineProperty(exports, "OPEX_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.OPEX_CONFIG; } });
70
- // Hedge flow analysis (impulse curve, charm integral, regime derivation)
70
+ // Hedge flow analysis (impulse curve, charm integral, regime derivation, pressure cloud)
71
71
  var hedgeflow_1 = require("./hedgeflow");
72
72
  // Regime derivation from IV surface
73
73
  Object.defineProperty(exports, "deriveRegimeParams", { enumerable: true, get: function () { return hedgeflow_1.deriveRegimeParams; } });
@@ -76,6 +76,8 @@ Object.defineProperty(exports, "interpolateIVAtStrike", { enumerable: true, get:
76
76
  Object.defineProperty(exports, "computeHedgeImpulseCurve", { enumerable: true, get: function () { return hedgeflow_1.computeHedgeImpulseCurve; } });
77
77
  // Charm integral
78
78
  Object.defineProperty(exports, "computeCharmIntegral", { enumerable: true, get: function () { return hedgeflow_1.computeCharmIntegral; } });
79
+ // Pressure cloud (stability/acceleration zones)
80
+ Object.defineProperty(exports, "computePressureCloud", { enumerable: true, get: function () { return hedgeflow_1.computePressureCloud; } });
79
81
  // Combined analysis
80
82
  Object.defineProperty(exports, "analyzeHedgeFlow", { enumerable: true, get: function () { return hedgeflow_1.analyzeHedgeFlow; } });
81
83
  // Client
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fullstackcraftllc/floe",
3
- "version": "0.0.16",
3
+ "version": "0.0.17",
4
4
  "description": "Production-ready options analytics toolkit. Normalize broker data structures and calculate Black-Scholes, Greeks, and exposures with a clean, type-safe API. Built for trading platforms and fintech applications.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -8,7 +8,9 @@
8
8
  "build": "tsc",
9
9
  "test": "jest",
10
10
  "prepublishOnly": "npm run build",
11
- "type-check": "tsc --noEmit"
11
+ "type-check": "tsc --noEmit",
12
+ "prepare": "husky",
13
+ "copy-whitepaper": "cp whitepaper/whitepaper.pdf site/public/whitepaper.pdf"
12
14
  },
13
15
  "keywords": [
14
16
  "options",
@@ -42,6 +44,7 @@
42
44
  "@types/jest": "^29.5.0",
43
45
  "@types/node": "^20.0.0",
44
46
  "dotenv": "^17.2.3",
47
+ "husky": "^9.1.7",
45
48
  "jest": "^29.5.0",
46
49
  "ts-jest": "^29.1.0",
47
50
  "typescript": "^5.9.3"