@arcgis/coding-components 4.30.0 → 4.31.0-next.10

package/dist/components/sql-expression-fields.js

@@ -0,0 +1,102 @@
+/*!
+ * All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
+ */
+import { proxyCustomElement, HTMLElement, createEvent, forceUpdate, h } from '@stencil/core/internal/client';
+import { u as useControllerManager } from './chunk-3IUJHIAA.js';
+import { s as sqlExprDefaults } from './sql-expr-defaults.js';
+import "@esri/calcite-components/dist/components/calcite-block.js";
+import "@esri/calcite-components/dist/components/calcite-flow.js";
+import "@esri/calcite-components/dist/components/calcite-flow-item.js";
+import "@esri/calcite-components/dist/components/calcite-list.js";
+import "@esri/calcite-components/dist/components/calcite-list-item.js";
+import "@esri/calcite-components/dist/components/calcite-action.js";
+
+const sqlExpressionFieldsCss = ":host calcite-flow{height:100%}:host calcite-list-item-group{background-color:var(--calcite-color-foreground-2)}";
+const ArcgisSqlExpressionFieldsStyle0 = sqlExpressionFieldsCss;
+
+const __cmpMeta = [1,"arcgis-sql-expression-fields",{"loading":[1028],"modelId":[1025,"model-id"],"_mutationCounter":[32],"_flowItemRenderers":[32],"_filterValue":[32]},undefined,{"modelId":["modelIdPropChanged"]}];
+const SqlExpressionFields = /*@__PURE__*/ proxyCustomElement(class SqlExpressionFields extends HTMLElement {
+    connectedCallback() { this.manager._connectedCallback(); }
+    constructor() {
+        super();
+        this.__registerHost();
+this.constructor.__registerControllers = ()=>__cmpMeta[2]??{};
+        this.__attachShadow();
+        this.arcgisClose = createEvent(this, "arcgisClose", 3);
+        this.arcgisFieldSelected = createEvent(this, "arcgisFieldSelected", 3);
+        this.manager = useControllerManager(this,forceUpdate);
+        // #endregion
+        // #region Private Methods
+        this._handleSelectField = (event) => {
+            if (event.target instanceof HTMLElement) {
+                const tagName = event.target.tagName;
+                switch (tagName.toLowerCase()) {
+                    case "calcite-list-item":
+                        // TODO: why is value missing from HTMLCalciteListElement type?
+                        this.arcgisFieldSelected.emit(event.target.value ?? "");
+                        break;
+                    case "calcite-action":
+                        event.stopPropagation();
+                        break;
+                }
+            }
+        };
+        this._emitClose = () => {
+            this.arcgisClose.emit();
+        };
+        this._mutationCounter = 1;
+        this._flowItemRenderers = [];
+        this._filterValue = "";
+        this.loading = false;
+        this.modelId = undefined;
+    }
+    modelIdPropChanged() {
+        this._flowItemRenderers = [];
+    }
+    // #endregion
+    // #region Lifecycle
+    disconnectedCallback() {
+        this.manager._disconnectedCallback();
+        this._flowObserver?.disconnect();
+    }
+    // #endregion
+    render() {
+        const layer = sqlExprDefaults.getFeatureLayerForModel(this.modelId ?? "");
+        if (this.loading || !this.modelId || !layer) {
+            return h("calcite-block", { heading: "Available Fields" });
+        }
+        return (h("calcite-flow", null, h("calcite-flow-item", { heading: "Available Fields", closable: true, description: "Select a field to insert into the expression", onCalciteFlowItemClose: this._emitClose }, h("calcite-list", { filterEnabled: true }, layer.fields.map((field) => (h("calcite-list-item", { key: field.name, onClick: this._handleSelectField, label: field.name, description: field.alias, value: field.name }, field.domain && (h("calcite-action", { slot: "actions-end", text: "open", icon: "chevron-right", onClick: () => {
+                const domain = field.domain;
+                if (domain.type === "coded-value") {
+                    this._flowItemRenderers = [
+                        ...this._flowItemRenderers,
+                        () => (h("calcite-flow-item", { closable: true, heading: "Domains", description: field.name, onCalciteFlowItemClose: this._emitClose }, h("calcite-list", null, domain.codedValues.map((value) => (h("calcite-list-item", { key: value.code, onClick: this._handleSelectField, label: value.name, description: String(value.code), value: value.code })))))),
+                    ];
+                }
+            } }))))))), this._flowItemRenderers.map((renderer) => renderer())));
+    }
+    static get assetsDirs() { return ["assets"]; }
+    get el() { return this; }
+    static get watchers() { return {
+        "modelId": ["modelIdPropChanged"]
+    }; }
+    static get style() { return ArcgisSqlExpressionFieldsStyle0; }
+}, __cmpMeta);
+function defineCustomElement() {
+    if (typeof customElements === "undefined") {
+        return;
+    }
+    const components = ["arcgis-sql-expression-fields"];
+    components.forEach(tagName => { switch (tagName) {
+        case "arcgis-sql-expression-fields":
+            if (!customElements.get(tagName)) {
+                customElements.define(tagName, SqlExpressionFields);
+            }
+            break;
+    } });
+}
+defineCustomElement();
+
+export { SqlExpressionFields as S, defineCustomElement as d };

