shortcutkit 0.5.1 → 0.7.0

package/dist/index.d.ts

@@ -1,18 +1,47 @@
 import { type PlistValue } from "./plist.js";
+import { type ActionDefinition } from "./definitions.js";
+import { ACTIONS } from "./generated/actions.js";
 import type { ActionId, MetaParams, ParamTypes } from "./generated/actions.js";
 import type { Attachment, Picker, TokenString, Value } from "./values.js";
-export { actions, ACTIONS, type ActionId, type ActionKey, type ParamKey, type ParamTypes, type MetaParams } from "./generated/actions.js";
+export { actions, ACTIONS, PARAM_KINDS, type ActionId, type ActionKey, type ParamKey, type ParamTypes, type MetaParams } from "./generated/actions.js";
 export type { PlistValue } from "./plist.js";
 export type * from "./values.js";
 export { getDefinition, allDefinitions, type ActionDefinition, type ParameterDefinition, type Localized } from "./definitions.js";
 export { provenance, type Provenance } from "./provenance.js";
+export type * from "./generated/params.js";
 /** Parameters accepted for an identifier: typed per key for built-in actions, open for anything else. */
 export type ParamsFor<I extends string> = I extends ActionId ? Partial<ParamTypes[I] & MetaParams> : Record<string, Value>;
 export type Action = {
     WFWorkflowActionIdentifier: string;
     WFWorkflowActionParameters: Record<string, Value>;
     outputName?: string;
+    outputTypes?: readonly string[];
 };
+/** Content types an action's output can be (`WFStringContentItem`, `NSURL`, an App Intents entity, …). Shortcuts coerces between many of them at run time, so this describes, it does not restrict. */
+export type OutputTypes<I extends ActionId> = (typeof ACTIONS)[I]["outputTypes"];
+/** What the catalogue knows about an identifier: built-in or App Intent, engine definition or not. */
+export type CatalogEntry = {
+    identifier: string;
+    /** Display name, as the editor shows it. */
+    name: string;
+    /** Parameter keys the action accepts, in the editor's order. */
+    params: readonly string[];
+    /** Value kind per key: bool, number, string, text, picker, plainString, plainNumber, dictionary, quantity, filter, any. */
+    kinds: Record<string, string>;
+    /** Output name, or null when the action produces nothing. */
+    output: string | null;
+    /** Content types the output can be; empty when the action produces nothing. */
+    outputTypes: readonly string[];
+    /** Present for App Intents actions; written as the AppIntentDescriptor parameter. */
+    descriptor?: AppIntentDescriptor;
+    /** The engine's definition, for built-ins only. */
+    definition?: ActionDefinition;
+};
+/**
+ * Look up any catalogue identifier, built-in or App Intent. getDefinition() only knows built-ins
+ * (App Intents have no engine definition); this covers both with the same shape.
+ */
+export declare function getAction(identifier: string): CatalogEntry | undefined;
 /** Names the app that provides an App Intents action; written as the AppIntentDescriptor parameter. */
 export type AppIntentDescriptor = {
     BundleIdentifier: string;