@wp-typia/block-runtime 0.3.0 → 0.4.0

package/README.md

@@ -25,9 +25,8 @@ import { createNestedAttributeUpdater } from "@wp-typia/block-runtime/validation
 import { runSyncBlockMetadata } from "@wp-typia/block-runtime/metadata-core";
 ```
 
-`@wp-typia/create` remains the CLI/scaffolding package.
+`wp-typia` remains the CLI package.
 
-`@wp-typia/create/metadata-core` and `@wp-typia/create/runtime/*` remain
-available as backward-compatible facades, but newly generated projects should
-prefer `@wp-typia/block-runtime/*` and
-`@wp-typia/block-runtime/metadata-core`.
+`@wp-typia/project-tools` is the canonical programmatic project orchestration
+package, while newly generated projects should prefer `@wp-typia/block-runtime/*`
+and `@wp-typia/block-runtime/metadata-core`.

package/dist/identifiers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generate a UUID v4-style id for block attributes.
+ */
+export declare function generateBlockId(): string;
+/**
+ * Generate a prefixed runtime id for client-side attributes such as uniqueId.
+ * @param prefix Prefix chosen by the scaffold/template.
+ */
+export declare function generateScopedClientId(prefix: string): string;
+/**
+ * Generate a prefixed persistence resource key.
+ * @param prefix Prefix chosen by the scaffold/template.
+ */
+export declare function generateResourceKey(prefix: string): string;
+/**
+ * Generate an opaque id for one public write attempt.
+ */
+export declare function generatePublicWriteRequestId(): string;

package/dist/identifiers.js

@@ -0,0 +1,84 @@
+const UUID_HEX_RADIX = 16;
+const SCOPED_SUFFIX_LENGTH = 9;
+/**
+ * Generate a UUID v4-style id for block attributes.
+ */
+export function generateBlockId() {
+    return generateUuidV4();
+}
+/**
+ * Generate a prefixed runtime id for client-side attributes such as uniqueId.
+ * @param prefix Prefix chosen by the scaffold/template.
+ */
+export function generateScopedClientId(prefix) {
+    return generatePrefixedScopedId(prefix);
+}
+/**
+ * Generate a prefixed persistence resource key.
+ * @param prefix Prefix chosen by the scaffold/template.
+ */
+export function generateResourceKey(prefix) {
+    return generatePrefixedScopedId(prefix);
+}
+/**
+ * Generate an opaque id for one public write attempt.
+ */
+export function generatePublicWriteRequestId() {
+    return generateUuidV4();
+}
+function generateUuidV4() {
+    const cryptoObject = getCryptoObject();
+    if (typeof cryptoObject?.randomUUID === 'function') {
+        return cryptoObject.randomUUID();
+    }
+    const bytes = fillRandomBytes(16);
+    if (bytes) {
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        return formatUuidBytes(bytes);
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (character) => {
+        const randomNibble = Math.floor(Math.random() * UUID_HEX_RADIX);
+        const value = character === 'x'
+            ? randomNibble
+            : (randomNibble & 0x03) | 0x08;
+        return value.toString(UUID_HEX_RADIX);
+    });
+}
+function generatePrefixedScopedId(prefix) {
+    return `${prefix}-${generateScopedSuffix()}`;
+}
+function generateScopedSuffix() {
+    const bytes = fillRandomBytes(SCOPED_SUFFIX_LENGTH);
+    if (bytes) {
+        return Array.from(bytes, (byte) => (byte % 36).toString(36)).join('');
+    }
+    return Math.random()
+        .toString(36)
+        .slice(2, 2 + SCOPED_SUFFIX_LENGTH)
+        .padEnd(SCOPED_SUFFIX_LENGTH, '0');
+}
+function formatUuidBytes(bytes) {
+    const hex = Array.from(bytes, (byte) => byte.toString(UUID_HEX_RADIX).padStart(2, '0')).join('');
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20),
+    ].join('-');
+}
+function fillRandomBytes(size) {
+    const cryptoObject = getCryptoObject();
+    if (typeof cryptoObject?.getRandomValues !== 'function') {
+        return null;
+    }
+    const bytes = new Uint8Array(size);
+    cryptoObject.getRandomValues(bytes);
+    return bytes;
+}
+function getCryptoObject() {
+    return typeof globalThis.crypto === 'object' && globalThis.crypto
+        ? globalThis.crypto
+        : undefined;
+}

package/dist/inspector-runtime.d.ts

@@ -125,5 +125,5 @@ export interface InspectorFromManifestProps<T extends UnknownRecord> {
 }
 export declare function useEditorFields(manifest: ManifestDocument, options?: EditorModelOptions): UseEditorFieldsResult;
 export declare function useTypedAttributeUpdater<T extends object>(attributes: T, setAttributes: (attrs: Partial<T>) => void, validate?: (value: T) => ValidationResult<T>): TypedAttributeUpdater<T>;
-export declare function FieldControl({ components, field, help, label, max, min, onChange, options, render, renderUnsupported, step, value, }: FieldControlProps): import("react/jsx-runtime.js").JSX.Element | null;
-export declare function InspectorFromManifest<T extends UnknownRecord>({ attributes, children, components, fieldLookup, fieldOverrides, initialOpen, onChange, paths, title, }: InspectorFromManifestProps<T>): import("react/jsx-runtime.js").JSX.Element;
+export declare function FieldControl({ components, field, help, label, max, min, onChange, options, render, renderUnsupported, step, value, }: FieldControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function InspectorFromManifest<T extends UnknownRecord>({ attributes, children, components, fieldLookup, fieldOverrides, initialOpen, onChange, paths, title, }: InspectorFromManifestProps<T>): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/block-runtime",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Generated-project runtime and metadata sync helpers for wp-typia",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,11 @@
       "import": "./dist/editor.js",
       "default": "./dist/editor.js"
     },
+    "./identifiers": {
+      "types": "./dist/identifiers.d.ts",
+      "import": "./dist/identifiers.js",
+      "default": "./dist/identifiers.js"
+    },
     "./inspector": {
       "types": "./dist/inspector.d.ts",
       "import": "./dist/inspector.js",