@stonecrop/stonecrop 0.10.0 → 0.10.2

package/dist/stores/operation-log.js

@@ -409,7 +409,6 @@ export const useOperationLogStore = defineStore('hst-operation-log', () => {
             return;
         broadcastChannel = new BroadcastChannel('stonecrop-operation-log');
         broadcastChannel.addEventListener('message', (event) => {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
             const rawMessage = event.data;
             if (!rawMessage || typeof rawMessage !== 'object')
                 return;
@@ -478,9 +477,7 @@ export const useOperationLogStore = defineStore('hst-operation-log', () => {
         serializer: {
             read: (v) => {
                 try {
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
                     const data = JSON.parse(v);
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                     return data;
                 }
                 catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/stonecrop",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "license": "MIT",
   "type": "module",
   "author": {
@@ -59,8 +59,8 @@
     "vue-router": "^5.0.2",
     "vite": "^7.3.1",
     "vitest": "^4.0.18",
-    "@stonecrop/aform": "0.10.0",
-    "@stonecrop/atable": "0.10.0",
+    "@stonecrop/aform": "0.10.2",
+    "@stonecrop/atable": "0.10.2",
     "stonecrop-rig": "0.7.0"
   },
   "description": "Schema-driven framework with XState workflows and HST state management",

package/src/composables/operation-log.ts

@@ -1,6 +1,6 @@
 import { useMagicKeys, whenever } from '@vueuse/core'
 import { storeToRefs } from 'pinia'
-import { inject } from 'vue'
+import { getCurrentInstance, inject } from 'vue'
 
 import type { HSTNode } from '../stores/hst'
 import { useOperationLogStore } from '../stores/operation-log'
@@ -32,9 +32,12 @@ import type { OperationLogConfig } from '../types/operation-log'
  * @public
  */
 export function useOperationLog(config?: Partial<OperationLogConfig>) {
-	// Try to use the injected store from the Stonecrop plugin first
-	// This ensures we use the same Pinia instance as the app
-	const injectedStore = inject<ReturnType<typeof useOperationLogStore> | undefined>('$operationLogStore', undefined)
+	// inject() is only valid inside a component setup() context. When this
+	// composable is called outside one (e.g. directly in test bodies or plain
+	// scripts) skip the injection entirely and fall back to the Pinia store.
+	const injectedStore = getCurrentInstance()
+		? inject<ReturnType<typeof useOperationLogStore> | undefined>('$operationLogStore', undefined)
+		: undefined
 	const store = injectedStore || useOperationLogStore()
 
 	// Apply configuration if provided

package/src/doctype.ts

@@ -64,6 +64,32 @@ export default class DoctypeMeta {
 		this.component = component
 	}
 
+	/**
+	 * Returns the transitions available from a given workflow state, derived from the
+	 * doctype's XState workflow configuration.
+	 *
+	 * @param currentState - The state name to read transitions from
+	 * @returns Array of transition descriptors with `name` and `targetState`
+	 *
+	 * @example
+	 * ```ts
+	 * const transitions = doctype.getAvailableTransitions('draft')
+	 * // [{ name: 'SUBMIT', targetState: 'submitted' }]
+	 * ```
+	 *
+	 * @public
+	 */
+	getAvailableTransitions(currentState: string): Array<{ name: string; targetState: string }> {
+		const states = this.workflow?.states
+		if (!states) return []
+		const stateConfig = states[currentState]
+		if (!stateConfig?.on) return []
+		return Object.entries(stateConfig.on).map(([name, target]) => ({
+			name,
+			targetState: typeof target === 'string' ? target : 'unknown',
+		}))
+	}
+
 	/**
 	 * Converts the registered doctype string to a slug (kebab-case). The following conversions are made:
 	 * - It replaces camelCase and PascalCase with kebab-case strings

package/src/registry.ts

@@ -272,6 +272,16 @@ export default class Registry {
 		return record
 	}
 
+	/**
+	 * Get a registered doctype by slug
+	 * @param slug - The doctype slug to look up
+	 * @returns The DoctypeMeta instance if found, or undefined
+	 * @public
+	 */
+	getDoctype(slug: string): DoctypeMeta | undefined {
+		return this.registry[slug]
+	}
+
 	// TODO: should we allow clearing the registry at all?
 	// clear() {
 	// 	this.registry = {}

package/src/stonecrop.ts

@@ -290,4 +290,33 @@ export class Stonecrop {
 	getStore(): HSTNode {
 		return this.hstStore
 	}
+
+	/**
+	 * Determine the current workflow state for a record.
+	 *
+	 * Reads the record's `status` field from the HST store. If the field is absent or
+	 * empty the doctype's declared `workflow.initial` state is used as the fallback,
+	 * giving callers a reliable state name without having to duplicate that logic.
+	 *
+	 * @param doctype - The doctype slug or DoctypeMeta instance
+	 * @param recordId - The record identifier
+	 * @returns The current state name, or an empty string if the doctype has no workflow
+	 *
+	 * @public
+	 */
+	getRecordState(doctype: string | DoctypeMeta, recordId: string): string {
+		const slug = typeof doctype === 'string' ? doctype : doctype.slug
+		const meta = this.registry.getDoctype(slug)
+		if (!meta?.workflow) return ''
+
+		const record = this.getRecordById(slug, recordId)
+		const status = record?.get('status') as string | undefined
+
+		const initialState =
+			typeof meta.workflow.initial === 'string'
+				? meta.workflow.initial
+				: Object.keys(meta.workflow.states ?? {})[0] ?? ''
+
+		return status || initialState
+	}
 }

package/src/stores/operation-log.ts

@@ -491,7 +491,6 @@ export const useOperationLogStore = defineStore('hst-operation-log', () => {
 		broadcastChannel = new BroadcastChannel('stonecrop-operation-log')
 
 		broadcastChannel.addEventListener('message', (event: MessageEvent) => {
-			// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
 			const rawMessage = event.data
 
 			if (!rawMessage || typeof rawMessage !== 'object') return
@@ -572,9 +571,7 @@ export const useOperationLogStore = defineStore('hst-operation-log', () => {
 		serializer: {
 			read: (v: string) => {
 				try {
-					// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
 					const data = JSON.parse(v)
-					// eslint-disable-next-line @typescript-eslint/no-unsafe-return
 					return data
 				} catch {
 					return null