pict-section-workspace 1.0.0 → 1.0.2

package/README.md

@@ -80,6 +80,8 @@ libWorkspace.registerWorkspaceRoutes(_Pict.providers.ApplicationRouter, OrderWor
 - [createWorkspace](https://fable-retold.github.io/pict-section-workspace/#/page/api/createWorkspace)
 - [registerWorkspaceRoutes](https://fable-retold.github.io/pict-section-workspace/#/page/api/registerWorkspaceRoutes)
 - [setDefaultDestination](https://fable-retold.github.io/pict-section-workspace/#/page/api/setDefaultDestination)
+- [setDefaultRestClientName](https://fable-retold.github.io/pict-section-workspace/#/page/api/setDefaultRestClientName)
+- [setAssociationEditorLib](https://fable-retold.github.io/pict-section-workspace/#/page/api/setAssociationEditorLib)
 - [Base Provider](https://fable-retold.github.io/pict-section-workspace/#/page/api/provider)
 
 ## Ecosystem

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pict-section-workspace",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "A declarative, config-driven tabbed workspace for a single entity record: a header, a tab bar, and per-tab content resolvers (overview / render / embed / assoc / childlist), plus view/edit/create modes and GUID-bridge routing.",
     "main": "source/Pict-Section-Workspace.js",
     "scripts": {
@@ -12,8 +12,13 @@
         "types": "tsc -p ."
     },
     "types": "types/Pict-Section-Workspace.d.ts",
-    "files": [ "source", "types" ],
-    "directories": { "test": "test" },
+    "files": [
+        "source",
+        "types"
+    ],
+    "directories": {
+        "test": "test"
+    },
     "repository": {
         "type": "git",
         "url": "git+https://github.com/fable-retold/pict-section-workspace.git"
@@ -35,13 +40,18 @@
     },
     "mocha": {
         "diff": true,
-        "extension": [ "js" ],
+        "extension": [
+            "js"
+        ],
         "package": "./package.json",
         "reporter": "spec",
         "slow": "75",
         "timeout": "5000",
         "ui": "tdd",
-        "watch-files": [ "source/**/*.js", "test/**/*.js" ]
+        "watch-files": [
+            "source/**/*.js",
+            "test/**/*.js"
+        ]
     },
     "dependencies": {
         "pict-provider": "^1.0.13",

package/source/Pict-Section-Workspace-Provider.js

@@ -10,6 +10,19 @@ let libRecordSetAssociationEditor = null;
 try { libRecordSetAssociationEditor = require([ 'pict-section-recordset', 'source/views/associate/RecordSet-AssociationEditor.js' ].join('/')); }
 catch (pError) { /* assoc tabs unavailable without pict-section-recordset */ }
 
+// Host-settable defaults. These let an application wire the framework ONCE (next to `setDefaultDestination`)
+// instead of threading the same value through every workspace config:
+//   - DEFAULT_REST_CLIENT_NAME: which fable service speaks to the record API. A host that registers its client
+//     under a name other than `RestClient` (and may also have a differently-based `RestClient` registered) sets
+//     this so the base resolves the right one — otherwise the read hits the wrong base URL.
+//   - libRecordSetAssociationEditor: the base association editor. The optional require above is written as a
+//     computed path so bundlers/typecheckers treat pict-section-recordset as runtime-only; some bundlers
+//     (e.g. browserify) will not include a computed require at all, leaving it null and breaking every assoc
+//     tab. `setAssociationEditorLib()` lets such a host inject the editor it already bundles.
+let DEFAULT_REST_CLIENT_NAME = 'RestClient';
+function setDefaultRestClientName(pName) { if (pName && (typeof pName === 'string')) { DEFAULT_REST_CLIENT_NAME = pName; } }
+function setAssociationEditorLib(pLib) { if (pLib) { libRecordSetAssociationEditor = pLib; } }
+
 /**
  * pict-section-workspace base provider — owns everything every entity workspace shares: the REST + format helpers,
  * the GUID-bridge loader, tab routing, permissions, the shell render (header + tab bar + body panel), and the four
@@ -60,9 +73,9 @@ class PictSectionWorkspaceProvider extends libPictProvider
 
 	// --- REST + helpers --------------------------------------------------------------------------------------
 	/** Name of the fable service that speaks to the record API (getJSON/putJSON/postJSON). Override per workspace
-	 *  via config `RestClientName`; defaults to `RestClient`. Falls back to a couple of common names so a host that
-	 *  registered its client under a different name still resolves. */
-	get restClientName() { return this.workspaceConfig.RestClientName || 'RestClient'; }
+	 *  via config `RestClientName`, or app-wide via `setDefaultRestClientName()`; defaults to `RestClient`. Falls
+	 *  back to a couple of common names so a host that registered its client under a different name still resolves. */
+	get restClientName() { return this.workspaceConfig.RestClientName || DEFAULT_REST_CLIENT_NAME; }
 	get restClient()
 	{
 		const tmpFable = this.pict.fable || {};
@@ -415,7 +428,12 @@ class PictSectionWorkspaceProvider extends libPictProvider
 		const tmpHost = `${this.identifier}-Assoc-${pLeaf.Key}`;
 		this.pict.ContentAssignment.assignContent(pBodySel, `<div id="${tmpHost}"></div>`);
 		const tmpManager = this.pict.providers.RecordSetAssociationManager;
-		if (!libRecordSetAssociationEditor || !tmpManager || (typeof tmpManager.getAssociation !== 'function') || !tmpManager.getAssociation(pContent.ref))
+		// Resolve the editor lib first: a config `editorLib` (registered via EditorLibs) wins, otherwise the base
+		// editor (the optional pict-section-recordset peer, or whatever `setAssociationEditorLib` injected). Gate on
+		// the RESOLVED lib — not the module-level var — so an injected/per-tab editor works even when the optional
+		// require did not resolve (e.g. a bundler dropped the computed require).
+		const tmpLib = (pContent.editorLib && this.pict.__workspaceEditorLibs && this.pict.__workspaceEditorLibs[pContent.editorLib]) || libRecordSetAssociationEditor;
+		if (!tmpLib || !tmpManager || (typeof tmpManager.getAssociation !== 'function') || !tmpManager.getAssociation(pContent.ref))
 		{
 			this.pict.ContentAssignment.assignContent(pBodySel, `<div class="pw-empty"><p>Association “${this._esc(pContent.ref)}” is not registered.</p></div>`); return;
 		}
@@ -423,7 +441,6 @@ class PictSectionWorkspaceProvider extends libPictProvider
 		let tmpEditor = this.pict.views[tmpHash];
 		if (!tmpEditor)
 		{
-			const tmpLib = pContent.editorLib ? (this.pict.__workspaceEditorLibs && this.pict.__workspaceEditorLibs[pContent.editorLib]) || libRecordSetAssociationEditor : libRecordSetAssociationEditor;
 			this.pict.addView(tmpHash, Object.assign({}, tmpLib.default_configuration,
 				{ ViewIdentifier: tmpHash, AssociationHash: pContent.ref, ThisRecordSet: pContent.thisRecordSet || this.entityName, DefaultDestinationAddress: `#${tmpHost}`, PickerMode: pContent.pickerMode || 'single' },
 				pContent.editorOptions || {}), tmpLib);
@@ -458,4 +475,8 @@ class PictSectionWorkspaceProvider extends libPictProvider
 	}
 }
 
+// Host-config hooks (also re-exported from the factory index next to `setDefaultDestination`).
+PictSectionWorkspaceProvider.setDefaultRestClientName = setDefaultRestClientName;
+PictSectionWorkspaceProvider.setAssociationEditorLib = setAssociationEditorLib;
+
 module.exports = PictSectionWorkspaceProvider;

package/source/Pict-Section-Workspace.js

@@ -35,6 +35,13 @@ const { WORKSPACE_CSS } = require('./Pict-Section-Workspace-CSS.js');
 let DEFAULT_DESTINATION = '#Pict-Application-Container';
 function setDefaultDestination(pSelector) { if (pSelector) { DEFAULT_DESTINATION = pSelector; } }
 
+// App-wide config hooks that live on the provider module (symmetric with setDefaultDestination):
+//   setDefaultRestClientName(name) — the fable service the base uses for record reads/writes (default 'RestClient').
+//   setAssociationEditorLib(lib)   — inject the RecordSet association editor when the optional computed require did
+//                                    not resolve in the host's bundle (keeps kind:'assoc' tabs working).
+const setDefaultRestClientName = PictSectionWorkspaceProvider.setDefaultRestClientName;
+const setAssociationEditorLib = PictSectionWorkspaceProvider.setAssociationEditorLib;
+
 /** Register a workspace's provider + view pair with a pict application. */
 function createWorkspace(pPict, pConfig)
 {
@@ -142,6 +149,8 @@ module.exports = {
 	createWorkspace,
 	registerWorkspaceRoutes,
 	setDefaultDestination,
+	setDefaultRestClientName,
+	setAssociationEditorLib,
 	PictSectionWorkspaceProvider,
 	PictSectionWorkspaceView,
 	WORKSPACE_CSS,

package/types/Pict-Section-Workspace-Provider.d.ts

@@ -32,8 +32,8 @@ declare class PictSectionWorkspaceProvider extends libPictProvider {
     get idRecord(): number;
     get state(): any;
     /** Name of the fable service that speaks to the record API (getJSON/putJSON/postJSON). Override per workspace
-     *  via config `RestClientName`; defaults to `RestClient`. Falls back to a couple of common names so a host that
-     *  registered its client under a different name still resolves. */
+     *  via config `RestClientName`, or app-wide via `setDefaultRestClientName()`; defaults to `RestClient`. Falls
+     *  back to a couple of common names so a host that registered its client under a different name still resolves. */
     get restClientName(): any;
     get restClient(): any;
     _getJSON(pURL: any): Promise<any>;
@@ -88,5 +88,11 @@ declare class PictSectionWorkspaceProvider extends libPictProvider {
     _renderAssoc(pLeaf: any, pContent: any, pBodySel: any): void;
     _renderChildList(pLeaf: any, pContent: any, pBodySel: any): Promise<void>;
 }
+declare namespace PictSectionWorkspaceProvider {
+    export { setDefaultRestClientName };
+    export { setAssociationEditorLib };
+}
 import libPictProvider = require("pict-provider");
+declare function setDefaultRestClientName(pName: any): void;
+declare function setAssociationEditorLib(pLib: any): void;
 //# sourceMappingURL=Pict-Section-Workspace-Provider.d.ts.map

package/types/Pict-Section-Workspace-Provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Section-Workspace-Provider.d.ts","sourceRoot":"","sources":["../source/Pict-Section-Workspace-Provider.js"],"names":[],"mappings":";AAYA;;;;;;;;GAQG;AACH;IAEC,2DAUC;IALA,aAAmB;IACnB,YAAY;IACZ,gBAAsB;IACtB,cAAmB;IACnB,iCAA0C;IAI3C,2BAAoE;IACpE,sBAA4D;IAC5D,sBAA6D;IAC7D,mBAAuF;IACvF,sBAA4F;IAC5F,qBAA6F;IAC7F,4BAA6H;IAC7H;wHACoH;IACpH,uBAAiF;IAEjF,gCAAmE;IACnE,2BAAyD;IACzD,gBAAuD;IACvD,kBAA2C;IAC3C,uBAAmC;IAEnC,iBAKC;IAGD;;uEAEmE;IACnE,0BAAoF;IACpF,sBAIC;IACD,kCAAsL;IACtL,8CAA+N;IAC/N,+CAAiO;IACjO,wBAAwK;IAExK,gHAAgH;IAChH,gDAYC;IAGD,uBAAmI;IACnI,yCAKC;IACD,+GAA+G;IAC/G,mBAOC;IAGD,iHAAiH;IACjH,yBAAgF;IAChF,mBAAiC;IAEjC,0DA2BC;IAbC,mBAAwB;IAe1B,uDAiBC;IAED,6GAA6G;IAC7G,2CAWC;IAGD,mBAAyD;IACzD,uHAAuH;IACvH,wBAUC;IACD,mBASC;IACD,sBAAmE;IACnE,kBAAqG;IACrG,8BAA4H;IAC5H,mBAA+F;IAE/F,6BAIC;IACD,iDAKC;IACD,iCAMC;IACD,oCASC;IAGD,wBAuCC;IAED,0HAA0H;IAC1H,+BAAiH;IAEjH,6BAgBC;IAED,mBAA0L;IAC1L,sGAAsG;IACtG,iBAAwK;IACxK,iBAAiC;IAEjC,uFAAuF;IACvF,oBAA2C;IAE3C,0BAoBC;IAED,2GAA2G;IAC3G,oCAmBC;IAGD,qCAoBC;IAGD,+DAWC;IAGD,oBAAiL;IACjL,iCAAsI;IACtI,4CAQC;IACD,6DAYC;IAGD,6DAwBC;IAGD,0EAkBC;CACD"}
+{"version":3,"file":"Pict-Section-Workspace-Provider.d.ts","sourceRoot":"","sources":["../source/Pict-Section-Workspace-Provider.js"],"names":[],"mappings":";AAyBA;;;;;;;;GAQG;AACH;IAEC,2DAUC;IALA,aAAmB;IACnB,YAAY;IACZ,gBAAsB;IACtB,cAAmB;IACnB,iCAA0C;IAI3C,2BAAoE;IACpE,sBAA4D;IAC5D,sBAA6D;IAC7D,mBAAuF;IACvF,sBAA4F;IAC5F,qBAA6F;IAC7F,4BAA6H;IAC7H;wHACoH;IACpH,uBAAiF;IAEjF,gCAAmE;IACnE,2BAAyD;IACzD,gBAAuD;IACvD,kBAA2C;IAC3C,uBAAmC;IAEnC,iBAKC;IAGD;;uHAEmH;IACnH,0BAAgG;IAChG,sBAIC;IACD,kCAAsL;IACtL,8CAA+N;IAC/N,+CAAiO;IACjO,wBAAwK;IAExK,gHAAgH;IAChH,gDAYC;IAGD,uBAAmI;IACnI,yCAKC;IACD,+GAA+G;IAC/G,mBAOC;IAGD,iHAAiH;IACjH,yBAAgF;IAChF,mBAAiC;IAEjC,0DA2BC;IAbC,mBAAwB;IAe1B,uDAiBC;IAED,6GAA6G;IAC7G,2CAWC;IAGD,mBAAyD;IACzD,uHAAuH;IACvH,wBAUC;IACD,mBASC;IACD,sBAAmE;IACnE,kBAAqG;IACrG,8BAA4H;IAC5H,mBAA+F;IAE/F,6BAIC;IACD,iDAKC;IACD,iCAMC;IACD,oCASC;IAGD,wBAuCC;IAED,0HAA0H;IAC1H,+BAAiH;IAEjH,6BAgBC;IAED,mBAA0L;IAC1L,sGAAsG;IACtG,iBAAwK;IACxK,iBAAiC;IAEjC,uFAAuF;IACvF,oBAA2C;IAE3C,0BAoBC;IAED,2GAA2G;IAC3G,oCAmBC;IAGD,qCAoBC;IAGD,+DAWC;IAGD,oBAAiL;IACjL,iCAAsI;IACtI,4CAQC;IACD,6DAYC;IAGD,6DA4BC;IAGD,0EAkBC;CACD;;;;;;AArcD,4DAA4H;AAC5H,0DAA8F"}

package/types/Pict-Section-Workspace.d.ts

@@ -11,6 +11,8 @@ export function createWorkspace(pPict: any, pConfig: any): {
  */
 export function registerWorkspaceRoutes(pRouter: any, pConfig: any): void;
 export function setDefaultDestination(pSelector: any): void;
+export const setDefaultRestClientName: (pName: any) => void;
+export const setAssociationEditorLib: (pLib: any) => void;
 import PictSectionWorkspaceProvider = require("./Pict-Section-Workspace-Provider.js");
 import PictSectionWorkspaceView = require("./Pict-Section-Workspace-View.js");
 import { WORKSPACE_CSS } from "./Pict-Section-Workspace-CSS.js";

package/types/Pict-Section-Workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pict-Section-Workspace.d.ts","sourceRoot":"","sources":["../source/Pict-Section-Workspace.js"],"names":[],"mappings":"AAqCA,2EAA2E;AAC3E;;EA6BC;AAED;;;;;;GAMG;AACH,0EA8DC;AAvGD,4DAAiG"}
+{"version":3,"file":"Pict-Section-Workspace.d.ts","sourceRoot":"","sources":["../source/Pict-Section-Workspace.js"],"names":[],"mappings":"AA4CA,2EAA2E;AAC3E;;EA6BC;AAED;;;;;;GAMG;AACH,0EA8DC;AA9GD,4DAAiG;AAMjG,4DAAuF;AACvF,0DAAqF"}