@teleporthq/teleport-plugin-next-data-source 0.43.75 → 0.44.1

package/dist/esm/range-control.js

@@ -0,0 +1,137 @@
+import * as types from '@babel/types';
+import { DEFAULT_RANGE_TEMPLATE, PAGINATION_CONTROL_ATTR, RANGE_TEMPLATE_ATTR, readJSXAttributeString, } from './pagination-controls';
+var PLACEHOLDER = /\{(from|to|total)\}/g;
+var total = function (vars) { return types.identifier(vars.totalVar); };
+var page = function (vars) {
+    return types.cloneNode(vars.currentPageExpr, true);
+};
+/** `total === 0 ? 0 : <firstRow>` */
+var unlessEmpty = function (vars, firstRow) {
+    return types.conditionalExpression(types.binaryExpression('===', total(vars), types.numericLiteral(0)), types.numericLiteral(0), firstRow);
+};
+var buildFrom = function (vars) {
+    return unlessEmpty(vars, vars.infiniteScroll
+        ? types.numericLiteral(1)
+        : types.binaryExpression('+', types.binaryExpression('*', types.binaryExpression('-', page(vars), types.numericLiteral(1)), types.numericLiteral(vars.perPage)), types.numericLiteral(1)));
+};
+/** `Math.min(page * perPage, total)` */
+var buildTo = function (vars) {
+    return types.callExpression(types.memberExpression(types.identifier('Math'), types.identifier('min')), [
+        types.binaryExpression('*', page(vars), types.numericLiteral(vars.perPage)),
+        total(vars),
+    ]);
+};
+var buildNumber = function (placeholder, vars) {
+    var value = placeholder === 'from' ? buildFrom(vars) : placeholder === 'to' ? buildTo(vars) : total(vars);
+    return types.callExpression(types.memberExpression(value, types.identifier('toLocaleString')), [
+        types.stringLiteral('en-US'),
+    ]);
+};
+var templateElement = function (text, tail) {
+    return types.templateElement({ raw: text.replace(/\\|`|\$\{/g, function (match) { return "\\".concat(match); }), cooked: text }, tail);
+};
+/**
+ * The JSX printer writes a brace inside a static attribute as `&#123;` /
+ * `&#125;` so it is never read as an expression; the placeholders are braces,
+ * so the template is read back through that escaping.
+ */
+var decodeBraces = function (text) {
+    return text
+        .replace(/&#123;|&#x7b;|&lbrace;/gi, '{')
+        .replace(/&#125;|&#x7d;|&rbrace;/gi, '}')
+        .replace(/&amp;/g, '&');
+};
+/** The author's template as a template literal, each placeholder a live number. */
+var buildLiveText = function (template, vars) {
+    var quasis = [];
+    var expressions = [];
+    var placeholder = new RegExp(PLACEHOLDER.source, 'g');
+    var last = 0;
+    var match = placeholder.exec(template);
+    while (match) {
+        quasis.push(templateElement(template.slice(last, match.index), false));
+        expressions.push(buildNumber(match[1], vars));
+        last = match.index + match[0].length;
+        match = placeholder.exec(template);
+    }
+    quasis.push(templateElement(template.slice(last), true));
+    return types.templateLiteral(quasis, expressions);
+};
+/**
+ * Every `range` control under a component body, in document order. The body is
+ * a `BlockStatement`, so the walk has to cross statements, ternaries and the
+ * `cond && <jsx/>` of a gated section, not only JSX children.
+ */
+export var findRangeControls = function (root) {
+    var found = [];
+    var traverse = function (node) {
+        if (!node || typeof node !== 'object') {
+            return;
+        }
+        if (node.type === 'JSXElement' &&
+            readJSXAttributeString(node, PAGINATION_CONTROL_ATTR) === 'range') {
+            found.push(node);
+        }
+        if (Array.isArray(node.children)) {
+            node.children.forEach(traverse);
+        }
+        if (Array.isArray(node.body)) {
+            node.body.forEach(traverse);
+        }
+        else {
+            traverse(node.body);
+        }
+        traverse(node.consequent);
+        traverse(node.alternate);
+        traverse(node.left);
+        traverse(node.right);
+        traverse(node.test);
+        traverse(node.expression);
+        traverse(node.argument);
+    };
+    traverse(root);
+    return found;
+};
+/**
+ * The element's own children as one expression, so they can be the fallback of
+ * a ternary: plain text becomes a string, anything richer rides along in a
+ * fragment.
+ */
+var drawnText = function (children) {
+    var _a;
+    var texts = [];
+    for (var _i = 0, children_1 = children; _i < children_1.length; _i++) {
+        var child = children_1[_i];
+        if (child.type === 'JSXText') {
+            texts.push(child.value);
+        }
+        else if (child.type === 'JSXExpressionContainer' &&
+            ((_a = child.expression) === null || _a === void 0 ? void 0 : _a.type) === 'StringLiteral') {
+            texts.push(child.expression.value);
+        }
+        else {
+            return types.jsxFragment(types.jsxOpeningFragment(), types.jsxClosingFragment(), children);
+        }
+    }
+    return types.stringLiteral(texts.join('').replace(/\s+/g, ' ').trim());
+};
+/**
+ * `{total === null ? <drawn text> : `<template with live numbers>`}` in place of
+ * the element's children. The marker and template attributes stay on the
+ * element, so the published DOM carries the same contract the canvas reads.
+ */
+export var wireRangeControl = function (node, vars) {
+    var _a;
+    var template = decodeBraces(readJSXAttributeString(node, RANGE_TEMPLATE_ATTR)) || DEFAULT_RANGE_TEMPLATE;
+    var drawn = drawnText(Array.isArray(node.children) ? node.children : []);
+    node.children = [
+        types.jsxExpressionContainer(types.conditionalExpression(types.binaryExpression('===', total(vars), types.nullLiteral()), drawn, buildLiveText(template, vars))),
+    ];
+    if (node.openingElement) {
+        node.openingElement.selfClosing = false;
+    }
+    if (!node.closingElement && ((_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name)) {
+        node.closingElement = types.jsxClosingElement(types.cloneNode(node.openingElement.name, true));
+    }
+};
+//# sourceMappingURL=range-control.js.map

package/dist/esm/range-control.js.map

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

package/dist/esm/row-order.d.ts

@@ -1,7 +1,8 @@
 /**
  * The column that tells a table's rows apart, read from the table the project
- * saved: its primary key, else a column named `id`. The products table has `id`
- * from its first migration. Null when neither is known — then nothing is added,
+ * saved: its primary key, else a column named `id`. The platform listing
+ * tables (products, blog posts, booking items) have `id` from their first
+ * migration. Null when neither is known — then nothing is added,
  * rather than a column that may not exist.
  */
 export declare const rowIdentityColumn: (config: Record<string, unknown>, tableName: string) => string | null;

package/dist/esm/row-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"row-order.d.ts","sourceRoot":"","sources":["../../src/row-order.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,WACpB,OAAO,MAAM,EAAE,OAAO,CAAC,aACpB,MAAM,KAChB,MAAM,GAAG,IAcX,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,mBAAoB,MAAM,GAAG,IAAI,KAAG,MAW9E,CAAA"}
+{"version":3,"file":"row-order.d.ts","sourceRoot":"","sources":["../../src/row-order.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,WACpB,OAAO,MAAM,EAAE,OAAO,CAAC,aACpB,MAAM,KAChB,MAAM,GAAG,IAcX,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,mBAAoB,MAAM,GAAG,IAAI,KAAG,MAW9E,CAAA"}

package/dist/esm/row-order.js

@@ -1,8 +1,9 @@
-import { supportsProductPriceSort } from './product-price-sort';
+import { isListingTableWithId } from './list-sort-order';
 /**
  * The column that tells a table's rows apart, read from the table the project
- * saved: its primary key, else a column named `id`. The products table has `id`
- * from its first migration. Null when neither is known — then nothing is added,
+ * saved: its primary key, else a column named `id`. The platform listing
+ * tables (products, blog posts, booking items) have `id` from their first
+ * migration. Null when neither is known — then nothing is added,
  * rather than a column that may not exist.
  */
 export var rowIdentityColumn = function (config, tableName) {
@@ -15,7 +16,7 @@ export var rowIdentityColumn = function (config, tableName) {
     if (typeof key === 'string') {
         return key;
     }
-    return supportsProductPriceSort(tableName) ? 'id' : null;
+    return isListingTableWithId(tableName) ? 'id' : null;
 };
 /**
  * The `rowOrderTiebreak(fields, direction)` helper a SQL fetcher embeds: what

package/dist/esm/row-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"row-order.js","sourceRoot":"","sources":["../../src/row-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAO/D;;;;;GAKG;AACH,MAAM,CAAC,IAAM,iBAAiB,GAAG,UAC/B,MAA+B,EAC/B,SAAiB;;IAEjB,IAAM,cAAc,GAAI,MAAqE;SAC1F,cAAc,CAAA;IACjB,IAAM,KAAK,GAAG,MAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAG,SAAS,CAAC,0CAAE,OAAO,CAAA;IAClD,IAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAC1E,UAAC,MAAM,IAAK,OAAA,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAA,KAAK,QAAQ,EAAhC,CAAgC,CAC7C,CAAA;IACD,IAAM,GAAG,GACP,MAAA,MAAA,OAAO,CAAC,IAAI,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,YAAY,KAAK,IAAI,EAA5B,CAA4B,CAAC,0CAAE,IAAI,mCAC5D,MAAA,OAAO,CAAC,IAAI,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,IAAI,KAAK,IAAI,EAApB,CAAoB,CAAC,0CAAE,IAAI,CAAA;IACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QAC3B,OAAO,GAAG,CAAA;KACX;IACD,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,IAAM,8BAA8B,GAAG,UAAC,cAA6B;IAC1E,IAAI,CAAC,cAAc,EAAE;QACnB,OAAO,mCAAmC,CAAA;KAC3C;IACD,IAAM,MAAM,GAAG,YAAI,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAG,CAAA;IACxD,OAAO;QACL,iDAAiD;QACjD,4BAAqB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,sBAAY,IAAI,CAAC,SAAS,CAC3E,YAAK,MAAM,MAAG,CACf,iBAAc;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"row-order.js","sourceRoot":"","sources":["../../src/row-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAOxD;;;;;;GAMG;AACH,MAAM,CAAC,IAAM,iBAAiB,GAAG,UAC/B,MAA+B,EAC/B,SAAiB;;IAEjB,IAAM,cAAc,GAAI,MAAqE;SAC1F,cAAc,CAAA;IACjB,IAAM,KAAK,GAAG,MAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAG,SAAS,CAAC,0CAAE,OAAO,CAAA;IAClD,IAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAC1E,UAAC,MAAM,IAAK,OAAA,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAA,KAAK,QAAQ,EAAhC,CAAgC,CAC7C,CAAA;IACD,IAAM,GAAG,GACP,MAAA,MAAA,OAAO,CAAC,IAAI,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,YAAY,KAAK,IAAI,EAA5B,CAA4B,CAAC,0CAAE,IAAI,mCAC5D,MAAA,OAAO,CAAC,IAAI,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,IAAI,KAAK,IAAI,EAApB,CAAoB,CAAC,0CAAE,IAAI,CAAA;IACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QAC3B,OAAO,GAAG,CAAA;KACX;IACD,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AACtD,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,IAAM,8BAA8B,GAAG,UAAC,cAA6B;IAC1E,IAAI,CAAC,cAAc,EAAE;QACnB,OAAO,mCAAmC,CAAA;KAC3C;IACD,IAAM,MAAM,GAAG,YAAI,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAG,CAAA;IACxD,OAAO;QACL,iDAAiD;QACjD,4BAAqB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,sBAAY,IAAI,CAAC,SAAS,CAC3E,YAAK,MAAM,MAAG,CACf,iBAAc;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC,CAAA"}

package/dist/esm/search-input.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The search inputs of a page, and the mapper each one searches.
+ *
+ * Two kinds exist. The platform's own `DataSourceSearchInputNode` renders with
+ * a `search-input` class and is paired with a search-enabled mapper BY ORDER
+ * — the first such input searches the first such mapper. A page's OWN text
+ * input, kept where its author drew it, is marked `data-tq-search-for` with
+ * the node id of the mapper it searches — the marker the editor writes
+ * (`listing-search-field.ts`) and the canvas renderer binds by
+ * (`mapper-search-registry.ts`). Marked inputs are paired by that id and
+ * never take a place in the order, so a template's toolbar box beside a
+ * platform listing shifts nothing.
+ *
+ * Both are wired the same way: controlled by the mapper's search query state,
+ * which the mapper debounces into its fetch and keeps in the address.
+ */
+export declare const SEARCH_FOR_ATTR = "data-tq-search-for";
+export interface SearchInput {
+    node: any;
+    /** The mapper node id a marked input names; undefined for a platform input paired by order. */
+    forNodeId?: string;
+}
+/** Every search input under `root`, in document order. */
+export declare function findAllSearchInputsInJSX(root: any): SearchInput[];
+/**
+ * The search-enabled usage each input searches: a marked input's by the mapper
+ * node id it names, a platform input's by its place among the platform inputs.
+ */
+export declare function pairSearchInputs<Usage extends {
+    searchEnabled: boolean;
+    nodeId?: string;
+}>(inputs: SearchInput[], usages: Usage[]): Map<any, Usage>;
+/**
+ * Controls the input by the mapper's query: `value` reads it, `onChange`
+ * writes it. A marked input may sit inside a form of the page's own; Enter
+ * in it must not submit that form and reload the filtered list away.
+ */
+export declare function wireSearchInput(input: SearchInput, vars: {
+    searchQueryVar: string;
+    setSearchQueryVar: string;
+}): void;
+//# sourceMappingURL=search-input.d.ts.map

package/dist/esm/search-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-input.d.ts","sourceRoot":"","sources":["../../src/search-input.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,eAAe,uBAAuB,CAAA;AAInD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAA;IACT,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAUD,0DAA0D;AAC1D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,EAAE,CAyDjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACxF,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,KAAK,EAAE,GACd,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAmBjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC1D,IAAI,CAuDN"}

package/dist/esm/search-input.js

@@ -0,0 +1,129 @@
+import * as types from '@babel/types';
+import { readJSXAttributeString } from './pagination-controls';
+/**
+ * The search inputs of a page, and the mapper each one searches.
+ *
+ * Two kinds exist. The platform's own `DataSourceSearchInputNode` renders with
+ * a `search-input` class and is paired with a search-enabled mapper BY ORDER
+ * — the first such input searches the first such mapper. A page's OWN text
+ * input, kept where its author drew it, is marked `data-tq-search-for` with
+ * the node id of the mapper it searches — the marker the editor writes
+ * (`listing-search-field.ts`) and the canvas renderer binds by
+ * (`mapper-search-registry.ts`). Marked inputs are paired by that id and
+ * never take a place in the order, so a template's toolbar box beside a
+ * platform listing shifts nothing.
+ *
+ * Both are wired the same way: controlled by the mapper's search query state,
+ * which the mapper debounces into its fetch and keeps in the address.
+ */
+export var SEARCH_FOR_ATTR = 'data-tq-search-for';
+function isInput(node) {
+    var _a, _b;
+    return (node === null || node === void 0 ? void 0 : node.type) === 'JSXElement' && ((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'input';
+}
+function hasSearchInputClass(node) {
+    return readJSXAttributeString(node, 'className').includes('search-input');
+}
+/** Every search input under `root`, in document order. */
+export function findAllSearchInputsInJSX(root) {
+    var results = [];
+    var traverse = function (node) {
+        if (!node) {
+            return;
+        }
+        if (isInput(node)) {
+            var forNodeId = readJSXAttributeString(node, SEARCH_FOR_ATTR);
+            if (forNodeId) {
+                results.push({ node: node, forNodeId: forNodeId });
+            }
+            else if (hasSearchInputClass(node)) {
+                results.push({ node: node });
+            }
+        }
+        if (node.children && Array.isArray(node.children)) {
+            node.children.forEach(function (c) { return traverse(c); });
+        }
+        if (node.body) {
+            if (Array.isArray(node.body)) {
+                node.body.forEach(function (s) { return traverse(s); });
+            }
+            else {
+                traverse(node.body);
+            }
+        }
+        if (node.consequent) {
+            traverse(node.consequent);
+        }
+        if (node.alternate) {
+            traverse(node.alternate);
+        }
+        // `{activeTabIndex === 0 && (<div>…<DataProvider/>…</div>)}` — a tab
+        // panel, a gated section: the provider sits on the RIGHT of a logical
+        // expression (or in a ternary's `test`), which is not a child, a body or
+        // an argument. Left unvisited, the products list under the first tab of
+        // a shop was never paginated or seeded, and rendered nothing.
+        if (node.left) {
+            traverse(node.left);
+        }
+        if (node.right) {
+            traverse(node.right);
+        }
+        if (node.test) {
+            traverse(node.test);
+        }
+        if (node.expression) {
+            traverse(node.expression);
+        }
+        if (node.argument) {
+            traverse(node.argument);
+        }
+    };
+    traverse(root);
+    return results;
+}
+/**
+ * The search-enabled usage each input searches: a marked input's by the mapper
+ * node id it names, a platform input's by its place among the platform inputs.
+ */
+export function pairSearchInputs(inputs, usages) {
+    var searchable = usages.filter(function (usage) { return usage.searchEnabled; });
+    var paired = new Map();
+    var position = 0;
+    var _loop_1 = function (input) {
+        if (input.forNodeId) {
+            var named = searchable.find(function (candidate) { return candidate.nodeId === input.forNodeId; });
+            if (named) {
+                paired.set(input.node, named);
+            }
+            return "continue";
+        }
+        var next = searchable[position];
+        position += 1;
+        if (next) {
+            paired.set(input.node, next);
+        }
+    };
+    for (var _i = 0, inputs_1 = inputs; _i < inputs_1.length; _i++) {
+        var input = inputs_1[_i];
+        _loop_1(input);
+    }
+    return paired;
+}
+/**
+ * Controls the input by the mapper's query: `value` reads it, `onChange`
+ * writes it. A marked input may sit inside a form of the page's own; Enter
+ * in it must not submit that form and reload the filtered list away.
+ */
+export function wireSearchInput(input, vars) {
+    var attributes = input.node.openingElement.attributes.filter(function (attr) { var _a; return !['onChange', 'value', 'onKeyDown'].includes((_a = attr.name) === null || _a === void 0 ? void 0 : _a.name); });
+    attributes.push(types.jsxAttribute(types.jsxIdentifier('onChange'), types.jsxExpressionContainer(types.arrowFunctionExpression([types.identifier('e')], types.callExpression(types.identifier(vars.setSearchQueryVar), [
+        types.memberExpression(types.memberExpression(types.identifier('e'), types.identifier('target')), types.identifier('value')),
+    ])))), types.jsxAttribute(types.jsxIdentifier('value'), types.jsxExpressionContainer(types.identifier(vars.searchQueryVar))));
+    if (input.forNodeId) {
+        attributes.push(types.jsxAttribute(types.jsxIdentifier('onKeyDown'), types.jsxExpressionContainer(types.arrowFunctionExpression([types.identifier('e')], types.blockStatement([
+            types.ifStatement(types.binaryExpression('===', types.memberExpression(types.identifier('e'), types.identifier('key')), types.stringLiteral('Enter')), types.expressionStatement(types.callExpression(types.memberExpression(types.identifier('e'), types.identifier('preventDefault')), []))),
+        ])))));
+    }
+    input.node.openingElement.attributes = attributes;
+}
+//# sourceMappingURL=search-input.js.map

package/dist/esm/search-input.js.map

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

package/dist/esm/sort-utils.d.ts

@@ -1,5 +1,5 @@
 import * as types from '@babel/types';
-import { UIDLExpressionValue, UIDLStaticValue } from '@teleporthq/teleport-types';
+import { UIDLExpressionValue, UIDLStateDefinition, UIDLStaticValue } from '@teleporthq/teleport-types';
 export interface DynamicSortAST {
     field: types.Expression;
     order: types.Expression;
@@ -16,5 +16,57 @@ export declare const readFixedSort: (sort: UIDLStaticValue | UIDLExpressionValue
     order: 'asc' | 'desc';
 } | undefined;
 export declare const extractDynamicSort: (sort: UIDLStaticValue | UIDLExpressionValue | undefined, sortDirection: UIDLStaticValue | UIDLExpressionValue | undefined) => DynamicSortAST | undefined;
+/**
+ * A page state a state-bound sort reads, at the value the visitor starts with.
+ */
+export interface SortStateDefault {
+    /** The state's binding in the component: the name the sort expressions read. */
+    binding: string;
+    value: string | number | boolean;
+}
+/**
+ * The states a state-bound sort reads, at their defaults: the sort a visitor
+ * starts with, which the build can fetch the first page by.
+ *
+ * Only when every name the column and the direction read is a state of this
+ * component starting at a fixed value. Anything else they read — a prop, the
+ * router, `window` — or a state the page seeds from its data leaves the build
+ * unable to know the starting sort: `undefined`, and the list fetches its first
+ * page in the browser. An empty list is a sort that reads nothing.
+ */
+export declare const readSortStateDefaults: (dynamicSort: DynamicSortAST, stateDefinitions: Record<string, UIDLStateDefinition> | undefined) => SortStateDefault[] | undefined;
+/**
+ * A list repeater's own sort, read the one way for every part of the plugin
+ * that fetches the list's rows — the build's fetch for a page and the
+ * browser's: a column the editor fixed (`fixed`), or one bound to state
+ * (`dynamic`) with, when the build can know them, the values a visitor starts
+ * with (`starting`, see `readSortStateDefaults`). Empty without a sort.
+ */
+export interface RepeaterSort {
+    fixed?: {
+        field: string;
+        order: 'asc' | 'desc';
+    };
+    dynamic?: DynamicSortAST;
+    starting?: SortStateDefault[];
+}
+export declare const readRepeaterSort: (sort: UIDLStaticValue | UIDLExpressionValue | undefined, sortDirection: UIDLStaticValue | UIDLExpressionValue | undefined, stateDefinitions: Record<string, UIDLStateDefinition> | undefined) => RepeaterSort;
+/**
+ * The `sorts` param of the build-time fetch: the browser's own expression,
+ * evaluated with every state it reads at its default —
+ *
+ *   ((sortBy) => JSON.stringify([{ field: sortBy.split("-")?.[0] || '', order: … }]))("name-asc")
+ *
+ * — so it is the very string the browser sends while the sort is untouched, and
+ * the data source orders the first page exactly as it orders every later one
+ * (the same columns, empty values last, the row's id breaking ties).
+ */
+export declare const buildStartingSortsValue: (dynamicSort: DynamicSortAST, defaults: SortStateDefault[]) => types.Expression;
+/**
+ * `sortBy === "name-asc"`: the sort is still the one the visitor starts with,
+ * so the rows fetched at build time are its first page. `null` for a sort that
+ * reads nothing, which never moves.
+ */
+export declare const buildSortAtStartGuard: (defaults: SortStateDefault[]) => types.Expression | null;
 export declare const appendSortsParam: (paramsProps: types.ObjectProperty[], legacySorts: any[] | undefined, dynamicSort: DynamicSortAST | undefined) => void;
 //# sourceMappingURL=sort-utils.d.ts.map

package/dist/esm/sort-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort-utils.d.ts","sourceRoot":"","sources":["../../src/sort-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,UAAU,CAAA;IACvB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAA;IACvB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAyDD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAClB,eAAe,GAAG,mBAAmB,GAAG,SAAS,iBACxC,eAAe,GAAG,mBAAmB,GAAG,SAAS,KAC/D;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAAG,SAc7C,CAAA;AAED,eAAO,MAAM,kBAAkB,SACvB,eAAe,GAAG,mBAAmB,GAAG,SAAS,iBACxC,eAAe,GAAG,mBAAmB,GAAG,SAAS,KAC/D,cAAc,GAAG,SAkBnB,CAAA;AAiDD,eAAO,MAAM,gBAAgB,gBACd,MAAM,cAAc,EAAE,eAEtB,GAAG,EAAE,GAAG,SAAS,eACjB,cAAc,GAAG,SAAS,KACtC,IASF,CAAA"}
+{"version":3,"file":"sort-utils.d.ts","sourceRoot":"","sources":["../../src/sort-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EAChB,MAAM,4BAA4B,CAAA;AAEnC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,UAAU,CAAA;IACvB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAA;IACvB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AA6DD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAClB,eAAe,GAAG,mBAAmB,GAAG,SAAS,iBACxC,eAAe,GAAG,mBAAmB,GAAG,SAAS,KAC/D;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAAG,SAc7C,CAAA;AAED,eAAO,MAAM,kBAAkB,SACvB,eAAe,GAAG,mBAAmB,GAAG,SAAS,iBACxC,eAAe,GAAG,mBAAmB,GAAG,SAAS,KAC/D,cAAc,GAAG,SAkBnB,CAAA;AAoBD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACjC;AAWD;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,gBACnB,cAAc,oBACT,OAAO,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,KAChE,gBAAgB,EAAE,GAAG,SAyBvB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;IAChD,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC9B;AAED,eAAO,MAAM,gBAAgB,SACrB,eAAe,GAAG,mBAAmB,GAAG,SAAS,iBACxC,eAAe,GAAG,mBAAmB,GAAG,SAAS,oBAC9C,OAAO,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,KAChE,YAUF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,gBACrB,cAAc,YACjB,gBAAgB,EAAE,KAC3B,MAAM,UAYR,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,aAAc,gBAAgB,EAAE,KAAG,MAAM,UAAU,GAAG,IAanF,CAAA;AA+BL,eAAO,MAAM,gBAAgB,gBACd,MAAM,cAAc,EAAE,eAEtB,GAAG,EAAE,GAAG,SAAS,eACjB,cAAc,GAAG,SAAS,KACtC,IASF,CAAA"}

package/dist/esm/sort-utils.js

@@ -9,6 +9,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 };
 import * as types from '@babel/types';
 import { ASTUtils } from '@teleporthq/teleport-plugin-common';
+import { JSIdentifiers } from '@teleporthq/teleport-shared';
 var SKIP_IDENTIFIERS = new Set([
     'undefined',
     'NaN',
@@ -18,20 +19,21 @@ var SKIP_IDENTIFIERS = new Set([
     'document',
     'console',
 ]);
-var collectIdentifiers = function (node, acc) {
+var collectIdentifiers = function (node, acc, skip) {
+    if (skip === void 0) { skip = SKIP_IDENTIFIERS; }
     if (!node || typeof node !== 'object') {
         return;
     }
     if (node.type === 'Identifier') {
-        if (!SKIP_IDENTIFIERS.has(node.name)) {
+        if (!skip.has(node.name)) {
             acc.add(node.name);
         }
         return;
     }
     if (node.type === 'MemberExpression') {
-        collectIdentifiers(node.object, acc);
+        collectIdentifiers(node.object, acc, skip);
         if (node.computed) {
-            collectIdentifiers(node.property, acc);
+            collectIdentifiers(node.property, acc, skip);
         }
         return;
     }
@@ -41,10 +43,10 @@ var collectIdentifiers = function (node, acc) {
         // tslint:disable-next-line:no-any
         var child = node[key];
         if (Array.isArray(child)) {
-            child.forEach(function (c) { return collectIdentifiers(c, acc); });
+            child.forEach(function (c) { return collectIdentifiers(c, acc, skip); });
         }
         else if (child && typeof child === 'object' && typeof child.type === 'string') {
-            collectIdentifiers(child, acc);
+            collectIdentifiers(child, acc, skip);
         }
     }
 };
@@ -93,16 +95,102 @@ export var extractDynamicSort = function (sort, sortDirection) {
         depStateIds: Array.from(depSet),
     };
 };
-// Build the AST for `sorts: JSON.stringify([{ field: <fieldExpr>, order: <orderExpr> }])`
-var buildDynamicSortsProperty = function (dynamicSort) {
-    return types.objectProperty(types.identifier('sorts'), types.callExpression(types.memberExpression(types.identifier('JSON'), types.identifier('stringify')), [
+// `JSON.stringify([{ field: <fieldExpr>, order: <orderExpr> }])`
+var buildDynamicSortsValue = function (dynamicSort) {
+    return types.callExpression(types.memberExpression(types.identifier('JSON'), types.identifier('stringify')), [
         types.arrayExpression([
             types.objectExpression([
-                types.objectProperty(types.identifier('field'), types.cloneNode(dynamicSort.field)),
-                types.objectProperty(types.identifier('order'), types.cloneNode(dynamicSort.order)),
+                types.objectProperty(types.identifier('field'), types.cloneNode(dynamicSort.field, true)),
+                types.objectProperty(types.identifier('order'), types.cloneNode(dynamicSort.order, true)),
             ]),
         ]),
-    ]));
+    ]);
+};
+// Build the AST for `sorts: JSON.stringify([{ field: <fieldExpr>, order: <orderExpr> }])`
+var buildDynamicSortsProperty = function (dynamicSort) {
+    return types.objectProperty(types.identifier('sorts'), buildDynamicSortsValue(dynamicSort));
+};
+// Names a sort expression may read besides its states: they mean the same on
+// the server and in the browser.
+var CONSTANT_IDENTIFIERS = new Set(['undefined', 'NaN', 'Infinity']);
+var isStartingValue = function (value) {
+    return typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value));
+};
+/**
+ * The states a state-bound sort reads, at their defaults: the sort a visitor
+ * starts with, which the build can fetch the first page by.
+ *
+ * Only when every name the column and the direction read is a state of this
+ * component starting at a fixed value. Anything else they read — a prop, the
+ * router, `window` — or a state the page seeds from its data leaves the build
+ * unable to know the starting sort: `undefined`, and the list fetches its first
+ * page in the browser. An empty list is a sort that reads nothing.
+ */
+export var readSortStateDefaults = function (dynamicSort, stateDefinitions) {
+    var read = new Set();
+    collectIdentifiers(dynamicSort.field, read, CONSTANT_IDENTIFIERS);
+    collectIdentifiers(dynamicSort.order, read, CONSTANT_IDENTIFIERS);
+    // A state's binding is its sanitised name, as the component declares it.
+    var stateByBinding = new Map();
+    Object.entries(stateDefinitions !== null && stateDefinitions !== void 0 ? stateDefinitions : {}).forEach(function (_a) {
+        var key = _a[0], definition = _a[1];
+        stateByBinding.set(JSIdentifiers.createSafeJSIdentifier(key), definition);
+    });
+    var defaults = [];
+    for (var _i = 0, _a = Array.from(read); _i < _a.length; _i++) {
+        var binding = _a[_i];
+        var definition = stateByBinding.get(binding);
+        if (!definition ||
+            definition.dataSourceBinding ||
+            definition.query ||
+            !isStartingValue(definition.defaultValue)) {
+            return undefined;
+        }
+        defaults.push({ binding: binding, value: definition.defaultValue });
+    }
+    return defaults;
+};
+export var readRepeaterSort = function (sort, sortDirection, stateDefinitions) {
+    if (!sort) {
+        return {};
+    }
+    var fixed = readFixedSort(sort, sortDirection);
+    if (fixed) {
+        return { fixed: fixed };
+    }
+    var dynamic = extractDynamicSort(sort, sortDirection);
+    return dynamic ? { dynamic: dynamic, starting: readSortStateDefaults(dynamic, stateDefinitions) } : {};
+};
+/**
+ * The `sorts` param of the build-time fetch: the browser's own expression,
+ * evaluated with every state it reads at its default —
+ *
+ *   ((sortBy) => JSON.stringify([{ field: sortBy.split("-")?.[0] || '', order: … }]))("name-asc")
+ *
+ * — so it is the very string the browser sends while the sort is untouched, and
+ * the data source orders the first page exactly as it orders every later one
+ * (the same columns, empty values last, the row's id breaking ties).
+ */
+export var buildStartingSortsValue = function (dynamicSort, defaults) {
+    var sorts = buildDynamicSortsValue(dynamicSort);
+    if (defaults.length === 0) {
+        return sorts;
+    }
+    return types.callExpression(types.arrowFunctionExpression(defaults.map(function (state) { return types.identifier(state.binding); }), sorts), defaults.map(function (state) { return types.valueToNode(state.value); }));
+};
+/**
+ * `sortBy === "name-asc"`: the sort is still the one the visitor starts with,
+ * so the rows fetched at build time are its first page. `null` for a sort that
+ * reads nothing, which never moves.
+ */
+export var buildSortAtStartGuard = function (defaults) {
+    return defaults
+        .map(function (state) {
+        return types.binaryExpression('===', types.identifier(state.binding), types.valueToNode(state.value));
+    })
+        .reduce(function (all, guard) { return (all ? types.logicalExpression('&&', all, guard) : guard); }, null);
 };
 // Build the AST for the legacy static sorts array form.
 // tslint:disable-next-line:no-any