package/dist/components/useT9n.js

@@ -1,36 +1,73 @@
 /*!
  * All material copyright Esri, All Rights Reserved, unless otherwise specified.
- * See https://js.arcgis.com/4.30/esri/copyright.txt for details.
- * v4.30.0
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
  */
-import { m as makeController } from './chunk-2CDDVOQU.js';
-import { n as startLocaleObserver, o as getElementLocales } from './index2.js';
+import { m as makeController, w as watch } from './chunk-3IUJHIAA.js';
+import { n as startLocaleObserver, p as getElementLocales } from './index2.js';
 import { getArcgisAssetPath as getAssetPath } from "./arcgis-assets.js";
 
-var makeT9nController = (getAssetPath) => ({ blocking = false, name } = {}) => (
+var makeT9nController = (getAssetPath) => (options = {}) => (
   // eslint-disable-next-line @typescript-eslint/promise-function-async
   makeController((component, controller) => {
+    const componentWithOverrides = component;
     controller.onLifecycle(
       () => startLocaleObserver(
         component.el,
         getAssetPath("./assets"),
         ({ t9nLocale, t9nStrings, lang }) => {
-          controller.exports = { ...t9nStrings, _lang: lang, _t9nLocale: t9nLocale };
+          const withoutOverrides = {
+            ...t9nStrings,
+            _lang: lang,
+            _t9nLocale: t9nLocale,
+            _loading: false
+          };
+          controller.exports = withoutOverrides;
           const label = t9nStrings.componentLabel ?? t9nStrings.widgetLabel;
           if (typeof label === "string" && "label" in component && component.label == null) {
             component.label ?? (component.label = label);
           }
+          applyOverrides(componentWithOverrides.messageOverrides);
         },
-        name
+        options.name
       )
     );
-    if (blocking) {
+    function applyOverrides(messageOverrides) {
+      const currentValue = controller.exports;
+      const rawMessages = currentValue._original ?? currentValue;
+      const updated = deepMerge(rawMessages, messageOverrides);
+      updated._original = rawMessages;
+      controller.exports = updated;
+    }
+    if ("messageOverrides" in componentWithOverrides) {
+      controller.onLifecycle(() => watch(componentWithOverrides, "messageOverrides", applyOverrides));
+    }
+    if (options.blocking) {
       return controller.ready;
     }
     const locale = getElementLocales(component.el);
-    return { _lang: locale.lang, _t9nLocale: locale.t9nLocale };
+    const pending = {
+      _lang: locale.lang,
+      _t9nLocale: locale.t9nLocale,
+      _loading: true
+    };
+    return pending;
   })
 );
+function deepMerge(original, overwrites) {
+  if (!overwrites) {
+    return original;
+  }
+  const merged = { ...original };
+  Object.entries(overwrites).forEach(([key, value]) => {
+    if (typeof value === "object") {
+      merged[key] = deepMerge(original[key], value);
+    } else {
+      merged[key] = value ?? original[key];
+    }
+  });
+  return merged;
+}
 
 const useT9n = makeT9nController(getAssetPath);
 

package/dist/components/utilities.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright Esri, All Rights Reserved, unless otherwise specified.
- * See https://js.arcgis.com/4.30/esri/copyright.txt for details.
- * v4.30.0
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
  */
 import { d as createFilterExpression } from './index2.js';
 

package/dist/esm/{app-globals-2a0e9afb.js → app-globals-ed47e16d.js}

@@ -1,7 +1,7 @@
 /*!
  * All material copyright Esri, All Rights Reserved, unless otherwise specified.
- * See https://js.arcgis.com/4.30/esri/copyright.txt for details.
- * v4.30.0
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
  */
 const globalScripts = () => {};
 

package/dist/esm/arcade-defaults-562fe19b.js

@@ -0,0 +1,111 @@
+/*!
+ * All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
+ */
+import { L as LanguageDefaultsBase, i as isPredefinedProfile, c as convertToEditorProfileDefinition, f as fetchT9nStringsBundle, E as EditorProfile, U as Uri } from './language-defaults-base-52a397f5.js';
+import { g as getAssetPath } from './index-3743d31f.js';
+
+/**
+ * Returns the arcade diagnostic service.
+ * Example:
+ * ```ts
+ * const diagnosticService = await getArcadeDiagnosticService();
+ * diagnosticService.onDidChangeDiagnostics(({uri, diaganostics }) => {
+ *  // Filter the diagnostics for the uri of interest
+ *  // Do something with the diagnostics
+ * });
+ * ```
+ */
+async function getArcadeDiagnosticService() {
+    const mode = await getMode();
+    return mode.getArcadeDiagnosticService();
+}
+/**
+ * Returns the arcade worker for the model.
+ * Example:
+ * ```ts
+ * const arcadeWorker = await getArcadeWorker(model.uri);
+ * ```
+ * @returns arcade worker
+ */
+async function getArcadeWorker(uri) {
+    const mode = await getMode();
+    return await mode.getArcadeWorker(uri);
+}
+/**
+ * Request the arcade mode
+ * @returns arcade mode module
+ */
+async function getMode() {
+    return await import('./arcade-mode-ad036f46.js');
+}
+
+const arcadeLanguageId = "arcade";
+class ArcadeLanguageServiceDefaults extends LanguageDefaultsBase {
+    constructor() {
+        super(...arguments);
+        this._languageId = arcadeLanguageId;
+        this._languageOptions = {};
+    }
+    /**
+     * Create an EditorProfile for the given model id using the given definition and locale.
+     * The EditorProfile is used by the the Arcade Language service as well by the cosing components.
+     * The definition can be a pre-defined profile or an editor profile definition.
+     * If the locale is not provided then the 'en' locale is used.
+     * @param modelId The model id for which to create the context.
+     * @param definition The definition to use for the model context.
+     * @param locale The locale to use for the model context.
+     * @returns The EditorProfile for the model.
+     */
+    async setProfileForModel(modelId, definition, apiContext = { locale: "en" }) {
+        // Convert pre-defined profile to a runtime profile
+        if (isPredefinedProfile(definition)) {
+            definition = await convertToEditorProfileDefinition(definition, apiContext.locale);
+        }
+        const profileStrings = await fetchT9nStringsBundle(apiContext.locale, getAssetPath("./assets/arcade-language/t9n"), "profile.t9n.");
+        if (!profileStrings) {
+            throw new Error(`Failed to load the language bundle for ${apiContext.locale}`);
+        }
+        this.disposeForModel(modelId);
+        const key = this._getApiKey(modelId);
+        const editorProfile = new EditorProfile(definition, profileStrings);
+        this._profileMap.set(key, editorProfile);
+        const apiProfile = await editorProfile.toLSProfile();
+        this.updateApiContextForModel(modelId, {
+            locale: apiContext.locale,
+            profile: apiProfile,
+            snippets: apiContext.snippets,
+        });
+    }
+    /**
+     * Set or update the Arcade language service options.
+     * @param languageOptions The language options to set.
+     */
+    setLanguageOptions(languageOptions = {}) {
+        // Check if options have actually changed.
+        // Avoid restarting the worker when no updates.
+        // Today we only have the 'assetsPath' as a property
+        if (this._languageOptions.assetsPath === languageOptions.assetsPath) {
+            return;
+        }
+        this._languageOptions = { ...this._languageOptions, ...languageOptions };
+        this._onDidChange.fire(this);
+    }
+    /**
+     * Gets the API library for the given model id.
+     * @param modelId The model id for which to get the API library.
+     * @returns The API library for the model.
+     */
+    async getApiLibrary(modelId) {
+        const uri = Uri.parse(modelId);
+        const worker = await getArcadeWorker(uri);
+        return await worker.getApiLibrary(this.getApiContextForModel(uri));
+    }
+}
+const arcadeDefaults = new ArcadeLanguageServiceDefaults();
+const arcade = {
+    setProfileForModel: arcadeDefaults.setProfileForModel.bind(arcadeDefaults),
+};
+
+export { arcade as a, arcadeDefaults as b, getMode as c, getArcadeDiagnosticService as g };

package/dist/esm/arcade-language-features-8edb3527.js

@@ -0,0 +1,269 @@
+/*!
+ * All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * See https://js.arcgis.com/4.31/esri/copyright.txt for details.
+ * v4.31.0-next.10
+ */
+import { e as editor, M as MarkerSeverity, F as main, R as Range, u as languages, N as debounce } from './language-defaults-base-52a397f5.js';
+
+//#region Diagnostic
+class DiagnosticsAdapter {
+    constructor(_languageId, _worker, { defaults, diagnosticsService, }) {
+        this._languageId = _languageId;
+        this._worker = _worker;
+        this._disposables = [];
+        this._listener = new Map();
+        this._diagnosticsService = diagnosticsService;
+        this._defaults = defaults;
+        const onModelAdd = (model) => {
+            const languageId = model.getLanguageId();
+            if (languageId !== this._languageId) {
+                return;
+            }
+            const debouncedValidate = debounce(() => {
+                this._doValidate(model, languageId).catch((err) => {
+                    throw err;
+                });
+            });
+            this._listener.set(model.uri.toString(), model.onDidChangeContent(debouncedValidate));
+            this._doValidate(model, languageId).catch(console.error);
+        };
+        const onModelRemoved = (model) => {
+            const uriStr = model.uri.toString();
+            editor.setModelMarkers(model, this._languageId, []);
+            const listener = this._listener.get(uriStr);
+            if (listener) {
+                listener.dispose();
+                this._listener.delete(uriStr);
+            }
+        };
+        this._disposables.push(editor.onDidCreateModel(onModelAdd));
+        this._disposables.push(editor.onWillDisposeModel((model) => {
+            onModelRemoved(model);
+        }));
+        this._disposables.push(editor.onDidChangeModelLanguage((event) => {
+            onModelRemoved(event.model);
+            onModelAdd(event.model);
+        }));
+        this._disposables.push(defaults.onDidChange(() => {
+            editor.getModels().forEach((model) => {
+                if (model.getLanguageId() === this._languageId) {
+                    onModelRemoved(model);
+                    onModelAdd(model);
+                }
+            });
+        }));
+        this._disposables.push(defaults.onModelContextDidChange((key) => {
+            editor.getModels().forEach((model) => {
+                if (model.getLanguageId() === this._languageId && model.uri.toString() === key) {
+                    this._doValidate(model, this._languageId).catch(console.error);
+                }
+            });
+        }));
+        this._disposables.push({
+            dispose: () => {
+                this._listener.forEach((value) => value.dispose());
+                this._listener.clear();
+            },
+        });
+        editor.getModels().forEach(onModelAdd);
+    }
+    dispose() {
+        this._disposables.forEach((d) => d.dispose());
+        this._disposables = [];
+    }
+    async _doValidate(model, languageId) {
+        if (!model.isAttachedToEditor()) {
+            return;
+        }
+        try {
+            const workerProxy = await this._worker(model.uri);
+            const context = this._defaults.getApiContextForModel(model.uri);
+            const diagnostics = await workerProxy.doValidation(model.uri.toString(), context);
+            const markers = diagnostics.map((d) => toMarker(model.uri, d));
+            this._diagnosticsService.fireDiagnosticsChange(model.uri, diagnostics);
+            editor.setModelMarkers(model, languageId, markers);
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+}
+function toSeverity(languageServiceSeverity) {
+    switch (languageServiceSeverity) {
+        case main.exports.DiagnosticSeverity.Error:
+            return MarkerSeverity.Error;
+        case main.exports.DiagnosticSeverity.Warning:
+            return MarkerSeverity.Warning;
+        case main.exports.DiagnosticSeverity.Information:
+            return MarkerSeverity.Info;
+        case main.exports.DiagnosticSeverity.Hint:
+            return MarkerSeverity.Hint;
+        default:
+            return MarkerSeverity.Info;
+    }
+}
+function toMarker(_resource, diag) {
+    // Diagnostics positions are zero-based, MarkerData are 1-based
+    return {
+        severity: toSeverity(diag.severity),
+        startLineNumber: diag.range.start.line + 1,
+        startColumn: diag.range.start.character + 1,
+        endLineNumber: diag.range.end.line + 1,
+        endColumn: diag.range.end.character + 1,
+        message: diag.message,
+    };
+}
+//#endregion
+//#region Completion
+function fromPosition(position) {
+    // Language service is zero based
+    return { character: position.column - 1, line: position.lineNumber - 1 };
+}
+function toRange(range) {
+    return new Range(range.start.line + 1, range.start.character + 1, range.end.line + 1, range.end.character + 1);
+}
+function toTextEdit(textEdit) {
+    return {
+        range: toRange(textEdit.range),
+        text: textEdit.newText,
+    };
+}
+function isInsertReplaceEdit(edit) {
+    return (typeof edit.insert !== "undefined" &&
+        typeof edit.replace !== "undefined");
+}
+// TODO: extract this function to common util
+function toCompletionItemKind(kind) {
+    const mItemKind = languages.CompletionItemKind;
+    switch (kind) {
+        case main.exports.CompletionItemKind.Text:
+            return mItemKind.Text;
+        case main.exports.CompletionItemKind.Method:
+            return mItemKind.Method;
+        case main.exports.CompletionItemKind.Function:
+            return mItemKind.Function;
+        case main.exports.CompletionItemKind.Constructor:
+            return mItemKind.Constructor;
+        case main.exports.CompletionItemKind.Field:
+            return mItemKind.Field;
+        case main.exports.CompletionItemKind.Variable:
+            return mItemKind.Variable;
+        case main.exports.CompletionItemKind.Class:
+            return mItemKind.Class;
+        case main.exports.CompletionItemKind.Interface:
+            return mItemKind.Interface;
+        case main.exports.CompletionItemKind.Module:
+            return mItemKind.Module;
+        case main.exports.CompletionItemKind.Property:
+            return mItemKind.Property;
+        case main.exports.CompletionItemKind.Unit:
+            return mItemKind.Unit;
+        case main.exports.CompletionItemKind.Value:
+            return mItemKind.Value;
+        case main.exports.CompletionItemKind.Enum:
+            return mItemKind.Enum;
+        case main.exports.CompletionItemKind.Keyword:
+            return mItemKind.Keyword;
+        case main.exports.CompletionItemKind.Snippet:
+            return mItemKind.Snippet;
+        case main.exports.CompletionItemKind.Color:
+            return mItemKind.Color;
+        case main.exports.CompletionItemKind.File:
+            return mItemKind.File;
+        case main.exports.CompletionItemKind.Reference:
+            return mItemKind.Reference;
+        case main.exports.CompletionItemKind.Folder:
+            return mItemKind.Folder;
+        case main.exports.CompletionItemKind.EnumMember:
+            return mItemKind.EnumMember;
+        case main.exports.CompletionItemKind.Constant:
+            return mItemKind.Constant;
+        case main.exports.CompletionItemKind.Struct:
+            return mItemKind.Struct;
+        case main.exports.CompletionItemKind.Event:
+            return mItemKind.Event;
+        case main.exports.CompletionItemKind.Operator:
+            return mItemKind.Operator;
+        case main.exports.CompletionItemKind.TypeParameter:
+            return mItemKind.TypeParameter;
+        default:
+            return mItemKind.Property;
+    }
+}
+class CompletionProvider {
+    constructor(_worker, _defaults) {
+        this._worker = _worker;
+        this._defaults = _defaults;
+        this.triggerCharacters = [".", "("];
+    }
+    async provideCompletionItems(model, position) {
+        const worker = await this._worker(model.uri);
+        const context = this._defaults.getApiContextForModel(model.uri);
+        const completionList = await worker.doComplete(model.uri.toString(), fromPosition(position), context);
+        const wordInfo = model.getWordUntilPosition(position);
+        const wordRange = new Range(position.lineNumber, wordInfo.startColumn, position.lineNumber, wordInfo.endColumn);
+        const items = completionList.items.map((entry) => {
+            const item = {
+                label: entry.label,
+                insertText: entry.insertText || entry.label,
+                sortText: entry.sortText,
+                filterText: entry.filterText,
+                detail: entry.detail,
+                range: wordRange,
+                kind: toCompletionItemKind(entry.kind),
+            };
+            if (entry.textEdit) {
+                if (isInsertReplaceEdit(entry.textEdit)) {
+                    item.range = {
+                        insert: toRange(entry.textEdit.insert),
+                        replace: toRange(entry.textEdit.replace),
+                    };
+                }
+                else {
+                    item.range = toRange(entry.textEdit.range);
+                }
+                item.insertText = entry.textEdit.newText;
+            }
+            if (entry.additionalTextEdits) {
+                item.additionalTextEdits = entry.additionalTextEdits.map(toTextEdit);
+            }
+            if (entry.insertTextFormat === main.exports.InsertTextFormat.Snippet) {
+                item.insertTextRules = languages.CompletionItemInsertTextRule.InsertAsSnippet;
+            }
+            if (entry.documentation) {
+                if (typeof entry.documentation === "string") {
+                    item.documentation = entry.documentation;
+                }
+                else {
+                    item.documentation = {
+                        supportThemeIcons: false,
+                        value: entry.documentation.value,
+                        supportHtml: true,
+                    };
+                }
+            }
+            return item;
+        });
+        return {
+            incomplete: completionList.isIncomplete,
+            suggestions: items,
+        };
+    }
+}
+//#endregion
+//#region Formatter
+class FormattingProvider {
+    constructor(_worker, _defaults) {
+        this._worker = _worker;
+        this._defaults = _defaults;
+    }
+    async provideDocumentFormattingEdits(model) {
+        const worker = await this._worker(model.uri);
+        const context = this._defaults.getApiContextForModel(model.uri.toString());
+        const edits = await worker.doFormat(model.uri.toString(), context);
+        return edits.map((e) => ({ range: toRange(e.range), text: e.newText }));
+    }
+}
+//#endregion
+
+export { CompletionProvider as C, DiagnosticsAdapter as D, FormattingProvider as F, toCompletionItemKind as t };