@promptframe/component-kit 0.1.9 → 0.1.11

package/README.md

@@ -11,6 +11,7 @@ npm install @promptframe/component-kit
 - Standard version stamps for component metadata, sourced from `@promptframe/contracts`.
 - Preview constraints used by PromptFrame component tooling.
 - Bounded local preview case matrix helpers for aspect and default-props stress checks.
+- `public/` resource lookup helper for runtime-injected component resources with local-dev fallback.
 - Timing helpers for deterministic fps-aware timing and frame-driven animations.
 - Public style helpers backed by `@promptframe/contracts`.
 
@@ -25,6 +26,19 @@ export const manifest = {
 };
 ```
 
+```ts
+import { promptFramePublicResource, type PromptFrameRuntimeResourceProps } from '@promptframe/component-kit';
+
+type Props = PromptFrameRuntimeResourceProps & {
+  title: string;
+};
+
+export function Component(props: Props) {
+  const logoSrc = promptFramePublicResource(props, '/logo.png', '/fallback-logo.png');
+  return logoSrc;
+}
+```
+
 ```ts
 import { COMPONENT_PREVIEW_CONSTRAINTS, createPreviewCaseMatrix } from '@promptframe/component-kit/preview';
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './preview.js';
+export * from './resources.js';
 export * from './standard.js';
 export * from './style.js';
 export * from './timing.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './preview.js';
+export * from './resources.js';
 export * from './standard.js';
 export * from './style.js';
 export * from './timing.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,8 @@
+import { type ComponentRuntimeResourceManifest } from '@promptframe/contracts';
+export type PromptFrameRuntimeResources = ComponentRuntimeResourceManifest;
+export interface PromptFrameRuntimeResourceProps {
+    promptFrameResources?: PromptFrameRuntimeResources;
+}
+export declare function promptFramePublicResource(resourcesOrProps: PromptFrameRuntimeResources | PromptFrameRuntimeResourceProps | undefined, publicPath: string, fallback?: string): string;
+export declare function normalizePromptFramePublicResourcePath(publicPath: string): `/${string}` | undefined;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAE3E,MAAM,WAAW,+BAA+B;IAC9C,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;CACpD;AAED,wBAAgB,yBAAyB,CACvC,gBAAgB,EAAE,2BAA2B,GAAG,+BAA+B,GAAG,SAAS,EAC3F,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAOR;AAED,wBAAgB,sCAAsC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,MAAM,EAAE,GAAG,SAAS,CASnG"}

package/dist/resources.js

