@milaboratories/pl-model-common 1.25.1 → 1.25.3

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["/**\n * Just for convenience, usually it is an Error with name 'AbortError'\n */\nexport class AbortError extends Error {\n  name = \"AbortError\";\n}\n\n/**\n * Throw this to show a message without stack trace in UI\n */\nexport class UiError extends Error {\n  name = \"UiError\";\n}\n\nexport function isAbortError(error: unknown): error is Error & { name: \"AbortError\" } {\n  return error instanceof Error && error.name === \"AbortError\";\n}\n\nexport function hasAbortError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  return error.name === \"AbortError\" || hasAbortError(error.cause);\n}\n\nexport function isAggregateError(error: unknown): error is AggregateError {\n  return error instanceof Error && error.name === \"AggregateError\";\n}\n\nexport class PFrameError extends Error {\n  name = \"PFrameError\";\n}\n\nexport function isPFrameError(error: unknown): error is PFrameError {\n  return error instanceof Error && error.name === \"PFrameError\";\n}\n\nexport class PFrameDriverError extends PFrameError {\n  name = \"PFrameError.Driver\";\n}\n\nexport function isPFrameDriverError(error: unknown): error is PFrameDriverError {\n  return error instanceof Error && error.name === \"PFrameError.Driver\";\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return `String value was thrown: ${value}`;\n  }\n\n  if (value && typeof value === \"object\") {\n    try {\n      return `Plain object was thrown: ${JSON.stringify(value)}`;\n    } catch (jsonError) {\n      const errorMessage = jsonError instanceof Error ? jsonError.message : String(jsonError);\n      return `Non-serializable object was thrown (JSON.stringify failed: ${errorMessage}): ${String(value)}`;\n    }\n  }\n\n  return String(`Non-Error value (${typeof value}) was thrown: ${value}`);\n}\n\nexport function ensureError(value: unknown): Error {\n  if (value instanceof Error) {\n    return value;\n  }\n\n  return new Error(stringifyValue(value));\n}\n\n// Error serialization for IPC/network transmission (Error objects can't be JSON serialized)\n\nexport type SerializedError = {\n  name: string;\n  message: string;\n  stack: string | undefined;\n  cause?: SerializedError;\n};\n\nexport function deserializeError(obj: SerializedError): Error {\n  const cause = obj.cause ? deserializeError(obj.cause) : undefined;\n\n  const error = new Error(obj.message, cause !== undefined ? { cause } : undefined);\n  error.name = obj.name || \"Error\";\n  error.stack = obj.stack;\n\n  return error;\n}\n\nexport function serializeError(e: unknown): SerializedError {\n  const error = ensureError(e);\n  const cause = error.cause ? serializeError(error.cause) : undefined;\n\n  return {\n    name: error.name,\n    message: error.message,\n    stack: error.stack,\n    ...(error.cause !== undefined && { cause }),\n  };\n}\n\nexport type ResultOrError<S, F = Error> =\n  | {\n      value: S;\n      error?: undefined;\n    }\n  | {\n      error: F;\n    };\n\nexport function unwrapResult<T>(result: ResultOrError<T, Error | SerializedError>): T {\n  if (result.error) {\n    throw result.error instanceof Error ? result.error : deserializeError(result.error);\n  }\n  return result.value;\n}\n\nexport function serializeResult<T>(result: ResultOrError<T>): ResultOrError<T, SerializedError> {\n  if (result.error) {\n    return { error: serializeError(result.error) };\n  }\n  return { value: result.value };\n}\n\nexport function deserializeResult<T>(result: ResultOrError<T, SerializedError>): ResultOrError<T> {\n  if (result.error) {\n    return { error: deserializeError(result.error) };\n  }\n  return { value: result.value };\n}\n\nexport function wrapCallback<T>(callback: () => T): ResultOrError<T> {\n  try {\n    const value = callback();\n    return { value };\n  } catch (error) {\n    return { error: ensureError(error) };\n  }\n}\n\nexport async function wrapAsyncCallback<T>(callback: () => Promise<T>): Promise<ResultOrError<T>> {\n  try {\n    const value = await callback();\n    return { value };\n  } catch (error) {\n    return { error: ensureError(error) };\n  }\n}\n\nexport function wrapAndSerialize<T>(callback: () => T): ResultOrError<T, SerializedError> {\n  const result = wrapCallback(callback);\n  return serializeResult(result);\n}\n\nexport async function wrapAndSerializeAsync<T>(\n  callback: () => Promise<T>,\n): Promise<ResultOrError<T, SerializedError>> {\n  const result = await wrapAsyncCallback(callback);\n  return serializeResult(result);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Just for convenience, usually it is an Error with name 'AbortError'\n */\nexport class AbortError extends Error {\n  name = \"AbortError\";\n}\n\n/**\n * Throw this to show a message without stack trace in UI\n */\nexport class UiError extends Error {\n  name = \"UiError\";\n}\n\nexport function isAbortError(error: unknown): error is Error & { name: \"AbortError\" } {\n  return error instanceof Error && error.name === \"AbortError\";\n}\n\nexport function hasAbortError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  return error.name === \"AbortError\" || hasAbortError(error.cause);\n}\n\nexport function isAggregateError(error: unknown): error is AggregateError {\n  return error instanceof Error && error.name === \"AggregateError\";\n}\n\nexport class PFrameError extends Error {\n  name = \"PFrameError\";\n}\n\nexport function isPFrameError(error: unknown): error is PFrameError {\n  return error instanceof Error && error.name === \"PFrameError\";\n}\n\nexport class PFrameDriverError extends PFrameError {\n  name = \"PFrameError.Driver\";\n}\n\nexport function isPFrameDriverError(error: unknown): error is PFrameDriverError {\n  return error instanceof Error && error.name === \"PFrameError.Driver\";\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return `String value was thrown: ${value}`;\n  }\n\n  if (value && typeof value === \"object\") {\n    try {\n      return `Plain object was thrown: ${JSON.stringify(value)}`;\n    } catch (jsonError) {\n      const errorMessage = jsonError instanceof Error ? jsonError.message : String(jsonError);\n      return `Non-serializable object was thrown (JSON.stringify failed: ${errorMessage}): ${String(value)}`;\n    }\n  }\n\n  return String(`Non-Error value (${typeof value}) was thrown: ${value}`);\n}\n\nexport function ensureError(value: unknown): Error {\n  if (value instanceof Error) {\n    return value;\n  }\n\n  return new Error(stringifyValue(value));\n}\n\n// Error serialization for IPC/network transmission (Error objects can't be JSON serialized)\n\nexport type SerializedError = {\n  name: string;\n  message: string;\n  stack: string | undefined;\n  cause?: SerializedError;\n};\n\nexport function deserializeError(obj: SerializedError): Error {\n  const cause = obj.cause ? deserializeError(obj.cause) : undefined;\n\n  const error = new Error(obj.message, cause !== undefined ? { cause } : undefined);\n  error.name = obj.name || \"Error\";\n  error.stack = obj.stack;\n\n  return error;\n}\n\nexport function serializeError(e: unknown): SerializedError {\n  const error = ensureError(e);\n  const cause = error.cause ? serializeError(error.cause) : undefined;\n\n  return {\n    name: error.name,\n    message: error.message,\n    stack: error.stack,\n    ...(error.cause !== undefined && { cause }),\n  };\n}\n\nexport type ResultOrError<S, F = Error> =\n  | {\n      value: S;\n      error?: undefined;\n    }\n  | {\n      error: F;\n    };\n\nexport function unwrapResult<T>(result: ResultOrError<T, Error | SerializedError>): T {\n  if (result.error) {\n    throw result.error instanceof Error ? result.error : deserializeError(result.error);\n  }\n  return result.value;\n}\n\nexport function serializeResult<T>(result: ResultOrError<T>): ResultOrError<T, SerializedError> {\n  if (result.error) {\n    return { error: serializeError(result.error) };\n  }\n  return { value: result.value };\n}\n\nexport function deserializeResult<T>(result: ResultOrError<T, SerializedError>): ResultOrError<T> {\n  if (result.error) {\n    return { error: deserializeError(result.error) };\n  }\n  return { value: result.value };\n}\n\nexport function wrapCallback<T>(callback: () => T): ResultOrError<T> {\n  try {\n    const value = callback();\n    return { value };\n  } catch (error) {\n    return { error: ensureError(error) };\n  }\n}\n\nexport async function wrapAsyncCallback<T>(callback: () => Promise<T>): Promise<ResultOrError<T>> {\n  try {\n    const value = await callback();\n    return { value };\n  } catch (error) {\n    return { error: ensureError(error) };\n  }\n}\n\nexport function wrapAndSerialize<T>(callback: () => T): ResultOrError<T, SerializedError> {\n  const result = wrapCallback(callback);\n  return serializeResult(result);\n}\n\nexport async function wrapAndSerializeAsync<T>(\n  callback: () => Promise<T>,\n): Promise<ResultOrError<T, SerializedError>> {\n  const result = await wrapAsyncCallback(callback);\n  return serializeResult(result);\n}\n"],"mappings":";;;;AAGA,IAAa,aAAb,cAAgC,MAAM;CACpC,OAAO;;;;;AAMT,IAAa,UAAb,cAA6B,MAAM;CACjC,OAAO;;AAGT,SAAgB,aAAa,OAAyD;AACpF,QAAO,iBAAiB,SAAS,MAAM,SAAS;;AAGlD,SAAgB,cAAc,OAAyB;AACrD,KAAI,EAAE,iBAAiB,OACrB,QAAO;AAGT,QAAO,MAAM,SAAS,gBAAgB,cAAc,MAAM,MAAM;;AAGlE,SAAgB,iBAAiB,OAAyC;AACxE,QAAO,iBAAiB,SAAS,MAAM,SAAS;;AAGlD,IAAa,cAAb,cAAiC,MAAM;CACrC,OAAO;;AAGT,SAAgB,cAAc,OAAsC;AAClE,QAAO,iBAAiB,SAAS,MAAM,SAAS;;AAGlD,IAAa,oBAAb,cAAuC,YAAY;CACjD,OAAO;;AAGT,SAAgB,oBAAoB,OAA4C;AAC9E,QAAO,iBAAiB,SAAS,MAAM,SAAS;;AAGlD,SAAS,eAAe,OAAwB;AAC9C,KAAI,OAAO,UAAU,SACnB,QAAO,4BAA4B;AAGrC,KAAI,SAAS,OAAO,UAAU,SAC5B,KAAI;AACF,SAAO,4BAA4B,KAAK,UAAU,MAAM;UACjD,WAAW;AAElB,SAAO,8DADc,qBAAqB,QAAQ,UAAU,UAAU,OAAO,UAAU,CACL,KAAK,OAAO,MAAM;;AAIxG,QAAO,OAAO,oBAAoB,OAAO,MAAM,gBAAgB,QAAQ;;AAGzE,SAAgB,YAAY,OAAuB;AACjD,KAAI,iBAAiB,MACnB,QAAO;AAGT,QAAO,IAAI,MAAM,eAAe,MAAM,CAAC;;AAYzC,SAAgB,iBAAiB,KAA6B;CAC5D,MAAM,QAAQ,IAAI,QAAQ,iBAAiB,IAAI,MAAM,GAAG;CAExD,MAAM,QAAQ,IAAI,MAAM,IAAI,SAAS,UAAU,SAAY,EAAE,OAAO,GAAG,OAAU;AACjF,OAAM,OAAO,IAAI,QAAQ;AACzB,OAAM,QAAQ,IAAI;AAElB,QAAO;;AAGT,SAAgB,eAAe,GAA6B;CAC1D,MAAM,QAAQ,YAAY,EAAE;CAC5B,MAAM,QAAQ,MAAM,QAAQ,eAAe,MAAM,MAAM,GAAG;AAE1D,QAAO;EACL,MAAM,MAAM;EACZ,SAAS,MAAM;EACf,OAAO,MAAM;EACb,GAAI,MAAM,UAAU,UAAa,EAAE,OAAO;EAC3C;;AAYH,SAAgB,aAAgB,QAAsD;AACpF,KAAI,OAAO,MACT,OAAM,OAAO,iBAAiB,QAAQ,OAAO,QAAQ,iBAAiB,OAAO,MAAM;AAErF,QAAO,OAAO;;AAGhB,SAAgB,gBAAmB,QAA6D;AAC9F,KAAI,OAAO,MACT,QAAO,EAAE,OAAO,eAAe,OAAO,MAAM,EAAE;AAEhD,QAAO,EAAE,OAAO,OAAO,OAAO;;AAGhC,SAAgB,kBAAqB,QAA6D;AAChG,KAAI,OAAO,MACT,QAAO,EAAE,OAAO,iBAAiB,OAAO,MAAM,EAAE;AAElD,QAAO,EAAE,OAAO,OAAO,OAAO;;AAGhC,SAAgB,aAAgB,UAAqC;AACnE,KAAI;AAEF,SAAO,EAAE,OADK,UAAU,EACR;UACT,OAAO;AACd,SAAO,EAAE,OAAO,YAAY,MAAM,EAAE;;;AAIxC,eAAsB,kBAAqB,UAAuD;AAChG,KAAI;AAEF,SAAO,EAAE,OADK,MAAM,UAAU,EACd;UACT,OAAO;AACd,SAAO,EAAE,OAAO,YAAY,MAAM,EAAE;;;AAIxC,SAAgB,iBAAoB,UAAsD;AAExF,QAAO,gBADQ,aAAa,SAAS,CACP;;AAGhC,eAAsB,sBACpB,UAC4C;AAE5C,QAAO,gBADQ,MAAM,kBAAkB,SAAS,CAClB"}

