@typespec/compiler 0.63.0-dev.1 → 0.63.0-dev.3

package/dist/src/core/visibility/core.js

@@ -0,0 +1,483 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+// TypeSpec Visibility System
+// --------------------------
+// This module defines the core visibility system of the TypeSpec language. The
+// visibility system is used to decide when properties of a _conceptual resource_
+// are present. The system is based on the concept of _visibility classes_,
+// represented by TypeSpec enums. Each visibility class has a set of _visibility
+// modifiers_ that can be applied to a model property, each modifier represented
+// by a member of the visibility class enum.
+//
+// Each visibility class has a _default modifier set_ that is used when no
+// modifiers are specified for a property, and each property has an _active
+// modifier set_ that is used when analyzing the visibility of the property.
+//
+// Visibility can be _sealed_ for a program, property, or visibility class
+// within a property. Once visibility is sealed, it cannot be unsealed, and any
+// attempts to modify a sealed visibility will fail.
+import { compilerAssert } from "../diagnostics.js";
+import { reportDiagnostic } from "../messages.js";
+import { getLifecycleVisibilityEnum, normalizeLegacyLifecycleVisibilityString, } from "./lifecycle.js";
+import { useStateMap, useStateSet } from "../../lib/utils.js";
+/**
+ * The global visibility store.
+ *
+ * This store is used to track the visibility modifiers
+ */
+const [getVisibilityStore, setVisibilityStore] = useStateMap("visibilityStore");
+/**
+ * Returns the visibility modifiers for a given `property` within a `program`.
+ */
+function getOrInitializeVisibilityModifiers(program, property) {
+    let visibilityModifiers = getVisibilityStore(program, property);
+    if (!visibilityModifiers) {
+        visibilityModifiers = new Map();
+        setVisibilityStore(program, property, visibilityModifiers);
+    }
+    return visibilityModifiers;
+}
+/**
+ * Returns the active visibility modifier set for a given `property` and `visibilityClass`.
+ *
+ * If no visibility modifiers have been set for the given `property` and `visibilityClass`, the function will use the
+ * provided `defaultSet` to initialize the visibility modifiers.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to get visibility modifiers for
+ * @param visibilityClass - the visibility class to get visibility modifiers for
+ * @param defaultSet - the default set to use if no set has been initialized
+ * @returns the active visibility modifier set for the given property and visibility class
+ */
+function getOrInitializeActiveModifierSetForClass(program, property, visibilityClass, defaultSet) {
+    const visibilityModifiers = getOrInitializeVisibilityModifiers(program, property);
+    let visibilityModifierSet = visibilityModifiers.get(visibilityClass);
+    if (!visibilityModifierSet) {
+        visibilityModifierSet = defaultSet;
+        visibilityModifiers.set(visibilityClass, visibilityModifierSet);
+    }
+    return visibilityModifierSet;
+}
+/**
+ * If a Program is in this set, visibility is sealed for all properties in that Program.
+ */
+const VISIBILITY_PROGRAM_SEALS = new WeakSet();
+const [isVisibilitySealedForProperty, sealVisibilityForProperty] = useStateSet("propertyVisibilitySealed");
+const [getSealedVisibilityClasses, setSealedVisibilityClasses] = useStateMap("sealedVisibilityClasses");
+/**
+ * Seals visibility modifiers for a property in a given visibility class.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to seal visibility modifiers for
+ * @param visibilityClass - the visibility class to seal visibility modifiers for
+ */
+function sealVisibilityModifiersForClass(program, property, visibilityClass) {
+    let sealedClasses = getSealedVisibilityClasses(program, property);
+    if (!sealedClasses) {
+        sealedClasses = new Set();
+        setSealedVisibilityClasses(program, property, sealedClasses);
+    }
+    sealedClasses.add(visibilityClass);
+}
+/**
+ * Stores the default modifier set for a given visibility class.
+ */
+const [getDefaultModifiers, setDefaultModifiers] = useStateMap("defaultVisibilityModifiers");
+/**
+ * Gets the default modifier set for a visibility class. If no default modifier set has been set, this function will
+ * initialize the default modifier set to ALL the visibility class's members.
+ *
+ * @param program - the program in which the visibility class occurs
+ * @param visibilityClass - the visibility class to get the default modifier set for
+ * @returns the default modifier set for the visibility class
+ */
+function getDefaultModifierSetForClass(program, visibilityClass) {
+    const cached = getDefaultModifiers(program, visibilityClass);
+    if (cached)
+        return cached;
+    const defaultModifierSet = new Set(visibilityClass.members.values());
+    setDefaultModifiers(program, visibilityClass, defaultModifierSet);
+    return defaultModifierSet;
+}
+/**
+ * Set the default visibility modifier set for a visibility class.
+ *
+ * This function may only be called ONCE per visibility class and must be called
+ * before the default modifier set is used by any operation.
+ */
+export function setDefaultModifierSetForVisibilityClass(program, visibilityClass, defaultSet) {
+    compilerAssert(!getDefaultModifiers(program, visibilityClass), "The default modifier set for a visibility class may only be set once.");
+    setDefaultModifiers(program, visibilityClass, defaultSet);
+}
+/**
+ * Convert a sequence of visibility modifiers into a map of visibility classes to their respective modifiers in the
+ * sequence.
+ *
+ * @param modifiers - the visibility modifiers to group
+ * @returns a map of visibility classes to their respective modifiers in the input list
+ */
+function groupModifiersByVisibilityClass(modifiers) {
+    const enumMap = new Map();
+    // Prepare new modifier sets for each visibility class
+    for (const modifier of modifiers) {
+        const visibilityClass = modifier.enum;
+        let modifierSet = enumMap.get(visibilityClass);
+        if (!modifierSet) {
+            modifierSet = new Set();
+            enumMap.set(visibilityClass, modifierSet);
+        }
+        modifierSet.add(modifier);
+    }
+    return enumMap;
+}
+// #region Legacy Visibility API
+const [getLegacyVisibility, setLegacyVisibilityModifiers, getLegacyVisibilityStateMap] = useStateMap("legacyVisibility");
+export { getLegacyVisibility };
+/**
+ * Sets the legacy visibility modifiers for a property.
+ *
+ * This function will also set the visibility modifiers for the property in the Lifecycle visibility class for any
+ * strings in the visibility array that are recognized as lifecycle visibility strings.
+ *
+ * Calling this function twice on the same property will result in a failed compiler assertion.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to set visibility modifiers for
+ * @param visibilities - the legacy visibility strings to set
+ */
+export function setLegacyVisibility(context, property, visibilities) {
+    const { program } = context;
+    setLegacyVisibilityModifiers(program, property, visibilities);
+    const lifecycleClass = getLifecycleVisibilityEnum(program);
+    clearVisibilityModifiersForClass(program, property, lifecycleClass, context);
+    const isEmpty = visibilities.length === 0 || (visibilities.length === 1 && visibilities[0] === "none");
+    if (!isEmpty) {
+        const lifecycleVisibilities = visibilities
+            .map((v) => normalizeLegacyLifecycleVisibilityString(program, v))
+            .filter((v) => !!v);
+        addVisibilityModifiers(program, property, lifecycleVisibilities);
+    }
+}
+/**
+ * Removes legacy visibility modifiers from a property.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to remove visibility modifiers from
+ */
+export function clearLegacyVisibility(program, property) {
+    getLegacyVisibilityStateMap(program).delete(property);
+}
+/**
+ * Returns the legacy visibility modifiers for a property.
+ *
+ * For a property using the enum-driven visibility system, the active Lifecycle visibility modifiers will be converted
+ * to strings for backwards compatibility as follows:
+ *
+ * - If Lifecycle visibility is not explicitly set, and no legacy visibility is set, this function will return `undefined`.
+ * - If the property has no active Lifecycle visibility modifiers, this function will return `["none"]`.
+ * - Otherwise, this function will return an array of lowercase strings representing the active Lifecycle visibility
+ *   modifiers ("create", "read", "update").
+ *
+ * @deprecated Use `getVisibilityForClass` instead.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to get legacy visibility modifiers for
+ */
+export function getVisibility(program, property) {
+    const legacyModifiers = getLegacyVisibility(program, property);
+    if (legacyModifiers)
+        return legacyModifiers;
+    // Now check for applied lifecycle visibility modifiers and coerce them if necessary.
+    const lifecycleModifiers = getVisibilityStore(program, property)?.get(getLifecycleVisibilityEnum(program));
+    // Visibility is completely uninitialized, so return undefined to mimic legacy behavior.
+    if (!lifecycleModifiers)
+        return undefined;
+    // Visibility has been cleared explicitly, so return [] to mimic legacy behavior.
+    if (lifecycleModifiers.size === 0)
+        return [];
+    // Otherwise we just convert the modifiers to strings.
+    return Array.from(lifecycleModifiers).map((v) => v.name.toLowerCase());
+}
+// #endregion
+// #region Visibility Management API
+/**
+ * Check if a property has had its visibility modifiers sealed.
+ *
+ * If the property has been sealed globally, this function will return true. If the property has been sealed for the
+ * given visibility class, this function will return true.
+ *
+ * Otherwise, this function returns false.
+ *
+ * @param property - the property to check
+ * @param visibilityClass - the optional visibility class to check
+ * @returns true if the property is sealed for the given visibility class, false otherwise
+ */
+export function isSealed(program, property, visibilityClass) {
+    if (VISIBILITY_PROGRAM_SEALS.has(program))
+        return true;
+    const classSealed = visibilityClass
+        ? getSealedVisibilityClasses(program, property)?.has(visibilityClass)
+        : false;
+    return classSealed || isVisibilitySealedForProperty(program, property);
+}
+/**
+ * Seals a property's visibility modifiers.
+ *
+ * If the `visibilityClass` is provided, the property's visibility modifiers will be sealed for that visibility class
+ * only. Otherwise, the property's visibility modifiers will be sealed for all visibility classes (globally).
+ *
+ * @param property - the property to seal
+ * @param visibilityClass - the optional visibility class to seal the property for
+ */
+export function sealVisibilityModifiers(program, property, visibilityClass) {
+    if (visibilityClass) {
+        sealVisibilityModifiersForClass(program, property, visibilityClass);
+    }
+    else {
+        sealVisibilityForProperty(program, property);
+    }
+}
+/**
+ * Seals a program's visibility modifiers.
+ *
+ * This affects all properties in the program and prevents any further modifications to visibility modifiers within the
+ * program.
+ *
+ * Once the modifiers for a program are sealed, they cannot be unsealed.
+ *
+ * @param program - the program to seal
+ */
+export function sealVisibilityModifiersForProgram(program) {
+    VISIBILITY_PROGRAM_SEALS.add(program);
+}
+/**
+ * Add visibility modifiers to a property.
+ *
+ * This function will add all the `modifiers` to the active set of visibility modifiers for the given `property`.
+ *
+ * If no set of active modifiers exists for the given `property`, an empty set will be created for the property.
+ *
+ * If the visibility modifiers for `property` in the given modifier's visibility class have been sealed, this function
+ * will issue a diagnostic and ignore that modifier, but it will still add the rest of the modifiers whose classes have
+ * not been sealed.
+ *
+ * @param program - the program in which the ModelProperty occurs
+ * @param property - the property to add visibility modifiers to
+ * @param modifiers - the visibility modifiers to add
+ * @param context - the optional decorator context to use for displaying diagnostics
+ */
+export function addVisibilityModifiers(program, property, modifiers, context) {
+    const modifiersByClass = groupModifiersByVisibilityClass(modifiers);
+    for (const [visibilityClass, newModifiers] of modifiersByClass.entries()) {
+        const target = context?.decoratorTarget ?? property;
+        if (isSealed(program, property, visibilityClass)) {
+            reportDiagnostic(program, {
+                code: "visibility-sealed",
+                format: {
+                    propName: property.name,
+                },
+                target,
+            });
+            continue;
+        }
+        const modifierSet = getOrInitializeActiveModifierSetForClass(program, property, visibilityClass, 
+        /* defaultSet: */ new Set());
+        for (const modifier of newModifiers) {
+            modifierSet.add(modifier);
+        }
+    }
+}
+/**
+ * Remove visibility modifiers from a property.
+ *
+ * This function will remove all the `modifiers` from the active set of visibility modifiers for the given `property`.
+ *
+ * If no set of active modifiers exists for the given `property`, the default set for the modifier's visibility class
+ * will be used.
+ *
+ * If the visibility modifiers for `property` in the given modifier's visibility class have been sealed, this function
+ * will issue a diagnostic and ignore that modifier, but it will still remove the rest of the modifiers whose classes
+ * have not been sealed.
+ *
+ * @param program - the program in which the ModelProperty occurs
+ * @param property - the property to remove visibility modifiers from
+ * @param modifiers - the visibility modifiers to remove
+ * @param context - the optional decorator context to use for displaying diagnostics
+ */
+export function removeVisibilityModifiers(program, property, modifiers, context) {
+    const modifiersByClass = groupModifiersByVisibilityClass(modifiers);
+    for (const [visibilityClass, newModifiers] of modifiersByClass.entries()) {
+        const target = context?.decoratorTarget ?? property;
+        if (isSealed(program, property, visibilityClass)) {
+            reportDiagnostic(program, {
+                code: "visibility-sealed",
+                format: {
+                    propName: property.name,
+                },
+                target,
+            });
+            continue;
+        }
+        const modifierSet = getOrInitializeActiveModifierSetForClass(program, property, visibilityClass, 
+        /* defaultSet: */ getDefaultModifierSetForClass(program, visibilityClass));
+        for (const modifier of newModifiers) {
+            modifierSet.delete(modifier);
+        }
+    }
+}
+/**
+ * Clears the visibility modifiers for a property in a given visibility class.
+ *
+ * If the visibility modifiers for the given class are sealed, this function will issue a diagnostic and leave the
+ * visibility modifiers unchanged.
+ *
+ * @param program - the program in which the ModelProperty occurs
+ * @param property - the property to clear visibility modifiers for
+ * @param visibilityClass - the visibility class to clear visibility modifiers for
+ * @param context - the optional decorator context to use for displaying diagnostics
+ */
+export function clearVisibilityModifiersForClass(program, property, visibilityClass, context) {
+    const target = context?.decoratorTarget ?? property;
+    if (isSealed(program, property, visibilityClass)) {
+        reportDiagnostic(program, {
+            code: "visibility-sealed",
+            format: {
+                propName: property.name,
+            },
+            target,
+        });
+        return;
+    }
+    const modifierSet = getOrInitializeActiveModifierSetForClass(program, property, visibilityClass, 
+    /* defaultSet: */ new Set());
+    modifierSet.clear();
+}
+/**
+ * Resets the visibility modifiers for a property in a given visibility class.
+ *
+ * This does not clear the modifiers. It resets them to the _uninitialized_ state.
+ *
+ * This is useful when cloning properties and you want to reset the visibility modifiers on the clone.
+ *
+ * If the visibility modifiers for this property and given visibility class are sealed, this function will issue a
+ * diagnostic and leave the visibility modifiers unchanged.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to reset visibility modifiers for
+ * @param visibilityClass - the visibility class to reset visibility modifiers for
+ * @param context - the optional decorator context to use for displaying diagnostics
+ */
+export function resetVisibilityModifiersForClass(program, property, visibilityClass, context) {
+    const target = context?.decoratorTarget ?? property;
+    if (isSealed(program, property, visibilityClass)) {
+        reportDiagnostic(program, {
+            code: "visibility-sealed",
+            format: {
+                propName: property.name,
+            },
+            target,
+        });
+        return;
+    }
+    getOrInitializeVisibilityModifiers(program, property).delete(visibilityClass);
+}
+// #endregion
+// #region Visibility Analysis API
+/**
+ * Returns the active visibility modifiers for a property in a given visibility class.
+ *
+ * This function is infallible. If the visibility modifiers for the given class have not been set explicitly, it will
+ * return the default visibility modifiers for the class.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to get visibility modifiers for
+ * @param visibilityClass - the visibility class to get visibility modifiers for
+ * @returns the set of active modifiers (enum members) for the property and visibility class
+ */
+export function getVisibilityForClass(program, property, visibilityClass) {
+    return getOrInitializeActiveModifierSetForClass(program, property, visibilityClass, 
+    /* defaultSet: */ getDefaultModifierSetForClass(program, visibilityClass));
+}
+/**
+ * Determines if a property has a specified visibility modifier.
+ *
+ * If no visibility modifiers have been set for the visibility class of the modifier, the visibility class's default
+ * modifier set is used.
+ *
+ * @param program - the program in which the property occurs
+ * @param property - the property to check
+ * @param modifier - the visibility modifier to check for
+ * @returns true if the property has the visibility modifier, false otherwise
+ */
+export function hasVisibility(program, property, modifier) {
+    const activeSet = getOrInitializeActiveModifierSetForClass(program, property, modifier.enum, 
+    /* defaultSet: */ getDefaultModifierSetForClass(program, modifier.enum));
+    return activeSet?.has(modifier) ?? false;
+}
+export const VisibilityFilter = {
+    /**
+     * Convert a TypeSpec `GeneratedVisibilityFilter` value to a `VisibilityFilter`.
+     *
+     * @param filter - the decorator argument filter to convert
+     * @returns a `VisibilityFilter` object that can be consumed by the visibility APIs
+     */
+    fromDecoratorArgument(filter) {
+        return {
+            all: filter.all && new Set(filter.all.map((v) => v.value)),
+            any: filter.any && new Set(filter.any.map((v) => v.value)),
+            none: filter.none && new Set(filter.none.map((v) => v.value)),
+        };
+    },
+    /**
+     * Extracts the unique visibility classes referred to by the modifiers in a
+     * visibility filter.
+     *
+     * @param filter - the visibility filter to extract visibility classes from
+     * @returns a set of visibility classes referred to by the filter
+     */
+    getVisibilityClasses(filter) {
+        const classes = new Set();
+        if (filter.all)
+            filter.all.forEach((v) => classes.add(v.enum));
+        if (filter.any)
+            filter.any.forEach((v) => classes.add(v.enum));
+        if (filter.none)
+            filter.none.forEach((v) => classes.add(v.enum));
+        return classes;
+    },
+};
+export function isVisible(program, property, _filterOrLegacyVisibilities) {
+    if (Array.isArray(_filterOrLegacyVisibilities)) {
+        return isVisibleLegacy(_filterOrLegacyVisibilities);
+    }
+    const filter = { ..._filterOrLegacyVisibilities };
+    filter.all ??= new Set();
+    filter.any ??= new Set();
+    filter.none ??= new Set();
+    // Validate that property has ALL of the required visibilities of filter.all
+    for (const modifier of filter.all) {
+        if (!hasVisibility(program, property, modifier))
+            return false;
+    }
+    // Validate that property has ANY of the required visibilities of filter.any
+    outer: while (filter.any.size > 0) {
+        for (const modifier of filter.any) {
+            if (hasVisibility(program, property, modifier))
+                break outer;
+        }
+        return false;
+    }
+    // Validate that property has NONE of the excluded visibilities of filter.none
+    for (const modifier of filter.none) {
+        if (hasVisibility(program, property, modifier))
+            return false;
+    }
+    return true;
+    function isVisibleLegacy(visibilities) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        const propertyVisibilities = getVisibility(program, property);
+        return !propertyVisibilities || propertyVisibilities.some((v) => visibilities.includes(v));
+    }
+}
+// #endregion
+//# sourceMappingURL=core.js.map