@@ -0,0 +1,39 @@
+import { COMPONENT_PUBLIC_RESOURCES_CONTRACT_VERSION, } from '@promptframe/contracts';
+export function promptFramePublicResource(resourcesOrProps, publicPath, fallback) {
+    const normalized = normalizePromptFramePublicResourcePath(publicPath);
+    if (!normalized)
+        return fallback ?? '';
+    const resources = extractPromptFrameRuntimeResources(resourcesOrProps);
+    const match = resources?.entries.find((entry) => entry.publicPath === normalized);
+    return match?.url ?? fallback ?? normalized;
+}
+export function normalizePromptFramePublicResourcePath(publicPath) {
+    const value = publicPath.trim();
+    if (!value || value !== publicPath)
+        return undefined;
+    if (/^[a-z][a-z0-9+.-]*:/i.test(value) || value.startsWith('//') || value.includes('\\'))
+        return undefined;
+    const withSlash = value.startsWith('/') ? value : `/${value}`;
+    if (withSlash.includes('//'))
+        return undefined;
+    const parts = withSlash.slice(1).split('/');
+    if (parts.some((part) => !part || part === '.' || part === '..'))
+        return undefined;
+    return /^[A-Za-z0-9._~!$&'()+,;=@/-]+$/.test(withSlash) ? withSlash : undefined;
+}
+function extractPromptFrameRuntimeResources(resourcesOrProps) {
+    if (!resourcesOrProps)
+        return undefined;
+    const candidate = hasRuntimeResourceEntries(resourcesOrProps)
+        ? resourcesOrProps
+        : resourcesOrProps.promptFrameResources;
+    if (!candidate || candidate.contractVersion !== COMPONENT_PUBLIC_RESOURCES_CONTRACT_VERSION)
+        return undefined;
+    return candidate;
+}
+function hasRuntimeResourceEntries(value) {
+    return typeof value === 'object'
+        && value !== null
+        && Array.isArray(value.entries);
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2CAA2C,GAE5C,MAAM,wBAAwB,CAAC;AAQhC,MAAM,UAAU,yBAAyB,CACvC,gBAA2F,EAC3F,UAAkB,EAClB,QAAiB;IAEjB,MAAM,UAAU,GAAG,sCAAsC,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,IAAI,EAAE,CAAC;IAEvC,MAAM,SAAS,GAAG,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAClF,OAAO,KAAK,EAAE,GAAG,IAAI,QAAQ,IAAI,UAAU,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,UAAkB;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACrD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3G,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IAC9D,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACnF,OAAO,gCAAgC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;AAClG,CAAC;AAED,SAAS,kCAAkC,CACzC,gBAA2F;IAE3F,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,SAAS,GAAG,yBAAyB,CAAC,gBAAgB,CAAC;QAC3D,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,gBAAgB,CAAC,oBAAoB,CAAC;IAC1C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,eAAe,KAAK,2CAA2C;QAAE,OAAO,SAAS,CAAC;IAC9G,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACd,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/standard.d.ts

@@ -1,14 +1,14 @@
 export declare const COMPONENT_STANDARD_VERSION: "component-standard.v0.1.0";
 export declare const COMPONENT_STANDARD_SOURCE_HASH: "sha256:8c1e01c36155b4b646981064d24df9bd8cda501fd9cd9da93e5b62f40db22d52";
 export declare const COMPONENT_STANDARD_SOURCE_PATH: "https://github.com/ty-teams/promptframe-component-authoring#readme";
-export declare const COMPONENT_KIT_VERSION: "0.1.9";
+export declare const COMPONENT_KIT_VERSION: "0.1.11";
 export declare const COMPONENT_MANIFEST_SCHEMA_VERSION: "component-manifest.v0.1.0";
 export declare const COMPONENT_REVIEW_CHECKLIST_VERSION: "component-review-checklist.v0.1.0";
 export declare function getComponentStandardStamp(): {
     sourceVersion: "component-standard.v0.1.0";
     sourceHash: "sha256:8c1e01c36155b4b646981064d24df9bd8cda501fd9cd9da93e5b62f40db22d52";
     sourcePath: "https://github.com/ty-teams/promptframe-component-authoring#readme";
-    componentKitVersion: "0.1.9";
+    componentKitVersion: "0.1.11";
     manifestSchemaVersion: "component-manifest.v0.1.0";
     reviewChecklistVersion: "component-review-checklist.v0.1.0";
 };

package/dist/standard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../src/standard.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,6BAAuC,CAAC;AAC/E,eAAO,MAAM,8BAA8B,2EAA2C,CAAC;AACvF,eAAO,MAAM,8BAA8B,EAAG,oEAA6E,CAAC;AAC5H,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AACtD,eAAO,MAAM,iCAAiC,6BAA8C,CAAC;AAC7F,eAAO,MAAM,kCAAkC,EAAG,mCAA4C,CAAC;AAE/F,wBAAgB,yBAAyB;;;;;;;EASxC"}
+{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../src/standard.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,6BAAuC,CAAC;AAC/E,eAAO,MAAM,8BAA8B,2EAA2C,CAAC;AACvF,eAAO,MAAM,8BAA8B,EAAG,oEAA6E,CAAC;AAC5H,eAAO,MAAM,qBAAqB,EAAG,QAAiB,CAAC;AACvD,eAAO,MAAM,iCAAiC,6BAA8C,CAAC;AAC7F,eAAO,MAAM,kCAAkC,EAAG,mCAA4C,CAAC;AAE/F,wBAAgB,yBAAyB;;;;;;;EASxC"}

package/dist/standard.js

@@ -2,7 +2,7 @@ import { COMPONENT_MANIFEST_SCHEMA_VERSION as CONTRACTS_COMPONENT_MANIFEST_SCHEM
 export const COMPONENT_STANDARD_VERSION = CONTRACTS_COMPONENT_STANDARD_VERSION;
 export const COMPONENT_STANDARD_SOURCE_HASH = CONTRACTS_COMPONENT_STANDARD_SOURCE_HASH;
 export const COMPONENT_STANDARD_SOURCE_PATH = 'https://github.com/ty-teams/promptframe-component-authoring#readme';
-export const COMPONENT_KIT_VERSION = '0.1.9';
+export const COMPONENT_KIT_VERSION = '0.1.11';
 export const COMPONENT_MANIFEST_SCHEMA_VERSION = CONTRACTS_COMPONENT_MANIFEST_SCHEMA_VERSION;
 export const COMPONENT_REVIEW_CHECKLIST_VERSION = 'component-review-checklist.v0.1.0';
 export function getComponentStandardStamp() {

package/dist/standard.js.map

@@ -1 +1 @@
-{"version":3,"file":"standard.js","sourceRoot":"","sources":["../src/standard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,IAAI,2CAA2C,EAChF,8BAA8B,IAAI,wCAAwC,EAC1E,0BAA0B,IAAI,oCAAoC,GACnE,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,wCAAwC,CAAC;AACvF,MAAM,CAAC,MAAM,8BAA8B,GAAG,oEAA6E,CAAC;AAC5H,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AACtD,MAAM,CAAC,MAAM,iCAAiC,GAAG,2CAA2C,CAAC;AAC7F,MAAM,CAAC,MAAM,kCAAkC,GAAG,mCAA4C,CAAC;AAE/F,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,UAAU,EAAE,8BAA8B;QAC1C,UAAU,EAAE,8BAA8B;QAC1C,mBAAmB,EAAE,qBAAqB;QAC1C,qBAAqB,EAAE,iCAAiC;QACxD,sBAAsB,EAAE,kCAAkC;KAC3D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"standard.js","sourceRoot":"","sources":["../src/standard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,IAAI,2CAA2C,EAChF,8BAA8B,IAAI,wCAAwC,EAC1E,0BAA0B,IAAI,oCAAoC,GACnE,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,wCAAwC,CAAC;AACvF,MAAM,CAAC,MAAM,8BAA8B,GAAG,oEAA6E,CAAC;AAC5H,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAiB,CAAC;AACvD,MAAM,CAAC,MAAM,iCAAiC,GAAG,2CAA2C,CAAC;AAC7F,MAAM,CAAC,MAAM,kCAAkC,GAAG,mCAA4C,CAAC;AAE/F,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,UAAU,EAAE,8BAA8B;QAC1C,UAAU,EAAE,8BAA8B;QAC1C,mBAAmB,EAAE,qBAAqB;QAC1C,qBAAqB,EAAE,iCAAiC;QACxD,sBAAsB,EAAE,kCAAkC;KAC3D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptframe/component-kit",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -57,7 +57,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@promptframe/contracts": "^0.1.11"
+    "@promptframe/contracts": "^0.1.13"
   },
   "peerDependencies": {
     "react": "^19.0.0",