package/dist/flags/block_flags.cjs

@@ -1,12 +1,13 @@
-'use strict';
 
-const AllSupportsFeatureFlags = ["supportsLazyState"];
+//#region src/flags/block_flags.ts
+const AllSupportsFeatureFlags = ["supportsLazyState", "supportsPframeQueryRanking"];
 const AllRequiresFeatureFlags = [
-    "requiresUIAPIVersion",
-    "requiresCreatePTable",
-    "requiresModelAPIVersion",
+	"requiresUIAPIVersion",
+	"requiresCreatePTable",
+	"requiresModelAPIVersion"
 ];
 
+//#endregion
 exports.AllRequiresFeatureFlags = AllRequiresFeatureFlags;
 exports.AllSupportsFeatureFlags = AllSupportsFeatureFlags;
-//# sourceMappingURL=block_flags.cjs.map
+//# sourceMappingURL=block_flags.cjs.map

package/dist/flags/block_flags.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_flags.cjs","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":";;AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,sBAAsB;IACtB,yBAAyB;;;;;;"}
+{"version":3,"file":"block_flags.cjs","names":[],"sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly supportsPframeQueryRanking?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\", \"supportsPframeQueryRanking\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"mappings":";;AAwBA,MAAa,0BAA0B,CAAC,qBAAqB,6BAA6B;AAE1F,MAAa,0BAA0B;CACrC;CACA;CACA;CACD"}

package/dist/flags/block_flags.d.ts

@@ -1,3 +1,4 @@
+//#region src/flags/block_flags.d.ts
 /**
  * Block-specific feature flags. Define flags that are interpreted by the desktop app to select
  * appropriate API to expose into Model and UI runtimes.
@@ -6,16 +7,19 @@
  *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well
  *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block
  */
-export type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> & Record<`requires${string}`, boolean | number | undefined>;
+type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> & Record<`requires${string}`, boolean | number | undefined>;
 /**
  * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.
  */
-export type BlockCodeKnownFeatureFlags = {
-    readonly supportsLazyState?: boolean;
-    readonly requiresModelAPIVersion?: number;
-    readonly requiresUIAPIVersion?: number;
-    readonly requiresCreatePTable?: number;
+type BlockCodeKnownFeatureFlags = {
+  readonly supportsLazyState?: boolean;
+  readonly supportsPframeQueryRanking?: boolean;
+  readonly requiresModelAPIVersion?: number;
+  readonly requiresUIAPIVersion?: number;
+  readonly requiresCreatePTable?: number;
 };
-export declare const AllSupportsFeatureFlags: readonly ["supportsLazyState"];
-export declare const AllRequiresFeatureFlags: readonly ["requiresUIAPIVersion", "requiresCreatePTable", "requiresModelAPIVersion"];
+declare const AllSupportsFeatureFlags: readonly ["supportsLazyState", "supportsPframeQueryRanking"];
+declare const AllRequiresFeatureFlags: readonly ["requiresUIAPIVersion", "requiresCreatePTable", "requiresModelAPIVersion"];
+//#endregion
+export { AllRequiresFeatureFlags, AllSupportsFeatureFlags, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags };
 //# sourceMappingURL=block_flags.d.ts.map

package/dist/flags/block_flags.js

@@ -1,9 +1,11 @@
-const AllSupportsFeatureFlags = ["supportsLazyState"];
+//#region src/flags/block_flags.ts
+const AllSupportsFeatureFlags = ["supportsLazyState", "supportsPframeQueryRanking"];
 const AllRequiresFeatureFlags = [
-    "requiresUIAPIVersion",
-    "requiresCreatePTable",
-    "requiresModelAPIVersion",
+	"requiresUIAPIVersion",
+	"requiresCreatePTable",
+	"requiresModelAPIVersion"
 ];
 
+//#endregion
 export { AllRequiresFeatureFlags, AllSupportsFeatureFlags };
-//# sourceMappingURL=block_flags.js.map
+//# sourceMappingURL=block_flags.js.map

package/dist/flags/block_flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_flags.js","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":"AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,sBAAsB;IACtB,yBAAyB;;;;;"}
+{"version":3,"file":"block_flags.js","names":[],"sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly supportsPframeQueryRanking?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\", \"supportsPframeQueryRanking\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"mappings":";AAwBA,MAAa,0BAA0B,CAAC,qBAAqB,6BAA6B;AAE1F,MAAa,0BAA0B;CACrC;CACA;CACA;CACD"}

package/dist/flags/flag_utils.cjs

@@ -1,123 +1,84 @@
-'use strict';
 
+//#region src/flags/flag_utils.ts
 function checkBlockFlag(flags, flag, flagValue = true) {
-    if (flags === undefined)
-        return false;
-    return flags[flag] === flagValue;
+	if (flags === void 0) return false;
+	return flags[flag] === flagValue;
 }
 /**
- * Extracts all requirements from the feature flags.
- * @param flags - The feature flags.
- * @returns A set of requirements.
- */
+* Extracts all requirements from the feature flags.
+* @param flags - The feature flags.
+* @returns A set of requirements.
+*/
 function extractAllRequirements(flags) {
-    if (flags === undefined)
-        return new Set();
-    return new Set(Object.entries(flags)
-        .filter(([key, value]) => key.startsWith("requires") && value === true)
-        .map(([key]) => key));
+	if (flags === void 0) return /* @__PURE__ */ new Set();
+	return new Set(Object.entries(flags).filter(([key, value]) => key.startsWith("requires") && value === true).map(([key]) => key));
 }
 /**
- * Extracts all supports from the feature flags.
- * @param flags - The feature flags.
- * @returns A set of supports.
- */
+* Extracts all supports from the feature flags.
+* @param flags - The feature flags.
+* @returns A set of supports.
+*/
 function extractAllSupports(flags) {
-    if (flags === undefined)
-        return new Set();
-    return new Set(Object.entries(flags)
-        .filter(([key, value]) => key.startsWith("supports") && value === true)
-        .map(([key]) => key));
-}
-/**
- * Merges two feature flag objects with type-aware logic:
- * - `supports*` (boolean): OR — `true` if either side is `true`
- * - `requires*` (numeric): MAX — take the higher version requirement
- */
-function mergeFeatureFlags(base, override) {
-    const result = { ...base };
-    for (const [key, value] of Object.entries(override)) {
-        if (value === undefined)
-            continue;
-        const existing = result[key];
-        if (typeof value === "boolean") {
-            result[key] = existing || value;
-        }
-        else if (typeof value === "number") {
-            result[key] = Math.max(existing ?? 0, value);
-        }
-    }
-    return result;
-}
-class IncompatibleFlagsError extends Error {
-    incompatibleFlags;
-    name = "IncompatibleFlagsError";
-    constructor(incompatibleFlags) {
-        super(`Some of the block requirements are not supported by the runtime: ${Array.from(incompatibleFlags.entries())
-            .map(([key, value]) => `${key}: ${value}`)
-            .join(", ")}`);
-        this.incompatibleFlags = incompatibleFlags;
-    }
-}
-class RuntimeCapabilities {
-    supportedRequirements = new Map();
-    /**
-     * Adds a supported requirement to the runtime capabilities.
-     * @param requirement - The requirement.
-     * @param value - The value of the requirement. If not provided, defaults to true.
-     */
-    addSupportedRequirement(requirement, value = true) {
-        if (!this.supportedRequirements.has(requirement)) {
-            this.supportedRequirements.set(requirement, new Set());
-        }
-        this.supportedRequirements.get(requirement).add(value);
-        return this;
-    }
-    /**
-     * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.
-     * @param blockFlags - The block flags.
-     * @returns A map of incompatible flags, or undefined if the block flags are compatible.
-     */
-    getIncompatibleFlags(blockFlags) {
-        if (blockFlags === undefined)
-            return undefined;
-        const incompatibleFlags = new Map();
-        for (const [key, value] of Object.entries(blockFlags)) {
-            if (key.startsWith("requires")) {
-                if (value === undefined)
-                    continue;
-                const supportedValues = this.supportedRequirements.get(key);
-                if (supportedValues === undefined || !supportedValues.has(value)) {
-                    incompatibleFlags.set(key, value);
-                }
-            }
-        }
-        return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;
-    }
-    /**
-     * Checks if the block flags are compatible with the runtime capabilities.
-     * @param blockFlags - The block flags.
-     * @returns True if the block flags are compatible, false otherwise.
-     */
-    checkCompatibility(blockFlags) {
-        return this.getIncompatibleFlags(blockFlags) === undefined;
-    }
-    /**
-     * Throws an error if the block flags are incompatible with the runtime capabilities.
-     * @param blockFlags - The block flags.
-     * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.
-     */
-    throwIfIncompatible(blockFlags) {
-        const incompatibleFlags = this.getIncompatibleFlags(blockFlags);
-        if (incompatibleFlags !== undefined)
-            throw new IncompatibleFlagsError(incompatibleFlags);
-    }
+	if (flags === void 0) return /* @__PURE__ */ new Set();
+	return new Set(Object.entries(flags).filter(([key, value]) => key.startsWith("supports") && value === true).map(([key]) => key));
 }
+var IncompatibleFlagsError = class extends Error {
+	name = "IncompatibleFlagsError";
+	constructor(incompatibleFlags) {
+		super(`Some of the block requirements are not supported by the runtime: ${Array.from(incompatibleFlags.entries()).map(([key, value]) => `${key}: ${value}`).join(", ")}`);
+		this.incompatibleFlags = incompatibleFlags;
+	}
+};
+var RuntimeCapabilities = class {
+	supportedRequirements = /* @__PURE__ */ new Map();
+	/**
+	* Adds a supported requirement to the runtime capabilities.
+	* @param requirement - The requirement.
+	* @param value - The value of the requirement. If not provided, defaults to true.
+	*/
+	addSupportedRequirement(requirement, value = true) {
+		if (!this.supportedRequirements.has(requirement)) this.supportedRequirements.set(requirement, /* @__PURE__ */ new Set());
+		this.supportedRequirements.get(requirement).add(value);
+		return this;
+	}
+	/**
+	* Returns a map of incompatible flags. If the block flags are compatible, returns undefined.
+	* @param blockFlags - The block flags.
+	* @returns A map of incompatible flags, or undefined if the block flags are compatible.
+	*/
+	getIncompatibleFlags(blockFlags) {
+		if (blockFlags === void 0) return void 0;
+		const incompatibleFlags = /* @__PURE__ */ new Map();
+		for (const [key, value] of Object.entries(blockFlags)) if (key.startsWith("requires")) {
+			if (value === void 0) continue;
+			const supportedValues = this.supportedRequirements.get(key);
+			if (supportedValues === void 0 || !supportedValues.has(value)) incompatibleFlags.set(key, value);
+		}
+		return incompatibleFlags.size === 0 ? void 0 : incompatibleFlags;
+	}
+	/**
+	* Checks if the block flags are compatible with the runtime capabilities.
+	* @param blockFlags - The block flags.
+	* @returns True if the block flags are compatible, false otherwise.
+	*/
+	checkCompatibility(blockFlags) {
+		return this.getIncompatibleFlags(blockFlags) === void 0;
+	}
+	/**
+	* Throws an error if the block flags are incompatible with the runtime capabilities.
+	* @param blockFlags - The block flags.
+	* @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.
+	*/
+	throwIfIncompatible(blockFlags) {
+		const incompatibleFlags = this.getIncompatibleFlags(blockFlags);
+		if (incompatibleFlags !== void 0) throw new IncompatibleFlagsError(incompatibleFlags);
+	}
+};
 
+//#endregion
 exports.IncompatibleFlagsError = IncompatibleFlagsError;
 exports.RuntimeCapabilities = RuntimeCapabilities;
 exports.checkBlockFlag = checkBlockFlag;
 exports.extractAllRequirements = extractAllRequirements;
 exports.extractAllSupports = extractAllSupports;
-exports.mergeFeatureFlags = mergeFeatureFlags;
-//# sourceMappingURL=flag_utils.cjs.map
+//# sourceMappingURL=flag_utils.cjs.map

package/dist/flags/flag_utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"flag_utils.cjs","sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nexport function mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (existing as boolean | undefined) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max((existing as number) ?? 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"flag_utils.cjs","names":[],"sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"mappings":";;AAGA,SAAgB,eACd,OACA,MACA,YAA8B,MACrB;AACT,KAAI,UAAU,OAAW,QAAO;AAChC,QAAO,MAAM,UAAU;;;;;;;AAQzB,SAAgB,uBACd,OAC0B;AAC1B,KAAI,UAAU,OAAW,wBAAO,IAAI,KAAK;AACzC,QAAO,IAAI,IACT,OAAO,QAAQ,MAAM,CAClB,QAAQ,CAAC,KAAK,WAAW,IAAI,WAAW,WAAW,IAAI,UAAU,KAAK,CACtE,KAAK,CAAC,SAAS,IAA2B,CAC9C;;;;;;;AAQH,SAAgB,mBACd,OAC0B;AAC1B,KAAI,UAAU,OAAW,wBAAO,IAAI,KAAK;AACzC,QAAO,IAAI,IACT,OAAO,QAAQ,MAAM,CAClB,QAAQ,CAAC,KAAK,WAAW,IAAI,WAAW,WAAW,IAAI,UAAU,KAAK,CACtE,KAAK,CAAC,SAAS,IAA2B,CAC9C;;AAGH,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAO;CACP,YAAY,AAAgB,mBAA+D;AACzF,QACE,oEAAoE,MAAM,KACxE,kBAAkB,SAAS,CAC5B,CACE,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,IAAI,QAAQ,CACzC,KAAK,KAAK,GACd;EAPyB;;;AAoB9B,IAAa,sBAAb,MAAiC;CAC/B,AAAiB,wCACf,IAAI,KAAK;;;;;;CAOX,AAAO,wBACL,aACA,QAA0B,MACpB;AACN,MAAI,CAAC,KAAK,sBAAsB,IAAI,YAAY,CAC9C,MAAK,sBAAsB,IAAI,6BAAa,IAAI,KAAK,CAAC;AAExD,OAAK,sBAAsB,IAAI,YAAY,CAAE,IAAI,MAAM;AACvD,SAAO;;;;;;;CAQT,AAAO,qBACL,YACwD;AACxD,MAAI,eAAe,OAAW,QAAO;EACrC,MAAM,oCAAoB,IAAI,KAA4C;AAC1E,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,CACnD,KAAI,IAAI,WAAW,WAAW,EAAE;AAC9B,OAAI,UAAU,OAAW;GACzB,MAAM,kBAAkB,KAAK,sBAAsB,IAAI,IAA2B;AAClF,OAAI,oBAAoB,UAAa,CAAC,gBAAgB,IAAI,MAA0B,CAClF,mBAAkB,IAAI,KAA4B,MAA0B;;AAIlF,SAAO,kBAAkB,SAAS,IAAI,SAAY;;;;;;;CAQpD,AAAO,mBAAmB,YAAwD;AAChF,SAAO,KAAK,qBAAqB,WAAW,KAAK;;;;;;;CAQnD,AAAO,oBAAoB,YAA+C;EACxE,MAAM,oBAAoB,KAAK,qBAAqB,WAAW;AAC/D,MAAI,sBAAsB,OAAW,OAAM,IAAI,uBAAuB,kBAAkB"}

package/dist/flags/flag_utils.d.ts

@@ -1,28 +1,24 @@
-import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from "./block_flags";
-import type { FilterKeysByPrefix } from "./type_utils";
-export declare function checkBlockFlag(flags: BlockCodeFeatureFlags | undefined, flag: keyof BlockCodeKnownFeatureFlags, flagValue?: boolean | number): boolean;
+import { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from "./block_flags.js";
+import { FilterKeysByPrefix } from "./type_utils.js";
+
+//#region src/flags/flag_utils.d.ts
+declare function checkBlockFlag(flags: BlockCodeFeatureFlags | undefined, flag: keyof BlockCodeKnownFeatureFlags, flagValue?: boolean | number): boolean;
 /**
  * Extracts all requirements from the feature flags.
  * @param flags - The feature flags.
  * @returns A set of requirements.
  */
-export declare function extractAllRequirements(flags: BlockCodeFeatureFlags | undefined): Set<`requires${string}`>;
+declare function extractAllRequirements(flags: BlockCodeFeatureFlags | undefined): Set<`requires${string}`>;
 /**
  * Extracts all supports from the feature flags.
  * @param flags - The feature flags.
  * @returns A set of supports.
  */
-export declare function extractAllSupports(flags: BlockCodeFeatureFlags | undefined): Set<`supports${string}`>;
-/**
- * Merges two feature flag objects with type-aware logic:
- * - `supports*` (boolean): OR — `true` if either side is `true`
- * - `requires*` (numeric): MAX — take the higher version requirement
- */
-export declare function mergeFeatureFlags(base: BlockCodeKnownFeatureFlags, override: BlockCodeKnownFeatureFlags): BlockCodeKnownFeatureFlags;
-export declare class IncompatibleFlagsError extends Error {
-    readonly incompatibleFlags: Map<`requires${string}`, number | boolean>;
-    name: string;
-    constructor(incompatibleFlags: Map<`requires${string}`, number | boolean>);
+declare function extractAllSupports(flags: BlockCodeFeatureFlags | undefined): Set<`supports${string}`>;
+declare class IncompatibleFlagsError extends Error {
+  readonly incompatibleFlags: Map<`requires${string}`, number | boolean>;
+  name: string;
+  constructor(incompatibleFlags: Map<`requires${string}`, number | boolean>);
 }
 /**
  * A type that represents a supported requirement.
@@ -31,32 +27,34 @@ export declare class IncompatibleFlagsError extends Error {
  * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.
  * It is used to represent a supported requirement.
  */
-export type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, "requires">;
-export declare class RuntimeCapabilities {
-    private readonly supportedRequirements;
-    /**
-     * Adds a supported requirement to the runtime capabilities.
-     * @param requirement - The requirement.
-     * @param value - The value of the requirement. If not provided, defaults to true.
-     */
-    addSupportedRequirement(requirement: SupportedRequirement, value?: number | boolean): this;
-    /**
-     * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.
-     * @param blockFlags - The block flags.
-     * @returns A map of incompatible flags, or undefined if the block flags are compatible.
-     */
-    getIncompatibleFlags(blockFlags: BlockCodeFeatureFlags | undefined): Map<`requires${string}`, number | boolean> | undefined;
-    /**
-     * Checks if the block flags are compatible with the runtime capabilities.
-     * @param blockFlags - The block flags.
-     * @returns True if the block flags are compatible, false otherwise.
-     */
-    checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean;
-    /**
-     * Throws an error if the block flags are incompatible with the runtime capabilities.
-     * @param blockFlags - The block flags.
-     * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.
-     */
-    throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined): void;
+type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, "requires">;
+declare class RuntimeCapabilities {
+  private readonly supportedRequirements;
+  /**
+   * Adds a supported requirement to the runtime capabilities.
+   * @param requirement - The requirement.
+   * @param value - The value of the requirement. If not provided, defaults to true.
+   */
+  addSupportedRequirement(requirement: SupportedRequirement, value?: number | boolean): this;
+  /**
+   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.
+   * @param blockFlags - The block flags.
+   * @returns A map of incompatible flags, or undefined if the block flags are compatible.
+   */
+  getIncompatibleFlags(blockFlags: BlockCodeFeatureFlags | undefined): Map<`requires${string}`, number | boolean> | undefined;
+  /**
+   * Checks if the block flags are compatible with the runtime capabilities.
+   * @param blockFlags - The block flags.
+   * @returns True if the block flags are compatible, false otherwise.
+   */
+  checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean;
+  /**
+   * Throws an error if the block flags are incompatible with the runtime capabilities.
+   * @param blockFlags - The block flags.
+   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.
+   */
+  throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined): void;
 }
+//#endregion
+export { IncompatibleFlagsError, RuntimeCapabilities, SupportedRequirement, checkBlockFlag, extractAllRequirements, extractAllSupports };
 //# sourceMappingURL=flag_utils.d.ts.map