openalgo-script 0.1.0-alpha.1 → 0.4.0

package/dist/core/backtest/simulate.js

@@ -0,0 +1,217 @@
+import { testResting } from './resting.js';
+/** `language.md` 13.3: a market order priced at the close of its own bar. */
+const AT_CLOSE = 'close';
+/**
+ * A venue, for one run.
+ *
+ * It holds the orders it was handed and nothing else: no position, no money and
+ * no view of what the strategy is doing, because a destination has none of
+ * those about somebody else's strategy.
+ */
+export class Simulator {
+    options;
+    orders = [];
+    /** The intents handed over, in the order they were, whatever became of them. */
+    intents = [];
+    /** Brackets, held so that a run can say how many it was handed and answered. */
+    brackets = [];
+    queued = [];
+    answered = [];
+    refs = 0;
+    seq = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Step 9: what the strategy decided reaches the venue. */
+    route(effect, barIndex) {
+        for (const intent of effect.intents) {
+            this.intents.push(intent);
+            if (intent.kind === 'bracket') {
+                this.brackets.push(intent);
+                continue;
+            }
+            if (intent.kind === 'cancel') {
+                this.withdraw(intent, barIndex);
+                continue;
+            }
+            this.accept(intent, barIndex);
+        }
+    }
+    /**
+     * The frames a boundary hands over: everything this venue can say now.
+     *
+     * The orders that were already resting are decided against this bar first and
+     * the orders this bar sent are answered after, which is the order the venue
+     * learned of them in.
+     */
+    framesFor(barIndex) {
+        const bar = this.options.bars[barIndex];
+        if (bar !== undefined) {
+            for (const order of this.orders) {
+                if (!order.live || order.rest === null || order.placedOn >= barIndex)
+                    continue;
+                this.decide(order, bar, barIndex);
+            }
+        }
+        const sent = this.queued;
+        this.queued = [];
+        for (const order of sent)
+            this.open(order, barIndex);
+        const out = this.answered;
+        this.answered = [];
+        return out;
+    }
+    /** How many orders this venue is still holding, which a run reports. */
+    get working() {
+        return this.orders.filter((order) => order.live).length;
+    }
+    /** An order the strategy sent, which this venue now holds. */
+    accept(intent, barIndex) {
+        this.refs += 1;
+        const order = {
+            intent,
+            ref: refOf(this.refs),
+            placedOn: barIndex,
+            rest: restingFor(intent),
+            filledQty: 0,
+            live: true,
+            triggered: false,
+        };
+        this.orders.push(order);
+        this.queued.push(order);
+    }
+    /**
+     * A cancellation, which is about the orders a tag names and not about itself.
+     *
+     * Every live order carrying the tag is withdrawn and answered, which is what
+     * releases the position they were claiming, and the cancellation is then
+     * answered as an order of its own, because the engine appended a row for it
+     * and a row nothing ever answers stays at `placed` for the life of the run.
+     */
+    withdraw(intent, barIndex) {
+        for (const order of this.orders) {
+            if (!order.live || order.intent.tag !== intent.tag)
+                continue;
+            order.live = false;
+            this.say(order.intent, order.ref, 'cancelled', order.filledQty, null, barIndex);
+        }
+        // The cancellation is confirmed after what it withdrew, which is the order
+        // a venue does it in: the request is answered once it has been carried out.
+        this.refs += 1;
+        this.say(intent, refOf(this.refs), 'cancelled', 0, null, barIndex);
+    }
+    /**
+     * The first thing a venue says about an order it has taken.
+     *
+     * A working frame before any fill, because 7.4 asks for a frame on every
+     * change of status and a script waiting for a working order to clear waits
+     * blind without one. A market order is then filled in the same breath where
+     * the declaration prices it at this bar's close, and at the next bar's open
+     * where it does not.
+     */
+    open(order, barIndex) {
+        this.say(order.intent, order.ref, 'working', 0, null, barIndex);
+        if (order.rest !== null)
+            return;
+        const atClose = this.options.fillOn === AT_CLOSE;
+        const bar = this.options.bars[atClose ? barIndex : barIndex + 1];
+        const price = atClose ? (bar?.close ?? null) : (bar?.open ?? null);
+        // A market order sent on the last bar of a run and priced at the next open
+        // has no next open. It stays working and is reported as an order the run
+        // ended holding, which is what it is.
+        if (price === null)
+            return;
+        this.complete(order, this.worsen(price, order.intent.side), barIndex);
+    }
+    /** One resting order against one bar. */
+    decide(order, bar, barIndex) {
+        const rest = order.rest;
+        if (rest === null)
+            return;
+        const outcome = testResting(order.triggered ? asLimit(rest) : rest, bar, this.options.fill);
+        if (!outcome.filled) {
+            if (outcome.triggered)
+                order.triggered = true;
+            return;
+        }
+        const price = outcome.slips ? this.worsen(outcome.price, order.intent.side) : outcome.price;
+        this.complete(order, price, barIndex);
+    }
+    /**
+     * The whole of an order, filled at one price.
+     *
+     * **The quantity is converted into units here, because that is what a fill
+     * is counted in and what every money figure is folded over.** A quantity
+     * travels in the declaration's own unit (`host-interface.md` 7.1) and the
+     * destination is the party that converts it. This filled the number verbatim,
+     * so a strategy sizing in lots on a lot of sixty five traded one sixty fifth
+     * of what it asked for and the whole report was out by that factor. The units
+     * this destination cannot arrive at are refused before the first bar rather
+     * than guessed at here, so by this point the unit is one of two.
+     */
+    complete(order, price, barIndex) {
+        const stated = order.intent.qty ?? 0;
+        const lot = this.options.contract.lotSize;
+        const qty = this.options.qtyType === 'lots' && lot !== null && lot > 0 ? stated * lot : stated;
+        order.filledQty = qty;
+        order.live = false;
+        this.say(order.intent, order.ref, 'filled', qty, price, barIndex);
+    }
+    /**
+     * A price worsened by the slippage the run was carried out under.
+     *
+     * **Adverse always: a buy pays more and a sell receives less.** The sign is
+     * taken as written rather than as a magnitude, because a slippage below zero
+     * is refused before the first bar and taking its magnitude here would be this
+     * function quietly covering for a hole in that refusal. It went uncovered for
+     * a while: `scheduleProblem` has always refused a negative rate, and
+     * `checkSettings` asked it only about a schedule the host supplied, so a
+     * declaration stating a slippage of minus one improved both sides of every
+     * fill and the backtest paid the strategy to trade.
+     *
+     * A slippage in ticks with no tick size to measure a tick in charges nothing.
+     * The comment here once said that was refused before the first bar and it was
+     * not; it still is not, because an instrument with no tick is a fact a host
+     * may legitimately not hold, and a run that charges no slippage is a study
+     * before slippage rather than a wrong answer. What has changed is that this
+     * says so instead of claiming a refusal that never existed.
+     */
+    worsen(price, side) {
+        const tick = this.options.contract.tickSize;
+        if (tick === null || this.options.slippageTicks === 0)
+            return price;
+        const move = this.options.slippageTicks * tick;
+        return side === 'sell' ? price - move : price + move;
+    }
+    /** One frame, cumulative, in the order this venue spoke. */
+    say(intent, ref, status, filledQty, avgFillPrice, barIndex) {
+        this.seq += 1;
+        this.answered.push({
+            intentId: intent.intentId,
+            status,
+            filledQty,
+            avgFillPrice,
+            orderRef: ref,
+            sentInstrument: intent.instrument,
+            sentProduct: intent.product,
+            time: this.options.bars[barIndex]?.time ?? null,
+            text: '',
+            seq: this.seq,
+        });
+    }
+}
+/** This venue's own reference for an order, which the engine records and never parses. */
+function refOf(count) {
+    return 'ORD-' + String(count);
+}
+/** The resting order an intent is, or nothing where it is a market order. */
+function restingFor(intent) {
+    if (intent.type === null || intent.type === 'market' || intent.side === null)
+        return null;
+    return { side: intent.side, type: intent.type, limit: intent.limit, trigger: intent.trigger };
+}
+/** A stop limit that has triggered, which is a limit from that moment on. */
+function asLimit(rest) {
+    return { side: rest.side, type: 'limit', limit: rest.limit, trigger: null };
+}
+//# sourceMappingURL=simulate.js.map