package/dist/src/core/visibility/core.js.map

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

package/dist/src/core/visibility/index.d.ts

@@ -0,0 +1,3 @@
+export { getLifecycleVisibilityEnum } from "./lifecycle.js";
+export { addVisibilityModifiers, clearVisibilityModifiersForClass, getVisibility, getVisibilityForClass, hasVisibility, isSealed, isVisible, removeVisibilityModifiers, resetVisibilityModifiersForClass, sealVisibilityModifiers, sealVisibilityModifiersForProgram, } from "./core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/visibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/visibility/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,WAAW,CAAC"}

package/dist/src/core/visibility/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+export { getLifecycleVisibilityEnum } from "./lifecycle.js";
+export { addVisibilityModifiers, clearVisibilityModifiersForClass, getVisibility, getVisibilityForClass, hasVisibility, isSealed, isVisible, removeVisibilityModifiers, resetVisibilityModifiersForClass, sealVisibilityModifiers, sealVisibilityModifiersForProgram, } from "./core.js";
+//# sourceMappingURL=index.js.map

package/dist/src/core/visibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/visibility/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kCAAkC;AAElC,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,WAAW,CAAC"}

package/dist/src/core/visibility/lifecycle.d.ts

@@ -0,0 +1,28 @@
+import type { Program } from "../program.js";
+import type { Enum, EnumMember } from "../types.js";
+/**
+ * Returns the instance of `TypeSpec.Visibility.Lifecycle` for the given `program`.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @returns a reference to the lifecycle visibility enum
+ */
+export declare function getLifecycleVisibilityEnum(program: Program): Enum;
+/**
+ * Returns the member of `Lifecycle` that corresponds to the given legacy `visibility` string.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @param visibility - the visibility string to normalize
+ * @returns the corresponding member of `Lifecycle` or `undefined` if the visibility string is not recognized
+ */
+export declare function normalizeLegacyLifecycleVisibilityString(program: Program, visibility: string): EnumMember | undefined;
+/**
+ * Returns the legacy visibility string that corresponds to the given `visibility` member of `Lifecycle`.
+ *
+ * If the given `visibility` member is not a member of `Lifecycle`, the function will return `undefined`.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @param visibility - the visibility modifier to normalize
+ * @returns the corresponding legacy visibility string or `undefined` if the visibility member is not recognized
+ */
+export declare function normalizeVisibilityToLegacyLifecycleString(program: Program, visibility: EnumMember): string | undefined;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/src/core/visibility/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/core/visibility/lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOpD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBjE;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,SAAS,CAYxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,GACrB,MAAM,GAAG,SAAS,CAepB"}

