@typespec/emitter-framework 0.15.0-dev.3 → 0.15.0-dev.4

package/dist/src/python/test-utils.js

@@ -0,0 +1,25 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { Output } from "#core/components/index.js";
+import * as py from "@alloy-js/python";
+import { abcModule, datetimeModule, decimalModule, typingModule } from "./builtins.js";
+export const renderOptions = {
+  printWidth: 80,
+  tabWidth: 4
+};
+export function getOutput(program, children) {
+  const policy = py.createPythonNamePolicy();
+  return _$createComponent(Output, {
+    program: program,
+    get externals() {
+      return [abcModule, datetimeModule, decimalModule, typingModule, py.abcModule, py.dataclassesModule, py.enumModule];
+    },
+    namePolicy: policy,
+    get children() {
+      return _$createComponent(py.SourceFile, {
+        path: "test.py",
+        children: children
+      });
+    }
+  });
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/src/python/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Output","py","abcModule","datetimeModule","decimalModule","typingModule","renderOptions","printWidth","tabWidth","getOutput","program","children","policy","createPythonNamePolicy","_$createComponent","externals","dataclassesModule","enumModule","namePolicy","SourceFile","path"],"sources":["../../../src/python/test-utils.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,MAAM,QAAQ,2BAA2B;AAElD,OAAO,KAAKC,EAAE,MAAM,kBAAkB;AAEtC,SAASC,SAAS,EAAEC,cAAc,EAAEC,aAAa,EAAEC,YAAY,QAAQ,eAAe;AAEtF,OAAO,MAAMC,aAAa,GAAG;EAC3BC,UAAU,EAAE,EAAE;EACdC,QAAQ,EAAE;AACZ,CAAC;AAED,OAAO,SAASC,SAASA,CAACC,OAAgB,EAAEC,QAAoB,EAAY;EAC1E,MAAMC,MAAM,GAAGX,EAAE,CAACY,sBAAsB,CAAC,CAAC;EAC1C,OAAAC,iBAAA,CACGd,MAAM;IACLU,OAAO,EAAEA,OAAO;IAAA,IAChBK,SAASA,CAAA;MAAA,OAAE,CACTb,SAAS,EACTC,cAAc,EACdC,aAAa,EACbC,YAAY,EACZJ,EAAE,CAACC,SAAS,EACZD,EAAE,CAACe,iBAAiB,EACpBf,EAAE,CAACgB,UAAU,CACd;IAAA;IACDC,UAAU,EAAEN,MAAM;IAAA,IAAAD,SAAA;MAAA,OAAAG,iBAAA,CAEjBb,EAAE,CAACkB,UAAU;QAACC,IAAI;QAAAT,QAAA,EAAYA;MAAQ;IAAA;EAAA;AAG7C","ignoreList":[]}

package/dist/src/python/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./operation.js";
+export * from "./refkey.js";
+export * from "./type.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/python/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/python/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/src/python/utils/index.js

@@ -0,0 +1,4 @@
+export * from "./operation.js";
+export * from "./refkey.js";
+export * from "./type.js";
+//# sourceMappingURL=index.js.map

package/dist/src/python/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../../src/python/utils/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,aAAa;AAC3B,cAAc,WAAW","ignoreList":[]}

package/dist/src/python/utils/operation.d.ts

@@ -0,0 +1,27 @@
+import { type Refkey } from "@alloy-js/core";
+import * as py from "@alloy-js/python";
+import type { Model, ModelProperty, Operation, Type } from "@typespec/compiler";
+export declare function getReturnType(type: Operation, options?: {
+    skipErrorFiltering: boolean;
+}): Type;
+export interface BuildParameterDescriptorsOptions {
+    params?: (py.ParameterDescriptor | string)[];
+    suffixRefkey?: Refkey;
+    /** If true, params replaces operation parameters instead of adding to them */
+    replaceParameters?: boolean;
+}
+/**
+ * Build a parameter descriptor array from a TypeSpec Model.
+ *
+ * Parameter ordering (unless replaceParameters is true):
+ * - Operation params without defaults: positional (e.g., URL path params)
+ * - "*" marker (if any keyword-only params exist)
+ * - Operation params with defaults: keyword-only (e.g., query params)
+ * - Additional params: keyword-only
+ */
+export declare function buildParameterDescriptors(type: Model, options?: BuildParameterDescriptorsOptions): (py.ParameterDescriptor | string)[] | undefined;
+/**
+ * Convert a TypeSpec ModelProperty into a Python ParameterDescriptor.
+ */
+export declare function buildParameterDescriptor(modelProperty: ModelProperty, suffixRefkey: Refkey): py.ParameterDescriptor;
+//# sourceMappingURL=operation.d.ts.map

package/dist/src/python/utils/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../../src/python/utils/operation.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAMhF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,OAAO,GAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAkC,GACvE,IAAI,CASN;AAED,MAAM,WAAW,gCAAgC;IAC/C,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,gCAAqC,GAC7C,CAAC,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAwDjD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,MAAM,GACnB,EAAE,CAAC,mBAAmB,CAsBxB"}

package/dist/src/python/utils/operation.js

@@ -0,0 +1,139 @@
+import { typingModule } from "#python/builtins.js";
+import { refkey } from "@alloy-js/core";
+import * as py from "@alloy-js/python";
+import { useTsp } from "../../core/index.js";
+import { Atom } from "../components/atom/atom.js";
+import { TypeExpression } from "../components/type-expression/type-expression.js";
+import { efRefkey } from "./refkey.js";
+export function getReturnType(type, options = {
+  skipErrorFiltering: false
+}) {
+  const {
+    $
+  } = useTsp();
+  let returnType = type.returnType;
+  if (!options.skipErrorFiltering && type.returnType.kind === "Union") {
+    returnType = $.union.filter(type.returnType, variant => !$.type.isError(variant.type));
+  }
+  return returnType;
+}
+/**
+ * Build a parameter descriptor array from a TypeSpec Model.
+ *
+ * Parameter ordering (unless replaceParameters is true):
+ * - Operation params without defaults: positional (e.g., URL path params)
+ * - "*" marker (if any keyword-only params exist)
+ * - Operation params with defaults: keyword-only (e.g., query params)
+ * - Additional params: keyword-only
+ */
+export function buildParameterDescriptors(type, options = {}) {
+  const {
+    $
+  } = useTsp();
+  const suffixRefkey = options.suffixRefkey ?? refkey();
+  const optionsParams = normalizeParameters(options.params ?? []);
+
+  // If replaceParameters is true, ignore operation params and just return options params
+  // All replacement parameters are keyword-only (following "additional parameters are keyword-only" principle)
+  if (options.replaceParameters) {
+    const withoutDefaults = optionsParams.filter(p => p.default === undefined);
+    const withDefaults = optionsParams.filter(p => p.default !== undefined);
+
+    // Always add "*" marker since all replacement params should be keyword-only
+    const allParams = optionsParams.length > 0 ? ["*", ...withoutDefaults, ...withDefaults] : [];
+    return allParams;
+  }
+  const modelProperties = $.model.getProperties(type);
+  const operationParams = [...modelProperties.values()].map(m => buildParameterDescriptor(m, suffixRefkey));
+
+  // Split operation params: params without defaults are positional, params with defaults are keyword-only
+  const opParamsWithoutDefaults = operationParams.filter(p => p.default === undefined);
+  const opParamsWithDefaults = operationParams.filter(p => p.default !== undefined);
+
+  // Reorder additional params: params without defaults before params with defaults
+  const optionsWithoutDefaults = optionsParams.filter(p => p.default === undefined);
+  const optionsWithDefaults = optionsParams.filter(p => p.default !== undefined);
+
+  // Build final parameter list:
+  // - Operation params without defaults: positional (e.g., URL path params)
+  // - "*" marker (if there are keyword-only params)
+  // - Operation params with defaults: keyword-only (e.g., query params with defaults)
+  // - Additional params: keyword-only
+
+  // If there are no operation params at all, treat additional params without defaults as positional
+  const hasOperationParams = operationParams.length > 0;
+  const positionalParams = hasOperationParams ? opParamsWithoutDefaults : [...opParamsWithoutDefaults, ...optionsWithoutDefaults];
+  const keywordOnlyParams = hasOperationParams ? [...optionsWithoutDefaults, ...opParamsWithDefaults, ...optionsWithDefaults] : [...opParamsWithDefaults, ...optionsWithDefaults];
+
+  // Add "*" marker if we have keyword-only params
+  // This enforces that params with defaults are truly keyword-only
+  const allParams = keywordOnlyParams.length > 0 ? [...positionalParams, "*", ...keywordOnlyParams] : [...positionalParams];
+  return allParams;
+}
+
+/**
+ * Convert a TypeSpec ModelProperty into a Python ParameterDescriptor.
+ */
+export function buildParameterDescriptor(modelProperty, suffixRefkey) {
+  const {
+    $
+  } = useTsp();
+  const namePolicy = py.usePythonNamePolicy();
+  const paramName = namePolicy.getName(modelProperty.name, "parameter");
+  const isOptional = modelProperty.optional || modelProperty.defaultValue !== undefined;
+  const doc = $.type.getDoc(modelProperty);
+  let defaultValueNode = undefined;
+  const hasDefault = modelProperty.defaultValue !== undefined && modelProperty.defaultValue !== null;
+  if (hasDefault) {
+    defaultValueNode = Atom({
+      value: modelProperty.defaultValue
+    });
+  } else if (isOptional) {
+    // Render Python None for optional parameters without explicit default
+    defaultValueNode = py.Atom({
+      jsValue: null
+    });
+  }
+  return {
+    doc,
+    name: paramName,
+    refkey: efRefkey(modelProperty, suffixRefkey),
+    type: TypeExpression({
+      type: modelProperty.type
+    }),
+    ...(defaultValueNode !== undefined ? {
+      default: defaultValueNode
+    } : {})
+  };
+}
+const rawTypeMap = {
+  string: "str",
+  number: "float",
+  boolean: "bool",
+  any: typingModule["."]["Any"],
+  never: typingModule["."]["Never"]
+};
+
+/**
+ * Convert a parameter descriptor array to normalized parameter descriptors.
+ * String parameter names are converted to basic parameter descriptors.
+ */
+function normalizeParameters(params) {
+  if (!params) return [];
+  return params.map(param => {
+    if (typeof param === "string") {
+      // Convert string names to parameter descriptors
+      return {
+        name: param
+      };
+    }
+    if (typeof param.type === "string") {
+      return {
+        ...param,
+        type: rawTypeMap[param.type] ?? param.type
+      };
+    }
+    return param;
+  });
+}
+//# sourceMappingURL=operation.js.map

package/dist/src/python/utils/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["typingModule","refkey","py","useTsp","Atom","TypeExpression","efRefkey","getReturnType","type","options","skipErrorFiltering","$","returnType","kind","union","filter","variant","isError","buildParameterDescriptors","suffixRefkey","optionsParams","normalizeParameters","params","replaceParameters","withoutDefaults","p","default","undefined","withDefaults","allParams","length","modelProperties","model","getProperties","operationParams","values","map","m","buildParameterDescriptor","opParamsWithoutDefaults","opParamsWithDefaults","optionsWithoutDefaults","optionsWithDefaults","hasOperationParams","positionalParams","keywordOnlyParams","modelProperty","namePolicy","usePythonNamePolicy","paramName","getName","name","isOptional","optional","defaultValue","doc","getDoc","defaultValueNode","hasDefault","value","jsValue","rawTypeMap","string","number","boolean","any","never","param"],"sources":["../../../../src/python/utils/operation.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,YAAY,QAAQ,qBAAqB;AAClD,SAASC,MAAM,QAAoC,gBAAgB;AACnE,OAAO,KAAKC,EAAE,MAAM,kBAAkB;AAEtC,SAASC,MAAM,QAAQ,qBAAqB;AAC5C,SAASC,IAAI,QAAQ,4BAA4B;AACjD,SAASC,cAAc,QAAQ,kDAAkD;AACjF,SAASC,QAAQ,QAAQ,aAAa;AAEtC,OAAO,SAASC,aAAaA,CAC3BC,IAAe,EACfC,OAAwC,GAAG;EAAEC,kBAAkB,EAAE;AAAM,CAAC,EAClE;EACN,MAAM;IAAEC;EAAE,CAAC,GAAGR,MAAM,CAAC,CAAC;EACtB,IAAIS,UAAU,GAAGJ,IAAI,CAACI,UAAU;EAEhC,IAAI,CAACH,OAAO,CAACC,kBAAkB,IAAIF,IAAI,CAACI,UAAU,CAACC,IAAI,KAAK,OAAO,EAAE;IACnED,UAAU,GAAGD,CAAC,CAACG,KAAK,CAACC,MAAM,CAACP,IAAI,CAACI,UAAU,EAAGI,OAAO,IAAK,CAACL,CAAC,CAACH,IAAI,CAACS,OAAO,CAACD,OAAO,CAACR,IAAI,CAAC,CAAC;EAC1F;EAEA,OAAOI,UAAU;AACnB;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,yBAAyBA,CACvCV,IAAW,EACXC,OAAyC,GAAG,CAAC,CAAC,EACG;EACjD,MAAM;IAAEE;EAAE,CAAC,GAAGR,MAAM,CAAC,CAAC;EACtB,MAAMgB,YAAY,GAAGV,OAAO,CAACU,YAAY,IAAIlB,MAAM,CAAC,CAAC;EACrD,MAAMmB,aAAuC,GAAGC,mBAAmB,CAACZ,OAAO,CAACa,MAAM,IAAI,EAAE,CAAC;;EAEzF;EACA;EACA,IAAIb,OAAO,CAACc,iBAAiB,EAAE;IAC7B,MAAMC,eAAe,GAAGJ,aAAa,CAACL,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;IAC5E,MAAMC,YAAY,GAAGR,aAAa,CAACL,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;;IAEzE;IACA,MAAME,SAA8C,GAClDT,aAAa,CAACU,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAGN,eAAe,EAAE,GAAGI,YAAY,CAAC,GAAG,EAAE;IAE5E,OAAOC,SAAS;EAClB;EAEA,MAAME,eAAe,GAAGpB,CAAC,CAACqB,KAAK,CAACC,aAAa,CAACzB,IAAI,CAAC;EACnD,MAAM0B,eAAyC,GAAG,CAAC,GAAGH,eAAe,CAACI,MAAM,CAAC,CAAC,CAAC,CAACC,GAAG,CAAEC,CAAC,IACpFC,wBAAwB,CAACD,CAAC,EAAElB,YAAY,CAC1C,CAAC;;EAED;EACA,MAAMoB,uBAAuB,GAAGL,eAAe,CAACnB,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;EACtF,MAAMa,oBAAoB,GAAGN,eAAe,CAACnB,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;;EAEnF;EACA,MAAMc,sBAAsB,GAAGrB,aAAa,CAACL,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;EACnF,MAAMe,mBAAmB,GAAGtB,aAAa,CAACL,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,OAAO,KAAKC,SAAS,CAAC;;EAEhF;EACA;EACA;EACA;EACA;;EAEA;EACA,MAAMgB,kBAAkB,GAAGT,eAAe,CAACJ,MAAM,GAAG,CAAC;EAErD,MAAMc,gBAAgB,GAAGD,kBAAkB,GACvCJ,uBAAuB,GACvB,CAAC,GAAGA,uBAAuB,EAAE,GAAGE,sBAAsB,CAAC;EAE3D,MAAMI,iBAAiB,GAAGF,kBAAkB,GACxC,CAAC,GAAGF,sBAAsB,EAAE,GAAGD,oBAAoB,EAAE,GAAGE,mBAAmB,CAAC,GAC5E,CAAC,GAAGF,oBAAoB,EAAE,GAAGE,mBAAmB,CAAC;;EAErD;EACA;EACA,MAAMb,SAA8C,GAClDgB,iBAAiB,CAACf,MAAM,GAAG,CAAC,GACxB,CAAC,GAAGc,gBAAgB,EAAE,GAAG,EAAE,GAAGC,iBAAiB,CAAC,GAChD,CAAC,GAAGD,gBAAgB,CAAC;EAE3B,OAAOf,SAAS;AAClB;;AAEA;AACA;AACA;AACA,OAAO,SAASS,wBAAwBA,CACtCQ,aAA4B,EAC5B3B,YAAoB,EACI;EACxB,MAAM;IAAER;EAAE,CAAC,GAAGR,MAAM,CAAC,CAAC;EACtB,MAAM4C,UAAU,GAAG7C,EAAE,CAAC8C,mBAAmB,CAAC,CAAC;EAC3C,MAAMC,SAAS,GAAGF,UAAU,CAACG,OAAO,CAACJ,aAAa,CAACK,IAAI,EAAE,WAAW,CAAC;EACrE,MAAMC,UAAU,GAAGN,aAAa,CAACO,QAAQ,IAAIP,aAAa,CAACQ,YAAY,KAAK3B,SAAS;EACrF,MAAM4B,GAAG,GAAG5C,CAAC,CAACH,IAAI,CAACgD,MAAM,CAACV,aAAa,CAAC;EACxC,IAAIW,gBAAsC,GAAG9B,SAAS;EACtD,MAAM+B,UAAU,GACdZ,aAAa,CAACQ,YAAY,KAAK3B,SAAS,IAAImB,aAAa,CAACQ,YAAY,KAAK,IAAI;EACjF,IAAII,UAAU,EAAE;IACdD,gBAAgB,GAAGrD,IAAI,CAAC;MAAEuD,KAAK,EAAGb,aAAa,CAASQ;IAAa,CAAC,CAAC;EACzE,CAAC,MAAM,IAAIF,UAAU,EAAE;IACrB;IACAK,gBAAgB,GAAGvD,EAAE,CAACE,IAAI,CAAC;MAAEwD,OAAO,EAAE;IAAK,CAAC,CAAQ;EACtD;EACA,OAAO;IACLL,GAAG;IACHJ,IAAI,EAAEF,SAAS;IACfhD,MAAM,EAAEK,QAAQ,CAACwC,aAAa,EAAE3B,YAAY,CAAC;IAC7CX,IAAI,EAAEH,cAAc,CAAC;MAAEG,IAAI,EAAEsC,aAAa,CAACtC;IAAK,CAAC,CAAC;IAClD,IAAIiD,gBAAgB,KAAK9B,SAAS,GAAG;MAAED,OAAO,EAAE+B;IAAiB,CAAC,GAAG,CAAC,CAAC;EACzE,CAAC;AACH;AAEA,MAAMI,UAAU,GAAG;EACjBC,MAAM,EAAE,KAAK;EACbC,MAAM,EAAE,OAAO;EACfC,OAAO,EAAE,MAAM;EACfC,GAAG,EAAEjE,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;EAC7BkE,KAAK,EAAElE,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO;AAClC,CAAC;;AAED;AACA;AACA;AACA;AACA,SAASqB,mBAAmBA,CAC1BC,MAA2C,EACjB;EAC1B,IAAI,CAACA,MAAM,EAAE,OAAO,EAAE;EAEtB,OAAOA,MAAM,CAACc,GAAG,CAAE+B,KAAK,IAAK;IAC3B,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MAC7B;MACA,OAAO;QAAEhB,IAAI,EAAEgB;MAAM,CAAC;IACxB;IACA,IAAI,OAAQA,KAAK,CAAS3D,IAAI,KAAK,QAAQ,EAAE;MAC3C,OAAO;QACL,GAAG2D,KAAK;QACR3D,IAAI,EAAEqD,UAAU,CAACM,KAAK,CAAC3D,IAAI,CAA4B,IAAI2D,KAAK,CAAC3D;MACnE,CAAC;IACH;IACA,OAAO2D,KAAK;EACd,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/src/python/utils/refkey.d.ts

@@ -0,0 +1,23 @@
+import { type Refkey } from "@alloy-js/core";
+/**
+ * A wrapper around `refkey` that uses a custom symbol to avoid collisions with
+ * other libraries that use `refkey`.
+ *
+ * @remarks
+ *
+ * The underlying refkey function is called with the {@link refKeyPrefix} symbol as the first argument.
+ *
+ * @param args The parameters of the refkey.
+ * @returns A refkey object that can be used to identify the value.
+ */
+export declare function efRefkey(...args: unknown[]): Refkey;
+/**
+ * Creates a refkey for a declaration by combining the provided refkey with an internal
+ * refkey generated from the provided arguments.
+ *
+ * @param refkey The refkey provided by the user to be passed as is.
+ * @param args The parameters of the refkey.
+ * @returns An array of refkeys that can be passed to an Alloy declaration.
+ */
+export declare function declarationRefkeys(refkey?: Refkey | Refkey[], ...args: unknown[]): Refkey[];
+//# sourceMappingURL=refkey.d.ts.map

package/dist/src/python/utils/refkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refkey.d.ts","sourceRoot":"","sources":["../../../../src/python/utils/refkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIjE;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAKnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAK3F"}

package/dist/src/python/utils/refkey.js

@@ -0,0 +1,36 @@
+import { refkey as ayRefkey } from "@alloy-js/core";
+const refKeyPrefix = Symbol.for("emitter-framework:python");
+
+/**
+ * A wrapper around `refkey` that uses a custom symbol to avoid collisions with
+ * other libraries that use `refkey`.
+ *
+ * @remarks
+ *
+ * The underlying refkey function is called with the {@link refKeyPrefix} symbol as the first argument.
+ *
+ * @param args The parameters of the refkey.
+ * @returns A refkey object that can be used to identify the value.
+ */
+export function efRefkey(...args) {
+  if (args.length === 0) {
+    return ayRefkey(); // Generates a unique refkey
+  }
+  return ayRefkey(refKeyPrefix, ...args);
+}
+
+/**
+ * Creates a refkey for a declaration by combining the provided refkey with an internal
+ * refkey generated from the provided arguments.
+ *
+ * @param refkey The refkey provided by the user to be passed as is.
+ * @param args The parameters of the refkey.
+ * @returns An array of refkeys that can be passed to an Alloy declaration.
+ */
+export function declarationRefkeys(refkey, ...args) {
+  if (refkey) {
+    return [refkey, efRefkey(...args)].flat();
+  }
+  return [efRefkey(...args)];
+}
+//# sourceMappingURL=refkey.js.map

package/dist/src/python/utils/refkey.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["refkey","ayRefkey","refKeyPrefix","Symbol","for","efRefkey","args","length","declarationRefkeys","flat"],"sources":["../../../../src/python/utils/refkey.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAM,IAAIC,QAAQ,QAAqB,gBAAgB;AAEhE,MAAMC,YAAY,GAAGC,MAAM,CAACC,GAAG,CAAC,0BAA0B,CAAC;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAC,GAAGC,IAAe,EAAU;EACnD,IAAIA,IAAI,CAACC,MAAM,KAAK,CAAC,EAAE;IACrB,OAAON,QAAQ,CAAC,CAAC,CAAC,CAAC;EACrB;EACA,OAAOA,QAAQ,CAACC,YAAY,EAAE,GAAGI,IAAI,CAAC;AACxC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,kBAAkBA,CAACR,MAA0B,EAAE,GAAGM,IAAe,EAAY;EAC3F,IAAIN,MAAM,EAAE;IACV,OAAO,CAACA,MAAM,EAAEK,QAAQ,CAAC,GAAGC,IAAI,CAAC,CAAC,CAACG,IAAI,CAAC,CAAC;EAC3C;EACA,OAAO,CAACJ,QAAQ,CAAC,GAAGC,IAAI,CAAC,CAAC;AAC5B","ignoreList":[]}

package/dist/src/python/utils/type.d.ts

@@ -0,0 +1,19 @@
+import type { Typekit } from "@typespec/compiler/typekit";
+/**
+ * Check if a type is a literal type (string, numeric, boolean, or union variant).
+ * This is useful for determining if a type can be used in a Python Literal[] type.
+ *
+ * @param $ - The Typekit instance
+ * @param type - The type to check
+ * @returns true if the type is a literal type
+ */
+export declare function isLiteral($: Typekit, type: any): boolean;
+/**
+ * Check if all types in an array are literal types.
+ *
+ * @param $ - The Typekit instance
+ * @param types - Array of types to check
+ * @returns true if all types are literals
+ */
+export declare function areAllLiterals($: Typekit, types: any[]): boolean;
+//# sourceMappingURL=type.d.ts.map

package/dist/src/python/utils/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/python/utils/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CASxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAEhE"}

package/dist/src/python/utils/type.js

@@ -0,0 +1,24 @@
+/**
+ * Check if a type is a literal type (string, numeric, boolean, or union variant).
+ * This is useful for determining if a type can be used in a Python Literal[] type.
+ *
+ * @param $ - The Typekit instance
+ * @param type - The type to check
+ * @returns true if the type is a literal type
+ */
+export function isLiteral($, type) {
+  if (!type) return false;
+  return $.literal.isString(type) || $.literal.isNumeric(type) || $.literal.isBoolean(type) || type.kind === "UnionVariant";
+}
+
+/**
+ * Check if all types in an array are literal types.
+ *
+ * @param $ - The Typekit instance
+ * @param types - Array of types to check
+ * @returns true if all types are literals
+ */
+export function areAllLiterals($, types) {
+  return types.every(type => isLiteral($, type));
+}
+//# sourceMappingURL=type.js.map

package/dist/src/python/utils/type.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isLiteral","$","type","literal","isString","isNumeric","isBoolean","kind","areAllLiterals","types","every"],"sources":["../../../../src/python/utils/type.ts"],"sourcesContent":[null],"mappings":"AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,SAASA,CAACC,CAAU,EAAEC,IAAS,EAAW;EACxD,IAAI,CAACA,IAAI,EAAE,OAAO,KAAK;EAEvB,OACED,CAAC,CAACE,OAAO,CAACC,QAAQ,CAACF,IAAI,CAAC,IACxBD,CAAC,CAACE,OAAO,CAACE,SAAS,CAACH,IAAI,CAAC,IACzBD,CAAC,CAACE,OAAO,CAACG,SAAS,CAACJ,IAAI,CAAC,IACzBA,IAAI,CAACK,IAAI,KAAK,cAAc;AAEhC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACP,CAAU,EAAEQ,KAAY,EAAW;EAChE,OAAOA,KAAK,CAACC,KAAK,CAAER,IAAI,IAAKF,SAAS,CAACC,CAAC,EAAEC,IAAI,CAAC,CAAC;AAClD","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/emitter-framework",
-  "version": "0.15.0-dev.3",
+  "version": "0.15.0-dev.4",
   "type": "module",
   "main": "dist/index.js",
   "repository": {
@@ -17,6 +17,9 @@
     "./typescript": {
       "import": "./dist/src/typescript/index.js"
     },
+    "./python": {
+      "import": "./dist/src/python/index.js"
+    },
     "./testing": {
       "import": "./dist/src/testing/index.js"
     }
@@ -31,6 +34,9 @@
     },
     "#typescript/*": {
       "default": "./dist/src/typescript/*"
+    },
+    "#python/*": {
+      "default": "./dist/src/python/*"
     }
   },
   "keywords": [],
@@ -40,12 +46,14 @@
   "peerDependencies": {
     "@alloy-js/core": "^0.22.0",
     "@alloy-js/csharp": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "^1.7.1"
   },
   "devDependencies": {
     "@alloy-js/cli": "^0.22.0",
     "@alloy-js/core": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/rollup-plugin": "^0.1.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "^1.7.1",

package/package.json.bak

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/emitter-framework",
-  "version": "0.15.0-dev.3",
+  "version": "0.15.0-dev.4",
   "type": "module",
   "main": "dist/index.js",
   "repository": {
@@ -31,6 +31,9 @@
     "./typescript": {
       "import": "./dist/src/typescript/index.js"
     },
+    "./python": {
+      "import": "./dist/src/python/index.js"
+    },
     "./testing": {
       "import": "./dist/src/testing/index.js"
     }
@@ -48,6 +51,10 @@
     "#typescript/*": {
       "development": "./src/typescript/*",
       "default": "./dist/src/typescript/*"
+    },
+    "#python/*": {
+      "development": "./src/python/*",
+      "default": "./dist/src/python/*"
     }
   },
   "keywords": [],
@@ -57,12 +64,14 @@
   "peerDependencies": {
     "@alloy-js/core": "^0.22.0",
     "@alloy-js/csharp": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "^1.7.1"
   },
   "devDependencies": {
     "@alloy-js/cli": "^0.22.0",
     "@alloy-js/core": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/rollup-plugin": "^0.1.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "^1.7.1",

package/src/python/builtins.ts

@@ -0,0 +1,43 @@
+import type { SymbolCreator } from "@alloy-js/core";
+import { createModule } from "@alloy-js/python";
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+type dummy = SymbolCreator;
+
+export const abcModule = createModule({
+  name: "abc",
+  descriptor: {
+    ".": ["ABC"],
+  },
+});
+
+export const datetimeModule = createModule({
+  name: "datetime",
+  descriptor: {
+    ".": ["datetime", "date", "time", "timedelta", "timezone"],
+  },
+});
+
+export const decimalModule = createModule({
+  name: "decimal",
+  descriptor: {
+    ".": ["Decimal"],
+  },
+});
+
+export const typingModule = createModule({
+  name: "typing",
+  descriptor: {
+    ".": [
+      "Any",
+      "Callable",
+      "Generic",
+      "Literal",
+      "Never",
+      "Optional",
+      "Protocol",
+      "TypeAlias",
+      "TypeVar",
+    ],
+  },
+});

package/src/python/components/array-expression/array-expression.test.tsx

@@ -0,0 +1,14 @@
+import { Tester } from "#test/test-host.js";
+import { d } from "@alloy-js/core/testing";
+import { t } from "@typespec/compiler/testing";
+import { expect, it } from "vitest";
+import { getOutput } from "../../test-utils.js";
+import { TypeExpression } from "../type-expression/type-expression.js";
+
+it("maps array expression to Python list", async () => {
+  const { program, TestArray } = await Tester.compile(t.code`
+    alias ${t.type("TestArray")} = string[];
+  `);
+
+  expect(getOutput(program, [<TypeExpression type={TestArray} />])).toRenderTo(d`list[str]`);
+});

package/src/python/components/array-expression/array-expression.tsx

@@ -0,0 +1,11 @@
+import { code } from "@alloy-js/core";
+import type { Type } from "@typespec/compiler";
+import { TypeExpression } from "../type-expression/type-expression.js";
+
+export interface ArrayExpressionProps {
+  elementType: Type;
+}
+
+export function ArrayExpression({ elementType }: ArrayExpressionProps) {
+  return code`list[${(<TypeExpression type={elementType} />)}]`;
+}

package/src/python/components/array-expression/index.ts

@@ -0,0 +1 @@
+export * from "./array-expression.js";