package/dist/core/backtest/simulate.js.map

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

package/dist/core/catalogue/catalogue.generated.d.ts

@@ -360,7 +360,7 @@ export declare const ENTRIES: {
         readonly since: 1;
         readonly autofix: false;
         readonly message: "{leftType} and {rightType} do not mix here.";
-        readonly fix: "Convert explicitly: text(x) for a string, number(s) for a number, bool(x) for a bool, or use a separate name for the second value. A plot, fill or level handle converts to nothing: leave it named at the top level, pass it to fill(), and use draw.line() or draw.box() where the script needs something it can keep.";
+        readonly fix: "Convert explicitly: text(x) for a string, or text(x, decimals) to fix the decimals. Where no conversion applies, write the value in the type the line needs, or give the second value a name of its own. A plot, fill or level handle converts to nothing: leave it named at the top level, pass it to fill(), and use draw.line() or draw.box() where the script needs something it can keep.";
         readonly placeholders: readonly ["leftType", "rightType"];
     };
     readonly OS2004: {
@@ -371,7 +371,7 @@ export declare const ENTRIES: {
         readonly since: 1;
         readonly autofix: false;
         readonly message: "{expr} has no history, so [] cannot read a past value of it.";
-        readonly fix: "Assign the value to a name at the top level of the file, then read that name's history.";
+        readonly fix: "If the value is a per-bar number computed inside a block or left as a temporary, assign it at the top level of the file and read the history of that top level name. If it is a declaration handle, a runtime object or a library fact that is not a series, no name gives it a history: assign what you want to look back at to a top level name of its own, and read that.";
         readonly placeholders: readonly ["expr"];
     };
     readonly OS2005: {
@@ -459,7 +459,7 @@ export declare const ENTRIES: {
         readonly since: 1;
         readonly autofix: false;
         readonly message: "The arms of this ? : are {leftType} and {rightType}.";
-        readonly fix: "Make both arms the same type with text() or number(), or use none for the empty arm.";
+        readonly fix: "Make both arms the same type with text() or toNumber(), or use none for the empty arm.";
         readonly placeholders: readonly ["leftType", "rightType"];
     };
     readonly OS2013: {
@@ -539,6 +539,17 @@ export declare const ENTRIES: {
         readonly fix: "Use an element type an array holds: number, string, bool, color, line, label, box, polyline or table. A plot cannot be kept anywhere, so declare each plot at the top level and give it its own name.";
         readonly placeholders: readonly ["type"];
     };
+    readonly OS2020: {
+        readonly code: "OS2020";
+        readonly title: "Name is planned, not implemented";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "{name} is planned and is not implemented in this version.";
+        readonly fix: "Compute what {name} would give from names the library implements today, or take the line out until a version implements it. Do not reach for the nearest name that compiles: a neighbour computes something else, and a plot that quietly changes meaning is worse than one that refuses to compile.";
+        readonly placeholders: readonly ["name"];
+    };
     readonly OS3001: {
         readonly code: "OS3001";
         readonly title: "Wrong number of arguments";
@@ -657,7 +668,7 @@ export declare const ENTRIES: {
         readonly since: 1;
         readonly autofix: false;
         readonly message: "{name}'s {argument} is {expected}; {found} was given.";
-        readonly fix: "Convert the value with text(), number() or bool(), or pass an expression of type {expected}.";
+        readonly fix: "Convert the value with text(), toNumber() or toBool(), or pass an expression of type {expected}.";
         readonly placeholders: readonly ["name", "argument", "expected", "found"];
     };
     readonly OS3012: {
@@ -759,6 +770,50 @@ export declare const ENTRIES: {
         readonly fix: "Plot both edges at the top level, name each one, and pass the two names to fill().";
         readonly placeholders: readonly ["argument", "found"];
     };
+    readonly OS3021: {
+        readonly code: "OS3021";
+        readonly title: "An input written in place has no title";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "An input() assigned to no name is named by its title, and this one has no title written as a string literal.";
+        readonly fix: "Give it a title written as a string literal: input(2, \"Precision\").";
+        readonly placeholders: readonly [];
+    };
+    readonly OS3022: {
+        readonly code: "OS3022";
+        readonly title: "Two inputs share a settings key";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "This input is keyed by its title {name}, which is already the name of the input at line {line}.";
+        readonly fix: "Give this one a title of its own, or rename the input at line {line}.";
+        readonly placeholders: readonly ["name", "line"];
+    };
+    readonly OS3023: {
+        readonly code: "OS3023";
+        readonly title: "An order names a leg this file does not declare";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "{name} was given a {argument}, and this file declares none.";
+        readonly fix: "Leave {argument} out. A file that declares no leg has exactly one, and every order acts on it.";
+        readonly placeholders: readonly ["name", "argument"];
+    };
+    readonly OS3024: {
+        readonly code: "OS3024";
+        readonly title: "An input written in place has an empty title";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "An input() assigned to no name is named by its title, and this one's title is empty.";
+        readonly fix: "Give the title something to say: input(2, \"Precision\").";
+        readonly placeholders: readonly [];
+    };
     readonly OS4001: {
         readonly code: "OS4001";
         readonly title: "History index is not usable";
@@ -939,7 +994,7 @@ export declare const ENTRIES: {
         readonly code: "OS5004";
         readonly title: "The program needs more state regions than the engine allows";
         readonly severity: "error";
-        readonly stage: "check";
+        readonly stage: "host";
         readonly since: 1;
         readonly autofix: false;
         readonly message: "This program needs {found} state regions and the engine allows {max}; {first} calls {second} on several paths.";
@@ -994,13 +1049,24 @@ export declare const ENTRIES: {
         readonly code: "OS5009";
         readonly title: "The program is too large";
         readonly severity: "error";
-        readonly stage: "check";
+        readonly stage: "host";
         readonly since: 1;
         readonly autofix: false;
         readonly message: "This file compiles to {found} instructions and the ceiling is {max}.";
         readonly fix: "Move the repeated block into a fn and call it, and delete branches the script no longer uses.";
         readonly placeholders: readonly ["found", "max"];
     };
+    readonly OS5010: {
+        readonly code: "OS5010";
+        readonly title: "Too many drawing objects";
+        readonly severity: "error";
+        readonly stage: "runtime";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "A script holds at most {max} drawing objects; this one would be number {found}.";
+        readonly fix: "Delete each object when it stops being wanted, and bound the set: keep the objects in an array, and when it is longer than you want, delete the oldest object and remove the element.";
+        readonly placeholders: readonly ["max", "found"];
+    };
     readonly OS6001: {
         readonly code: "OS6001";
         readonly title: "Unknown timeframe";
@@ -1173,7 +1239,7 @@ export declare const ENTRIES: {
         readonly stage: "host";
         readonly since: 1;
         readonly autofix: false;
-        readonly message: "This program is in compiled format {found} and this engine implements up to {max}.";
+        readonly message: "This program is in compiled format {found} and this engine implements format {max}; a different major number is a different format, whether it is higher or lower.";
         readonly fix: "Run the program on an engine that implements format {found}, or recompile the source with a compiler that emits format {max}.";
         readonly placeholders: readonly ["found", "max"];
     };
@@ -1210,6 +1276,50 @@ export declare const ENTRIES: {
         readonly fix: "Correct the value in the settings dialog, or widen the input's own min, max or options so the value is allowed.";
         readonly placeholders: readonly ["value", "key", "validation"];
     };
+    readonly OS6020: {
+        readonly code: "OS6020";
+        readonly title: "The report window holds no bars";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "The window from {from} to {to} holds none of the {count} bars supplied.";
+        readonly fix: "Widen the window until it covers bars, or supply the bars it covers. Both bounds are inclusive and are compared against the times of the bars supplied rather than against a calendar, so a window that falls inside a gap in the data is empty however wide it looks.";
+        readonly placeholders: readonly ["from", "to", "count"];
+    };
+    readonly OS6021: {
+        readonly code: "OS6021";
+        readonly title: "A run setting cannot be applied as stated";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "{setting} cannot be applied: {problem}.";
+        readonly fix: "State the setting so it can be carried out: declare a charge line after every line it is levied on, supply the tick size a slippage in ticks is measured in, or write down the reason a tolerance needs a bound. Nothing has been computed at the point this is refused, so correcting the setting and running again costs one run.";
+        readonly placeholders: readonly ["setting", "problem"];
+    };
+    readonly OS6022: {
+        readonly code: "OS6022";
+        readonly title: "The bars are not the bars the record was made from";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "The bars supplied hash to {found}, and the record was made from {expected}.";
+        readonly fix: "Replay against the bars the record names. Where the revision is the point, make a second record over the revised bars and compare the two runs, rather than overwriting one run with the other under one name.";
+        readonly placeholders: readonly ["found", "expected"];
+    };
+    readonly OS6023: {
+        readonly code: "OS6023";
+        readonly title: "Two cost models are stated at once";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "A charge schedule was supplied, and the declaration states a commission of {commission} in {commissionType}.";
+        readonly fix: "Supply the schedule and leave the declaration's commission at its default of zero, or state the commission in the declaration and supply no schedule. A schedule is the one of the two that can carry a floor, a cap, a charge levied on a charge, and a cost that falls on one side of the trade only.";
+        readonly placeholders: readonly ["commission", "commissionType"];
+    };
     readonly OS7001: {
         readonly code: "OS7001";
         readonly title: "Only a strategy can do that";
@@ -1306,7 +1416,7 @@ export declare const ENTRIES: {
         readonly since: 1;
         readonly autofix: false;
         readonly message: "There is no working order tagged {tag}.";
-        readonly fix: "Use the tag the order was placed with, and test order.working({tag}) before acting on it.";
+        readonly fix: "Use the tag the order was placed with, or cancelAll() where the script means every order it has working.";
         readonly placeholders: readonly ["tag"];
     };
     readonly OS7010: {
@@ -1375,6 +1485,50 @@ export declare const ENTRIES: {
         readonly fix: "Connect a destination in the host, or run the file as a study(): replace buy() with signal(\"BUY\").";
         readonly placeholders: readonly [];
     };
+    readonly OS7016: {
+        readonly code: "OS7016";
+        readonly title: "A close names a tag nothing places";
+        readonly severity: "error";
+        readonly stage: "check";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "No order in this file is placed with the tag {tag}.";
+        readonly fix: "Use the tag the entry was placed with, or leave the tag out to flatten the whole leg.";
+        readonly placeholders: readonly ["tag"];
+    };
+    readonly OS7017: {
+        readonly code: "OS7017";
+        readonly title: "A close states more than it is closing";
+        readonly severity: "error";
+        readonly stage: "runtime";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "close was given a quantity of {qty}, and {part} has {held} left to close.";
+        readonly fix: "Leave the quantity out and close() flattens what is left, or size the part from pos.size and keep the quantity at or under {held}.";
+        readonly placeholders: readonly ["qty", "part", "held"];
+    };
+    readonly OS7018: {
+        readonly code: "OS7018";
+        readonly title: "A frame names an order this strategy did not place";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "The frame names intent {intent}, and this strategy holds no such order.";
+        readonly fix: "Answer with the intent id the engine sent. A destination's own reference is carried in the frame's reference field, where the engine records it and never parses it, and it is not what an answer is addressed by.";
+        readonly placeholders: readonly ["intent"];
+    };
+    readonly OS7019: {
+        readonly code: "OS7019";
+        readonly title: "A fill was reported with no price";
+        readonly severity: "error";
+        readonly stage: "host";
+        readonly since: 1;
+        readonly autofix: false;
+        readonly message: "The frame reports {qty} filled for intent {intent}, and no average fill price.";
+        readonly fix: "Report the average fill price the destination computed over the cumulative quantity, on every frame that reports a quantity greater than the last one. A frame carrying no new quantity needs no price.";
+        readonly placeholders: readonly ["qty", "intent"];
+    };
     readonly OS8001: {
         readonly code: "OS8001";
         readonly title: "A stateful call inside a branch";
@@ -1454,12 +1608,12 @@ export declare const ENTRIES: {
     };
     readonly OS8008: {
         readonly code: "OS8008";
-        readonly title: "An alert with no id";
+        readonly title: "An alert with no fixed id";
         readonly severity: "warning";
         readonly stage: "check";
         readonly since: 1;
         readonly autofix: false;
-        readonly message: "This alert has no id, so its identity is derived from its position at line {line}.";
+        readonly message: "This alert has no fixed id, so its identity is derived from its position at line {line}.";
         readonly fix: "Give the alert a stable id of your own: alert(\"text\", id = \"emaCross\").";
         readonly placeholders: readonly ["line"];
     };

package/dist/core/catalogue/catalogue.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalogue.generated.d.ts","sourceRoot":"","sources":["../../../src/core/catalogue/catalogue.generated.ts"],"names":[],"mappings":"AAQA,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,+FAA+F;AAC/F,eAAO,MAAM,YAAY;;;;;;CAM2B,CAAC;AAErD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgJyC,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,OAAO,CAAC"}
+{"version":3,"file":"catalogue.generated.d.ts","sourceRoot":"","sources":["../../../src/core/catalogue/catalogue.generated.ts"],"names":[],"mappings":"AAQA,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,+FAA+F;AAC/F,eAAO,MAAM,YAAY;;;;;;CAM2B,CAAC;AAErD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8JyC,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,OAAO,CAAC"}