package/dist/src/core/visibility/lifecycle.js

@@ -0,0 +1,68 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+import { compilerAssert } from "../diagnostics.js";
+/**
+ * A cache for the `TypeSpec.Visibility.Lifecycle` enum per Program instance.
+ */
+const LIFECYCLE_ENUM_CACHE = new WeakMap();
+/**
+ * Returns the instance of `TypeSpec.Visibility.Lifecycle` for the given `program`.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @returns a reference to the lifecycle visibility enum
+ */
+export function getLifecycleVisibilityEnum(program) {
+    const cached = LIFECYCLE_ENUM_CACHE.get(program);
+    if (cached)
+        return cached;
+    const [type, diagnostics] = program.resolveTypeReference("TypeSpec.Lifecycle");
+    compilerAssert(diagnostics.length === 0, "Encountered diagnostics when resolving the `TypeSpec.Lifecycle` visibility class enum");
+    compilerAssert(type.kind === "Enum", "Expected `TypeSpec.Visibility.Lifecycle` to be an enum");
+    LIFECYCLE_ENUM_CACHE.set(program, type);
+    return type;
+}
+/**
+ * Returns the member of `Lifecycle` that corresponds to the given legacy `visibility` string.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @param visibility - the visibility string to normalize
+ * @returns the corresponding member of `Lifecycle` or `undefined` if the visibility string is not recognized
+ */
+export function normalizeLegacyLifecycleVisibilityString(program, visibility) {
+    const lifecycle = getLifecycleVisibilityEnum(program);
+    switch (visibility) {
+        case "create":
+            return lifecycle.members.get("Create");
+        case "read":
+            return lifecycle.members.get("Read");
+        case "update":
+            return lifecycle.members.get("Update");
+        default:
+            return undefined;
+    }
+}
+/**
+ * Returns the legacy visibility string that corresponds to the given `visibility` member of `Lifecycle`.
+ *
+ * If the given `visibility` member is not a member of `Lifecycle`, the function will return `undefined`.
+ *
+ * @param program - the program to get the lifecycle visibility enum for
+ * @param visibility - the visibility modifier to normalize
+ * @returns the corresponding legacy visibility string or `undefined` if the visibility member is not recognized
+ */
+export function normalizeVisibilityToLegacyLifecycleString(program, visibility) {
+    const lifecycle = getLifecycleVisibilityEnum(program);
+    if (visibility.enum !== lifecycle)
+        return undefined;
+    switch (visibility.name) {
+        case "Create":
+            return "create";
+        case "Read":
+            return "read";
+        case "Update":
+            return "update";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/core/visibility/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../../src/core/visibility/lifecycle.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kCAAkC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD;;GAEG;AACH,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAiB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAE/E,cAAc,CACZ,WAAW,CAAC,MAAM,KAAK,CAAC,EACxB,uFAAuF,CACxF,CAAC;IAEF,cAAc,CAAC,IAAK,CAAC,IAAI,KAAK,MAAM,EAAE,wDAAwD,CAAC,CAAC;IAEhG,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAExC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wCAAwC,CACtD,OAAgB,EAChB,UAAkB;IAElB,MAAM,SAAS,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACtD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QAC1C,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QAC1C;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0CAA0C,CACxD,OAAgB,EAChB,UAAsB;IAEtB,MAAM,SAAS,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAEtD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEpD,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/src/experimental/mutators.d.ts

@@ -55,6 +55,10 @@ export declare enum MutatorFlow {
 }
 /** @experimental */
 export type MutableType = Exclude<Type, TemplateParameter | IntrinsicType | FunctionType | Decorator | FunctionParameter | ObjectType | Projection | Namespace>;
+/**
+ * Determines if a type is mutable.
+ */
+export declare function isMutableType(type: Type): type is MutableType;
 /** @experimental */
 export type MutableTypeWithNamespace = MutableType | Namespace;
 /**

package/dist/src/experimental/mutators.d.ts.map

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