pict-section-prompteditor 1.0.0 → 1.1.0

package/README.md

@@ -9,6 +9,7 @@ A prompt crafting and management section for the [Pict](https://github.com/fable
 ## Features
 
 - Typed prompts with markdown segments (Context / Request / Success Criteria and friends), plus **fixed preamble** segments for locked team standards
+- A per-prompt "segment headings in the output" toggle, saved with the prompt: on for structured documents (`## Context` above each block), off for bare bodies
 - Weighted word list matrices: `[["Tyrannosaurus", 3], ["Diplodocus", 1]]` draws 75/25, with live share percentages as you curate
 - The `{~WordListEntry:Name~}` template expression (short form `{~WLE:~}`), with an optional miss default: `{~WLE:Name:fallback~}`
 - Generation runs the **real pict template engine**, so every pict expression works inside a prompt

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pict-section-prompteditor",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"description": "Prompt crafting and management section for Pict: typed prompts with segments (context, request, success criteria), curated word list matrices with weights, a {~WordListEntry:Name~} template expression for weighted-random generation, batch generation with zip download, and a pluggable data provider that defaults to in-memory AppData.",
 	"main": "source/Pict-Section-PromptEditor.js",
 	"files": [

package/source/compiler/PromptCompiler.js

@@ -31,6 +31,12 @@ function slug(pText)
 
 /**
  * Assemble a prompt's markdown source from its type's segments.
+ *
+ * Segment headings (## Context and friends) are on by default; a prompt that
+ * carries IncludeSegmentHeadings: false compiles bare segment bodies instead,
+ * so the author decides per prompt whether the structure shows in the output.
+ * The document title heading stays governed by the IncludeTitleHeading option.
+ *
  * @param {object} pPrompt - the prompt record
  * @param {object} pType - the resolved prompt type
  * @param {object} [pOptions] - { IncludeTitleHeading: true, SegmentHeadingLevel: 2 }
@@ -40,6 +46,7 @@ function assembleSource(pPrompt, pType, pOptions)
 {
 	let tmpOptions = pOptions || {};
 	let tmpIncludeTitle = (typeof tmpOptions.IncludeTitleHeading === 'undefined') ? true : !!tmpOptions.IncludeTitleHeading;
+	let tmpIncludeSegmentHeadings = !(pPrompt && pPrompt.IncludeSegmentHeadings === false);
 	let tmpHeading = '#'.repeat(Math.max(1, Math.min(6, Number(tmpOptions.SegmentHeadingLevel) || 2)));
 	let tmpSegments = (pType && Array.isArray(pType.Segments)) ? pType.Segments : [];
 	let tmpBodies = (pPrompt && pPrompt.Segments) ? pPrompt.Segments : {};
@@ -60,7 +67,9 @@ function assembleSource(pPrompt, pType, pOptions)
 			if (tmpSegment.Optional || tmpSegment.Fixed) { continue; }
 			tmpBody = '(nothing written for this segment yet)';
 		}
-		tmpParts.push(tmpHeading + ' ' + String(tmpSegment.Name || tmpSegment.Key) + '\n\n' + tmpBody);
+		tmpParts.push(tmpIncludeSegmentHeadings
+			? (tmpHeading + ' ' + String(tmpSegment.Name || tmpSegment.Key) + '\n\n' + tmpBody)
+			: tmpBody);
 	}
 
 	return tmpParts.join('\n\n') + '\n';

package/source/providers/PromptProvider-Base.js

@@ -16,9 +16,11 @@
  *     drawn by {~WordListEntry:Name~} is weight / sum(weights).
  *
  *   Prompt     { Key, Title, TypeKey, Segments: { segmentKey: markdown },
- *                Author, Meta, CreatedAt, UpdatedAt }
+ *                IncludeSegmentHeadings, Author, Meta, CreatedAt, UpdatedAt }
  *     A crafted prompt. Segments hold the markdown for each of the prompt
- *     type's segments, keyed by segment Key. Meta is an opaque object the
+ *     type's segments, keyed by segment Key. IncludeSegmentHeadings (default
+ *     true) decides whether the compiler writes the ## segment headings above
+ *     each body in the assembled output. Meta is an opaque object the
  *     provider round-trips untouched -- the seam where a host hangs ratings,
  *     version pointers, or anything else.
  *
@@ -208,6 +210,7 @@ class InMemoryPromptProvider extends PromptDataProvider
 			Title: String(tmpDraft.Title || 'Untitled prompt'),
 			TypeKey: String(tmpDraft.TypeKey),
 			Segments: (tmpDraft.Segments && typeof tmpDraft.Segments === 'object') ? this._clone(tmpDraft.Segments) : {},
+			IncludeSegmentHeadings: (tmpDraft.IncludeSegmentHeadings === false) ? false : true,
 			Author: tmpDraft.Author || null,
 			Meta: (typeof tmpDraft.Meta === 'undefined') ? {} : this._clone(tmpDraft.Meta),
 			CreatedAt: tmpNow,
@@ -225,6 +228,7 @@ class InMemoryPromptProvider extends PromptDataProvider
 		if (typeof tmpPatch.Title !== 'undefined') { tmpPrompt.Title = String(tmpPatch.Title); }
 		if (typeof tmpPatch.TypeKey !== 'undefined') { tmpPrompt.TypeKey = String(tmpPatch.TypeKey); }
 		if (typeof tmpPatch.Segments !== 'undefined') { tmpPrompt.Segments = this._clone(tmpPatch.Segments || {}); }
+		if (typeof tmpPatch.IncludeSegmentHeadings !== 'undefined') { tmpPrompt.IncludeSegmentHeadings = (tmpPatch.IncludeSegmentHeadings === false) ? false : true; }
 		if (typeof tmpPatch.Meta !== 'undefined') { tmpPrompt.Meta = this._clone(tmpPatch.Meta); }
 		tmpPrompt.UpdatedAt = this._now();
 		return Promise.resolve(this._clone(tmpPrompt));

package/source/views/PictView-PromptEditor.js

@@ -136,6 +136,8 @@ const _DefaultConfiguration =
 		.pspe-editor-head { display: flex; gap: 8px; align-items: center; margin-bottom: 12px; flex-wrap: wrap; }
 		.pspe-editor-title { flex: 1; min-width: 200px; font-weight: 650; font-size: 15px; }
 		.pspe-type-desc { font-size: 12px; color: var(--theme-color-text-muted, #97a1ab); margin: -6px 0 12px; }
+		.pspe-editor-opts { margin: -4px 0 12px; }
+		.pspe-editor-opt { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: var(--theme-color-text-muted, #97a1ab); cursor: pointer; user-select: none; }
 
 		.pspe-segment {
 			border: 1px solid var(--theme-color-border-light, #e7ecf0); border-radius: 10px;
@@ -254,6 +256,7 @@ const _DefaultConfiguration =
 	{~TS:PromptEditor-PromptActions:Record.ActionsSlot~}
 </div>
 <div class="pspe-type-desc">{~D:Record.TypeDescription~}</div>
+{~TS:PromptEditor-EditorOptions:Record.OptionsSlot~}
 {~TS:PromptEditor-Segment:Record.Segments~}
 {~TS:PromptEditor-GenerateBar:Record.GenerateSlot~}
 {~TS:PromptEditor-PreviewPanel:Record.PreviewPanelSlot~}`
@@ -282,6 +285,17 @@ const _DefaultConfiguration =
 			Hash: 'PromptEditor-PromptActions',
 			Template: /*html*/`<button class="pspe-btn pspe-btn-sm" title="Duplicate this prompt" onclick="_Pict.views['{~D:Record.ViewHash~}'].duplicatePrompt()">Duplicate</button><button class="pspe-btn pspe-btn-sm pspe-btn-danger" onclick="_Pict.views['{~D:Record.ViewHash~}'].deletePrompt()">Delete</button>`
 		},
+		{
+			Hash: 'PromptEditor-EditorOptions',
+			Template: /*html*/`
+<div class="pspe-editor-opts">
+	<label class="pspe-editor-opt" title="When off, the assembled prompt is just the segment bodies, no ## headings above them.">
+		<input type="checkbox" {~D:Record.SegmentHeadingsChecked~}
+			onchange="_Pict.views['{~D:Record.ViewHash~}'].setSegmentHeadings(this.checked)">
+		Segment headings in the output
+	</label>
+</div>`
+		},
 		{
 			Hash: 'PromptEditor-Segment',
 			Template: /*html*/`
@@ -909,6 +923,11 @@ class PictViewPromptEditor extends libPictView
 				SelectedAttr: (pTypeOption.Key === pPrompt.TypeKey) ? 'selected' : ''
 			})),
 			ActionsSlot: pReadOnly ? [] : [{ ViewHash: this.Hash }],
+			OptionsSlot: pReadOnly ? [] :
+			[{
+				ViewHash: this.Hash,
+				SegmentHeadingsChecked: (pPrompt.IncludeSegmentHeadings === false) ? '' : 'checked'
+			}],
 			Segments: tmpSegments,
 			GenerateSlot: pReadOnly ? [] :
 			[{
@@ -1077,6 +1096,7 @@ class PictViewPromptEditor extends libPictView
 				TypeKey: tmpPrompt.TypeKey,
 				Title: tmpPrompt.Title + ' (copy)',
 				Segments: JSON.parse(JSON.stringify(tmpPrompt.Segments || {})),
+				IncludeSegmentHeadings: tmpPrompt.IncludeSegmentHeadings !== false,
 				Meta: JSON.parse(JSON.stringify(tmpPrompt.Meta || {})),
 				Author: this.options.CurrentUser
 			})
@@ -1123,6 +1143,24 @@ class PictViewPromptEditor extends libPictView
 			.catch((pError) => this._toast('Segment save failed: ' + pError.message, 'error'));
 	}
 
+	// The per-prompt "segment headings in the output" toggle: saves with the
+	// prompt, and the compiler reads it on every assemble (preview, generate,
+	// zip). No re-render needed - the checkbox itself holds the new state -
+	// but an open preview re-rolls so what you see matches what you would get.
+	setSegmentHeadings(pChecked)
+	{
+		let tmpPrompt = this._activePrompt();
+		if (!tmpPrompt) { return; }
+		tmpPrompt.IncludeSegmentHeadings = !!pChecked;
+		this._provider.updatePrompt(tmpPrompt.Key, { IncludeSegmentHeadings: !!pChecked })
+			.then((pSaved) =>
+			{
+				this._fire('onPromptSaved', pSaved);
+				if (this._ui.Preview && this._ui.Preview.PromptKey === tmpPrompt.Key) { this.previewOnce(); }
+			})
+			.catch((pError) => this._toast('Save failed: ' + pError.message, 'error'));
+	}
+
 	toggleSegmentPreview(pSegmentKey)
 	{
 		let tmpPrompt = this._activePrompt();