@power-plant/core 0.0.41 → 0.0.43

package/dist/helpers/index.d.cts

@@ -1,3 +1,3 @@
-import { a as resolveMetaId, c as resolveMetaTitle, i as resolveMetaExample, l as resolveMetaVersion, n as resolveMeta, o as resolveMetaLinks, r as resolveMetaDescription, s as resolveMetaName, t as formatMetaVersion } from "../meta-DAeqzHmR.cjs";
+import { formatMetaVersion, resolveMeta, resolveMetaDescription, resolveMetaExample, resolveMetaId, resolveMetaLinks, resolveMetaName, resolveMetaTitle, resolveMetaVersion } from "./meta.cjs";
 import { isGeneratorConfigObject, isInputConfigObject, isOutputConfigObject, isSchemaConfigObject } from "./type-checks.cjs";
 export { formatMetaVersion, isGeneratorConfigObject, isInputConfigObject, isOutputConfigObject, isSchemaConfigObject, resolveMeta, resolveMetaDescription, resolveMetaExample, resolveMetaId, resolveMetaLinks, resolveMetaName, resolveMetaTitle, resolveMetaVersion };

package/dist/helpers/meta.d.cts

@@ -1,2 +1,77 @@
-import { a as resolveMetaId, c as resolveMetaTitle, i as resolveMetaExample, l as resolveMetaVersion, n as resolveMeta, o as resolveMetaLinks, r as resolveMetaDescription, s as resolveMetaName, t as formatMetaVersion } from "../meta-DAeqzHmR.cjs";
-export { formatMetaVersion, resolveMeta, resolveMetaDescription, resolveMetaExample, resolveMetaId, resolveMetaLinks, resolveMetaName, resolveMetaTitle, resolveMetaVersion };
+import { ExtractedSchemaEnvelope, JsonSchema } from "@power-plant/schema";
+import { MetaConfig, MetaLink, SchemaMetaConfig, SchemaMetaExample, SchemaOf } from "@power-plant/core";
+//#region src/helpers/meta.d.ts
+declare function formatMetaVersion(value: string | number | Date): string;
+/**
+ * Extracts the version information from a given input, which can be a string, number, or Date object. The function returns a string representation of the version in the format "YYYYMMDD" for Date inputs, or as a string for valid timestamp numbers. If the input is a string, it is returned as-is. If the input is invalid or not provided, a default version of "1.0" is returned.
+ *
+ * @param input - The input from which to extract the version. It can be a string, number, undefined, or Date object.
+ * @returns A string representing the extracted version information.
+ */
+declare function resolveMetaVersion(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string | number | Date): string;
+/**
+ * Resolves a metadata name using explicit input, metadata, or schema fallbacks.
+ *
+ * @param schema - The JSON Schema fragment to read fallback values from.
+ * @param meta - Metadata values that may already include a name.
+ * @param input - An explicit name value to prioritize when provided.
+ * @returns The resolved metadata name.
+ */
+declare function resolveMetaName(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
+/**
+ * Resolves a stable metadata identifier in the format `<name>@<version>`.
+ *
+ * @param schema - The JSON Schema fragment used to infer fallback values.
+ * @param meta - Metadata values used to resolve name and version.
+ * @returns The resolved metadata identifier, or a generated id when no name is available.
+ */
+declare function resolveMetaId(schema: JsonSchema, meta: Partial<MetaConfig>): string;
+/**
+ * Resolves a human-readable display name for metadata.
+ *
+ * @param schema - The JSON Schema fragment to read fallback display values from.
+ * @param meta - Metadata values that may already include a display name.
+ * @param input - An explicit display name value to prioritize when provided.
+ * @returns The resolved metadata display name.
+ */
+declare function resolveMetaTitle(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
+/**
+ * Resolves a metadata description from explicit input, metadata, or schema values.
+ *
+ * @param template - A template string used to generate a default description when no explicit description is provided.
+ * @param schema - The JSON Schema fragment to read fallback description values from.
+ * @param meta - Metadata values that may already include a description.
+ * @param input - An explicit description value to prioritize when provided.
+ * @returns The resolved description, if available.
+ */
+declare function resolveMetaDescription(template: string, schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
+/**
+ * Resolves and normalizes metadata examples into a consistent object format.
+ *
+ * @typeParam TSpec - The schema specification type associated with example values.
+ * @param schema - The JSON Schema fragment to read fallback examples from.
+ * @param meta - Metadata values that may already include examples.
+ * @param input - Explicit examples to prioritize when provided.
+ * @returns A normalized list of examples with generated descriptions when needed.
+ */
+declare function resolveMetaExample<TSpec>(schema: JsonSchema, meta: Partial<SchemaMetaConfig<TSpec>>, input?: SchemaMetaExample<TSpec> | SchemaMetaExample<TSpec>[]): SchemaMetaExample<TSpec>[];
+/**
+ * Resolves and de-duplicates metadata links from input, metadata, and schema docs.
+ *
+ * @param schema - The JSON Schema fragment to read fallback documentation links from.
+ * @param meta - Metadata values that may already include links.
+ * @param input - Explicit links to prioritize when provided.
+ * @returns A unique list of metadata links.
+ */
+declare function resolveMetaLinks(schema: JsonSchema, meta: Partial<MetaConfig>, input?: MetaLink[]): MetaLink[];
+/**
+ * Extracts and normalizes metadata for a specification based on the provided schema and optional configuration.
+ *
+ * @param schema - The schema that the specification is expected to conform to.
+ * @param config - Optional metadata configuration to extract and normalize.
+ * @returns The normalized specification metadata.
+ */
+declare function resolveMeta<TSpec>(schema: ExtractedSchemaEnvelope<TSpec> | SchemaOf<TSpec>, config?: MetaConfig): MetaConfig;
+//#endregion
+export { formatMetaVersion, resolveMeta, resolveMetaDescription, resolveMetaExample, resolveMetaId, resolveMetaLinks, resolveMetaName, resolveMetaTitle, resolveMetaVersion };
+//# sourceMappingURL=meta.d.cts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@power-plant/core",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "private": false,
   "description": "☢️ Generate anything from a specification",
   "keywords": ["power-plant", "storm-software"],
@@ -160,7 +160,7 @@
   "typings": "dist/index.d.mts",
   "files": ["dist"],
   "dependencies": {
-    "@power-plant/schema": "^0.0.40",
+    "@power-plant/schema": "^0.0.42",
     "@stryke/string-format": "^0.17.40",
     "@stryke/type-checks": "^0.6.31",
     "@stryke/types": "^0.12.26",
@@ -179,10 +179,10 @@
     "unstorage": "^1.17.5"
   },
   "devDependencies": {
-    "@powerlines/plugin-tsdown": "^0.1.561",
+    "@powerlines/plugin-tsdown": "^0.1.563",
     "@types/node": "^25.9.5",
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "608520e19de48555dba33659e0d97f374d5c07eb"
+  "gitHead": "2979c126773f62e500d2a9b634ed71c0ec8442b4"
 }

package/dist/meta-DAeqzHmR.d.cts

@@ -1,82 +0,0 @@
-import { DeepPartial, MaybePromise } from "@stryke/types/base";
-import { Storage } from "unstorage";
-import { BaseExtractOptions, ExtractedSchemaEnvelope, InferExtractOptions, JsonSchema, SchemaConfig, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
-import { InferLoadOptions, LoadReference } from "@stryke/resolve/types";
-import { EnvPaths } from "@stryke/env/get-env-paths";
-import { AsyncLocalStorage } from "node:async_hooks";
-//#endregion
-//#region src/helpers/meta.d.ts
-declare function formatMetaVersion(value: string | number | Date): string;
-/**
- * Extracts the version information from a given input, which can be a string, number, or Date object. The function returns a string representation of the version in the format "YYYYMMDD" for Date inputs, or as a string for valid timestamp numbers. If the input is a string, it is returned as-is. If the input is invalid or not provided, a default version of "1.0" is returned.
- *
- * @param input - The input from which to extract the version. It can be a string, number, undefined, or Date object.
- * @returns A string representing the extracted version information.
- */
-declare function resolveMetaVersion(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string | number | Date): string;
-/**
- * Resolves a metadata name using explicit input, metadata, or schema fallbacks.
- *
- * @param schema - The JSON Schema fragment to read fallback values from.
- * @param meta - Metadata values that may already include a name.
- * @param input - An explicit name value to prioritize when provided.
- * @returns The resolved metadata name.
- */
-declare function resolveMetaName(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
-/**
- * Resolves a stable metadata identifier in the format `<name>@<version>`.
- *
- * @param schema - The JSON Schema fragment used to infer fallback values.
- * @param meta - Metadata values used to resolve name and version.
- * @returns The resolved metadata identifier, or a generated id when no name is available.
- */
-declare function resolveMetaId(schema: JsonSchema, meta: Partial<MetaConfig>): string;
-/**
- * Resolves a human-readable display name for metadata.
- *
- * @param schema - The JSON Schema fragment to read fallback display values from.
- * @param meta - Metadata values that may already include a display name.
- * @param input - An explicit display name value to prioritize when provided.
- * @returns The resolved metadata display name.
- */
-declare function resolveMetaTitle(schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
-/**
- * Resolves a metadata description from explicit input, metadata, or schema values.
- *
- * @param template - A template string used to generate a default description when no explicit description is provided.
- * @param schema - The JSON Schema fragment to read fallback description values from.
- * @param meta - Metadata values that may already include a description.
- * @param input - An explicit description value to prioritize when provided.
- * @returns The resolved description, if available.
- */
-declare function resolveMetaDescription(template: string, schema: JsonSchema, meta: Partial<MetaConfig>, input?: string): string;
-/**
- * Resolves and normalizes metadata examples into a consistent object format.
- *
- * @typeParam TSpec - The schema specification type associated with example values.
- * @param schema - The JSON Schema fragment to read fallback examples from.
- * @param meta - Metadata values that may already include examples.
- * @param input - Explicit examples to prioritize when provided.
- * @returns A normalized list of examples with generated descriptions when needed.
- */
-declare function resolveMetaExample<TSpec>(schema: JsonSchema, meta: Partial<SchemaMetaConfig<TSpec>>, input?: SchemaMetaExample<TSpec> | SchemaMetaExample<TSpec>[]): SchemaMetaExample<TSpec>[];
-/**
- * Resolves and de-duplicates metadata links from input, metadata, and schema docs.
- *
- * @param schema - The JSON Schema fragment to read fallback documentation links from.
- * @param meta - Metadata values that may already include links.
- * @param input - Explicit links to prioritize when provided.
- * @returns A unique list of metadata links.
- */
-declare function resolveMetaLinks(schema: JsonSchema, meta: Partial<MetaConfig>, input?: MetaLink[]): MetaLink[];
-/**
- * Extracts and normalizes metadata for a specification based on the provided schema and optional configuration.
- *
- * @param schema - The schema that the specification is expected to conform to.
- * @param config - Optional metadata configuration to extract and normalize.
- * @returns The normalized specification metadata.
- */
-declare function resolveMeta<TSpec>(schema: ExtractedSchemaEnvelope<TSpec> | SchemaOf<TSpec>, config?: MetaConfig): MetaConfig;
-//#endregion
-export { resolveMetaId as a, resolveMetaTitle as c, resolveMetaExample as i, resolveMetaVersion as l, resolveMeta as n, resolveMetaLinks as o, resolveMetaDescription as r, resolveMetaName as s, formatMetaVersion as t };
-//# sourceMappingURL=meta-DAeqzHmR.d.cts.map

package/dist/meta-DAeqzHmR.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta-DAeqzHmR.d.cts","names":[],"sources":["config-DS1cj7j6.d.cts","config.d.cts","execution-vXX_IEkO.d.cts","context-DSkOqDWy.d.cts","context.d.cts","define.d.cts","execute.d.cts","index-DWiKtHVE.d.cts","index.d.cts","../src/helpers/meta.ts"],"mappings":";;;;;;;;iBSwCgB,kBAAkB,yBAAyB;;;;;;;iBAkB3C,mBACd,QAAQ,YACR,MAAM,QAAQ,aACd,0BAA0B;;;;;;;;;iBAeZ,gBACd,QAAQ,YACR,MAAM,QAAQ,aACd;;;;;;;;iBAsBc,cACd,QAAQ,YACR,MAAM,QAAQ;;;;;;;;;iBAgBA,iBACd,QAAQ,YACR,MAAM,QAAQ,aACd;;;;;;;;;;iBAmBc,uBACd,kBACA,QAAQ,YACR,MAAM,QAAQ,aACd;;;;;;;;;;iBAoBc,mBAAmB,OACjC,QAAQ,YACR,MAAM,QAAQ,iBAAiB,SAC/B,QAAQ,kBAAkB,SAAS,kBAAkB,WACpD,kBAAkB;;;;;;;;;iBAsCL,iBACd,QAAQ,YACR,MAAM,QAAQ,aACd,QAAQ,aACP;;;;;;;;iBAea,YAAY,OAC1B,QAAQ,wBAAwB,SAAS,SAAS,QAClD,SAAS,aACR"}