@servicenow/sdk-build-plugins 4.1.1 → 4.3.0

package/dist/ui-policy-plugin.js

@@ -0,0 +1,405 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UiPolicyPlugin = void 0;
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+const utils_1 = require("./utils");
+const now_id_plugin_1 = require("./now-id-plugin");
+// Define table names as constants since they're not exported from the core tables
+const SYS_UI_POLICY = 'sys_ui_policy';
+const SYS_UI_POLICY_ACTION = 'sys_ui_policy_action';
+const SYS_UI_POLICY_RL_ACTION = 'sys_ui_policy_rl_action';
+const DEFAULT_SCRIPT = 'function onCondition() {\n\n}';
+// UI Type constant for string-to-number mapping
+const UiTypeMapping = { desktop: 0, 'mobile-or-service-portal': 1, all: 10 };
+const getUITypeFromId = (id) => {
+    const entry = Object.entries(UiTypeMapping).find(([_, v]) => v === id);
+    if (!entry) {
+        throw Error(`Invalid UI Type encountered: ${id}, check XML data before transforming again.`);
+    }
+    return entry[0];
+};
+const getUITypeId = (value) => {
+    const entry = UiTypeMapping[value];
+    if (entry === undefined) {
+        throw Error(`Invalid ui_type found: ${value}`);
+    }
+    return entry;
+};
+/**
+ * Converts ServiceNow string format ('true'/'false'/'ignore') to boolean | 'ignore'
+ * Used when reading from database (toShape)
+ */
+const stringToBoolean = (value) => {
+    switch (value) {
+        case 'true':
+            return true;
+        case 'false':
+            return false;
+        case 'ignore':
+            return 'ignore';
+        default:
+            return undefined;
+    }
+};
+/**
+ * Converts boolean | 'ignore' to ServiceNow string format ('true'/'false'/'ignore')
+ * Used when writing to database (toRecord)
+ */
+const booleanToString = (value) => {
+    if (value?.isBoolean()) {
+        return value.getValue() ? 'true' : 'false';
+    }
+    return 'ignore';
+};
+/**
+ * Checks if a value is a valid action property (boolean or 'ignore')
+ * Used for validation in toRecord
+ */
+const isValidActionValue = (value) => {
+    return value?.isBoolean() || (value?.isString() && value.getValue() === 'ignore');
+};
+// Helper to determine if a script should be included in generated Fluent code
+const isValidScript = (scriptValue) => scriptValue?.isString() && scriptValue.getValue() !== '' && scriptValue.getValue() !== DEFAULT_SCRIPT;
+// Helper function to validate a script property for import/require statements
+const validateScriptProperty = (scriptProperty, compiler, diagnostics) => {
+    if (scriptProperty?.isString()) {
+        const scriptContent = scriptProperty.getValue();
+        if (scriptContent && !(0, utils_1.validateClientSideScript)(scriptContent, compiler)) {
+            diagnostics.error(scriptProperty, 'UI Policy scripts cannot import or require modules. Scripts run client-side in the browser.');
+        }
+    }
+};
+exports.UiPolicyPlugin = sdk_build_core_1.Plugin.create({
+    name: 'UiPolicyPlugin',
+    records: {
+        [SYS_UI_POLICY]: {
+            coalesce: ['table', 'short_description'],
+            relationships: {
+                [SYS_UI_POLICY_ACTION]: {
+                    via: 'ui_policy',
+                    descendant: true,
+                },
+                [SYS_UI_POLICY_RL_ACTION]: {
+                    via: 'ui_policy',
+                    descendant: true,
+                },
+            },
+            toShape(record, { descendants }) {
+                const actions = descendants
+                    .query(SYS_UI_POLICY_ACTION)
+                    .map((action) => {
+                    const fieldValue = action.get('field')?.ifString()?.getValue();
+                    if (!fieldValue) {
+                        return null; // Skip actions without a field
+                    }
+                    const actionObj = {
+                        field: fieldValue,
+                    };
+                    // Convert ServiceNow string format to boolean | 'ignore'
+                    const visible = stringToBoolean(action.get('visible')?.ifString()?.getValue());
+                    const disabled = stringToBoolean(action.get('disabled')?.ifString()?.getValue());
+                    const mandatory = stringToBoolean(action.get('mandatory')?.ifString()?.getValue());
+                    // Only include visible if it's not 'ignore'
+                    if (visible !== undefined && visible !== 'ignore') {
+                        actionObj.visible = visible;
+                    }
+                    // Convert 'disabled' to 'readOnly'
+                    // Only include 'readOnly' if it's not 'ignore'
+                    if (disabled !== undefined && disabled !== 'ignore') {
+                        actionObj.readOnly = disabled;
+                    }
+                    // Only include mandatory if it's not 'ignore'
+                    if (mandatory !== undefined && mandatory !== 'ignore') {
+                        actionObj.mandatory = mandatory;
+                    }
+                    const cleared = action.get('cleared')?.ifBoolean()?.getValue();
+                    if (cleared) {
+                        actionObj.cleared = cleared;
+                    }
+                    // Add new optional fields - only if they have meaningful values
+                    const table = action.get('table')?.ifString()?.getValue();
+                    const parentTable = record.get('table')?.ifString()?.getValue();
+                    // Only include table if it's different from the parent policy's table
+                    if (table && table !== parentTable) {
+                        actionObj.table = table;
+                    }
+                    const value = action.get('value')?.ifString()?.getValue();
+                    if (value) {
+                        actionObj.value = value;
+                    }
+                    const fieldMessage = action.get('field_message')?.ifString()?.getValue();
+                    if (fieldMessage) {
+                        actionObj.fieldMessage = fieldMessage;
+                    }
+                    const fieldMessageType = action.get('field_message_type')?.ifString()?.getValue();
+                    // Only include if it's not the default value 'none'
+                    if (fieldMessageType && fieldMessageType !== 'none') {
+                        actionObj.fieldMessageType = fieldMessageType;
+                    }
+                    const valueAction = action.get('value_action')?.ifString()?.getValue();
+                    // Only include if it's not the default value 'ignore'
+                    if (valueAction && valueAction !== 'ignore') {
+                        actionObj.valueAction = valueAction;
+                    }
+                    // Skip actions that have no meaningful properties (all are 'ignore')
+                    if (Object.keys(actionObj).length === 1) {
+                        return null; // Only 'field' property exists, skip this action
+                    }
+                    return actionObj;
+                })
+                    .filter((action) => action !== null); // Remove null actions
+                // Process related list actions
+                const relatedListActions = descendants
+                    .query(SYS_UI_POLICY_RL_ACTION)
+                    .map((rlAction) => {
+                    const rlActionObj = {};
+                    const listValue = rlAction.get('list')?.ifString()?.getValue();
+                    if (listValue) {
+                        // Strip REL: prefix if present (transform ServiceNow → Fluent)
+                        // Users write plain GUIDs or table.field format in Fluent code
+                        if (listValue.startsWith('REL:')) {
+                            rlActionObj.list = listValue.substring(4); // Remove 'REL:' prefix
+                        }
+                        else {
+                            rlActionObj.list = listValue;
+                        }
+                    }
+                    // Convert ServiceNow string format to boolean | 'ignore'
+                    const visible = stringToBoolean(rlAction.get('visible')?.ifString()?.getValue());
+                    if (visible !== undefined && visible !== 'ignore') {
+                        rlActionObj.visible = visible;
+                    }
+                    // Skip if no meaningful properties (only $id exists)
+                    if (Object.keys(rlActionObj).length === 0) {
+                        return null;
+                    }
+                    return rlActionObj;
+                })
+                    .filter((rlAction) => rlAction !== null); // Remove null actions
+                return {
+                    success: true,
+                    value: new sdk_build_core_1.CallExpressionShape({
+                        source: record,
+                        callee: 'UiPolicy',
+                        args: [
+                            record.transform(({ $ }) => {
+                                const scriptTrueValue = record.get('script_true');
+                                const scriptFalseValue = record.get('script_false');
+                                const runScriptsValue = record.get('run_scripts')?.toBoolean().getValue() ?? false;
+                                const uiTypeValue = record.get('ui_type');
+                                const includeScriptTrue = runScriptsValue || isValidScript(scriptTrueValue);
+                                const includeScriptFalse = runScriptsValue || isValidScript(scriptFalseValue);
+                                return {
+                                    $id: $.val(now_id_plugin_1.NowIdShape.from(record)),
+                                    table: $.from('table').def(''),
+                                    shortDescription: $.from('short_description'),
+                                    active: $.toBoolean().def(true),
+                                    global: $.toBoolean().def(true),
+                                    onLoad: $.from('on_load').toBoolean().def(true),
+                                    reverseIfFalse: $.from('reverse_if_false').toBoolean().def(true),
+                                    inherit: $.toBoolean().def(false),
+                                    isolateScript: $.from('isolate_script').toBoolean().def(false),
+                                    conditions: $.def(''),
+                                    runScripts: $.from('run_scripts').toBoolean().def(false),
+                                    scriptTrue: $.val(includeScriptTrue ? (scriptTrueValue?.getValue() ?? DEFAULT_SCRIPT) : undefined),
+                                    scriptFalse: $.val(includeScriptFalse
+                                        ? (scriptFalseValue?.getValue() ?? DEFAULT_SCRIPT)
+                                        : undefined),
+                                    // uiType is REQUIRED when runScripts is true, should be omitted when false
+                                    uiType: $.val(runScriptsValue
+                                        ? getUITypeFromId(uiTypeValue?.toNumber().getValue() ?? 0)
+                                        : undefined),
+                                    description: $.from('description').def(''),
+                                    modelId: $.from('model_id').def(''),
+                                    modelTable: $.from('model_table').def(''),
+                                    order: $.from('order').toNumber().def(100),
+                                    setValues: $.from('set_values').def(''),
+                                    view: $.from('view').def(''),
+                                    actions: $.val(actions.length > 0 ? actions : undefined),
+                                    relatedListActions: $.val(relatedListActions.length > 0 ? relatedListActions : undefined),
+                                };
+                            }),
+                        ],
+                    }),
+                };
+            },
+        },
+        [SYS_UI_POLICY_ACTION]: {
+            coalesce: ['ui_policy', 'field'],
+        },
+        [SYS_UI_POLICY_RL_ACTION]: {
+            coalesce: ['ui_policy', 'list'],
+        },
+    },
+    shapes: [
+        {
+            shape: sdk_build_core_1.CallExpressionShape,
+            fileTypes: ['fluent'],
+            async toRecord(callExpression, { config, factory, diagnostics, compiler }) {
+                if (callExpression.getCallee()?.toString() !== 'UiPolicy') {
+                    return { success: false };
+                }
+                const arg = callExpression.getArgument(0);
+                if (!arg?.isObject()) {
+                    return { success: false };
+                }
+                const shortDescription = arg.get('shortDescription');
+                if (shortDescription?.isString() && shortDescription.getValue().trim() === '') {
+                    diagnostics.error(shortDescription, 'shortDescription cannot be empty or contain only whitespace');
+                    return { success: false };
+                }
+                // Validate table scope prefix for scoped apps
+                const tableValue = arg.get('table');
+                if (tableValue?.isString() && config?.scope) {
+                    const tableName = tableValue.getValue();
+                    const scopeName = config.scope;
+                    if (!tableName.startsWith(`${scopeName}_`) && !(0, sdk_build_core_1.isSNScope)(scopeName) && scopeName !== 'global') {
+                        diagnostics.error(arg.get('table'), `'table' property should start with scope prefix '${scopeName}_'. UI Policies in scoped apps can only be created for tables within the same scope.`);
+                    }
+                }
+                // Validate scripts for import statements
+                const scriptTrue = arg.get('scriptTrue');
+                const scriptFalse = arg.get('scriptFalse');
+                validateScriptProperty(scriptTrue, compiler, diagnostics);
+                validateScriptProperty(scriptFalse, compiler, diagnostics);
+                const runScripts = arg.get('runScripts');
+                if (runScripts.isUndefined() || runScripts.ifBoolean()?.equals(false)) {
+                    ;
+                    [scriptTrue, scriptFalse]
+                        .filter((shape) => shape.isDefined() && !shape.equals(DEFAULT_SCRIPT))
+                        .forEach((shape) => diagnostics.info(shape, `This script will not execute unless runScripts is set to true`));
+                }
+                // Convert uiType value to ID (TypeScript enforces valid values at compile time)
+                const uiTypeValue = arg.get('uiType');
+                const uiTypeId = uiTypeValue?.isString()
+                    ? getUITypeId(uiTypeValue.getValue())
+                    : UiTypeMapping.desktop; // default
+                // Create the UI Policy record
+                const policyRecord = await factory.createRecord({
+                    source: callExpression,
+                    table: SYS_UI_POLICY,
+                    explicitId: arg.get('$id'),
+                    properties: arg.transform(({ $ }) => ({
+                        table: $.from('table').def(''),
+                        short_description: $.from('shortDescription'),
+                        active: $.from('active').def(true),
+                        global: $.from('global').def(true),
+                        on_load: $.from('onLoad').def(true),
+                        reverse_if_false: $.from('reverseIfFalse').def(true),
+                        inherit: $.from('inherit').def(false),
+                        isolate_script: $.from('isolateScript').def(false),
+                        conditions: $.from('conditions').def(''),
+                        run_scripts: $.from('runScripts').def(false),
+                        script_true: $.from('scriptTrue').toCdata().def(DEFAULT_SCRIPT),
+                        script_false: $.from('scriptFalse').toCdata().def(DEFAULT_SCRIPT),
+                        description: $.from('description').def(''),
+                        model_id: $.from('modelId').def(''),
+                        model_table: $.from('modelTable').def(''),
+                        order: $.from('order').toNumber().def(100),
+                        set_values: $.from('setValues').def(''),
+                        ui_type: $.val(uiTypeId),
+                        view: $.from('view').def(''),
+                    })),
+                });
+                // Process actions if they exist
+                const actions = arg.get('actions');
+                const actionRecords = [];
+                if (actions?.isArray()) {
+                    const elements = actions.getElements();
+                    // Process each action in the array
+                    for (let i = 0; i < elements.length; i++) {
+                        const action = elements[i];
+                        if (!action?.isObject()) {
+                            continue;
+                        }
+                        const field = action.get('field');
+                        // Validate at least one action property exists
+                        const hasVisibleProp = isValidActionValue(action.get('visible'));
+                        const hasReadOnlyProp = isValidActionValue(action.get('readOnly'));
+                        const hasMandatoryProp = isValidActionValue(action.get('mandatory'));
+                        const hasClearedProp = action.get('cleared')?.isBoolean() || false;
+                        if (!hasVisibleProp && !hasReadOnlyProp && !hasMandatoryProp && !hasClearedProp) {
+                            diagnostics.error(action, `Action at index ${i} must specify at least one of: visible, readOnly, mandatory, or cleared`);
+                            continue;
+                        }
+                        const actionRecord = await factory.createRecord({
+                            source: action, // Use the action as source instead of callExpression
+                            table: SYS_UI_POLICY_ACTION,
+                            properties: action.transform(({ $ }) => ({
+                                ui_policy: $.val(policyRecord.getId()),
+                                table: $.from('table').def(arg.get('table')?.getValue() || ''),
+                                field: $.val(field.getValue()),
+                                visible: $.val(booleanToString(action.get('visible'))),
+                                disabled: $.val(booleanToString(action.get('readOnly'))),
+                                mandatory: $.val(booleanToString(action.get('mandatory'))),
+                                cleared: $.from('cleared').toBoolean().def(false),
+                                field_message: $.from('fieldMessage').def(''),
+                                field_message_type: $.from('fieldMessageType').def('none'),
+                                value: $.from('value').def(''),
+                                value_action: $.from('valueAction').def('ignore'),
+                            })),
+                        });
+                        actionRecords.push(actionRecord);
+                    }
+                }
+                // Create related list action records (optional) - AST approach
+                const relatedListActionRecords = [];
+                const relatedListActions = arg.get('relatedListActions');
+                if (relatedListActions?.isArray()) {
+                    const rlElements = relatedListActions.getElements();
+                    // Process each related list action in the array (similar to actions)
+                    for (let i = 0; i < rlElements.length; i++) {
+                        const rlAction = rlElements[i];
+                        if (!rlAction?.isObject()) {
+                            continue;
+                        }
+                        // Validate and process the list property
+                        const list = rlAction.get('list');
+                        let listValue = '';
+                        if (list) {
+                            if (list.isRecord()) {
+                                listValue = `REL:${list.getId().getValue()}`;
+                            }
+                            else if (list.isString()) {
+                                const listStr = list.getValue();
+                                if ((0, sdk_build_core_1.isGUID)(listStr)) {
+                                    listValue = `REL:${listStr}`;
+                                }
+                                else if (listStr.includes('.')) {
+                                    const [table, field] = listStr.split('.');
+                                    if (!table || !field || listStr.split('.').length !== 2) {
+                                        diagnostics.error(list, `Related list action at index ${i}: 'list' property must be in 'table.field' format (e.g., 'incident.caller_id')`);
+                                        continue;
+                                    }
+                                    listValue = listStr;
+                                }
+                                else {
+                                    diagnostics.error(list, `Related list action at index ${i}: 'list' property must be either a Record<'sys_relationship'>, a GUID, or in 'table.field' format (e.g., 'incident.caller_id')`);
+                                    continue;
+                                }
+                            }
+                        }
+                        // At least one property must be specified (visible or list)
+                        const hasVisibleProp = isValidActionValue(rlAction.get('visible'));
+                        if (!hasVisibleProp && !listValue) {
+                            diagnostics.error(rlAction, `Related list action at index ${i} must specify at least one of: list or visible`);
+                            continue;
+                        }
+                        const rlActionRecord = await factory.createRecord({
+                            source: rlAction,
+                            table: SYS_UI_POLICY_RL_ACTION,
+                            properties: rlAction.transform(({ $ }) => ({
+                                list: $.val(listValue),
+                                ui_policy: $.val(policyRecord.getId()),
+                                visible: $.val(booleanToString(rlAction.get('visible'))),
+                            })),
+                        });
+                        relatedListActionRecords.push(rlActionRecord);
+                    }
+                }
+                return { success: true, value: policyRecord.with(...actionRecords, ...relatedListActionRecords) };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=ui-policy-plugin.js.map

package/dist/ui-policy-plugin.js.map

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

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import { ts, type Shape, type ObjectShape, type Diagnostics } from '@servicenow/sdk-build-core';
+import { ts, type Shape, type ObjectShape, type Diagnostics, type Compiler, type PluginApiDoc } from '@servicenow/sdk-build-core';
 export declare function toReference(shape: Shape): string | import("@servicenow/sdk-build-core").RecordId;
 /**
  * Reverses an object, swapping keys and values. **reverseObject** should only be used
@@ -15,3 +15,21 @@ export declare const INVALID_XML_CHARACTERS: RegExp;
 export declare function applyPathMappings(path: string, mappings: Record<string, string>): string;
 export declare function getCallExpressionName(node: ts.CallExpression): string;
 export declare function generateDeprecatedDiagnostics(object: ObjectShape, diagnostics: Diagnostics): void;
+/**
+ * Validates that client-side scripts (Client Scripts and UI Policy scripts) don't contain
+ * import or require statements. These scripts run in the browser and cannot use module imports.
+ *
+ * @param script - The script content to validate
+ * @param compiler - The TypeScript compiler instance
+ * @returns true if the script is valid (no imports/requires), false otherwise
+ */
+export declare function validateClientSideScript(script: string, compiler: Compiler): boolean;
+/**
+ * Creates a documentation entry for first-party SDK plugins.
+ * Using this helper ensures apiName and docPath are always in sync.
+ *
+ * @param apiName - The API name (e.g., 'BusinessRule', 'Acl')
+ * @param tags - Keywords for categorization (typically includes the ServiceNow table name)
+ * @returns A complete PluginApiDoc entry
+ */
+export declare function createSdkDocEntry(apiName: string, tags: string[]): PluginApiDoc;

package/dist/utils.js

@@ -7,6 +7,8 @@ exports.noThrow = noThrow;
 exports.applyPathMappings = applyPathMappings;
 exports.getCallExpressionName = getCallExpressionName;
 exports.generateDeprecatedDiagnostics = generateDeprecatedDiagnostics;
+exports.validateClientSideScript = validateClientSideScript;
+exports.createSdkDocEntry = createSdkDocEntry;
 const sdk_build_core_1 = require("@servicenow/sdk-build-core");
 function toReference(shape) {
     return shape.ifRecord()?.getId() ?? shape.ifString()?.getValue() ?? '';
@@ -69,4 +71,42 @@ function generateDeprecatedDiagnostics(object, diagnostics) {
         }
     });
 }
+/**
+ * Helper function to check if a call expression is a require statement
+ */
+function isRequire(callExpression) {
+    const expression = callExpression.getExpression();
+    return sdk_build_core_1.ts.Node.isIdentifier(expression) && expression.getText() === 'require';
+}
+/**
+ * Validates that client-side scripts (Client Scripts and UI Policy scripts) don't contain
+ * import or require statements. These scripts run in the browser and cannot use module imports.
+ *
+ * @param script - The script content to validate
+ * @param compiler - The TypeScript compiler instance
+ * @returns true if the script is valid (no imports/requires), false otherwise
+ */
+function validateClientSideScript(script, compiler) {
+    const source = compiler.createSourceFile('tmp-script.ts', script);
+    const hasImports = source.getDescendantsOfKind(sdk_build_core_1.ts.SyntaxKind.ImportDeclaration).length > 0;
+    const hasRequires = source.getDescendantsOfKind(sdk_build_core_1.ts.SyntaxKind.CallExpression).some(isRequire);
+    const isValid = !(hasImports || hasRequires);
+    compiler.removeSourceFile(source);
+    return isValid;
+}
+/**
+ * Creates a documentation entry for first-party SDK plugins.
+ * Using this helper ensures apiName and docPath are always in sync.
+ *
+ * @param apiName - The API name (e.g., 'BusinessRule', 'Acl')
+ * @param tags - Keywords for categorization (typically includes the ServiceNow table name)
+ * @returns A complete PluginApiDoc entry
+ */
+function createSdkDocEntry(apiName, tags) {
+    return {
+        apiName,
+        docPath: `@servicenow/sdk/docs/${apiName}/${apiName}.md`,
+        tags,
+    };
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAEA,kCAEC;AAQD,sCASC;AAED,0BAMC;AASD,8CAYC;AAED,sDAOC;AAED,sEAOC;AApED,+DAA+F;AAE/F,SAAgB,WAAW,CAAC,KAAY;IACpC,OAAO,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC1E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAqC,GAAiB;IAC/E,MAAM,QAAQ,GAAG,EAAkB,CAAA;IACnC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAA;QACzB,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAA;AACnB,CAAC;AAED,SAAgB,OAAO,CAAI,MAAe;IACtC,IAAI,CAAC;QACD,OAAO,MAAM,EAAE,CAAA;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,KAAc,CAAA;IACzB,CAAC;AACL,CAAC;AAED;;GAEG;AACU,QAAA,sBAAsB;AAC/B,+EAA+E;AAC/E,gHAAgH,CAAA;AAEpH,SAAgB,iBAAiB,CAAC,IAAY,EAAE,QAAgC;IAC5E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACf,CAAC;IACD,gIAAgI;IAChI,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACvC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AAED,SAAgB,qBAAqB,CAAC,IAAuB;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;IACvC,IAAI,mBAAE,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,mBAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,CAAC;QACrF,OAAO,UAAU,CAAC,OAAO,EAAE,CAAA;IAC/B,CAAC;IAED,MAAM,wCAAwC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAA;AACxE,CAAC;AAED,SAAgB,6BAA6B,CAAC,MAAmB,EAAE,WAAwB;IACvF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,KAAK,EAAE,CAAC;YACR,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,yBAAyB,GAAG,YAAY,CAAC,CAAA;QACrG,CAAC;IACL,CAAC,CAAC,CAAA;AACN,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/ux-list-menu-config-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from '@servicenow/sdk-build-core';
+export declare const UxListMenuConfigPlugin: Plugin;