@contractspec/bundle.marketing 3.8.9 → 3.8.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/.turbo/turbo-build.log +54 -42
  2. package/CHANGELOG.md +33 -0
  3. package/dist/browser/components/templates/TemplatesBrowseControls.js +37 -22
  4. package/dist/browser/components/templates/TemplatesCatalogSection.js +29 -6
  5. package/dist/browser/components/templates/TemplatesClientPage.js +269 -89
  6. package/dist/browser/components/templates/TemplatesOverlays.js +2874 -0
  7. package/dist/browser/components/templates/index.js +301 -121
  8. package/dist/browser/components/templates/template-catalog.js +5 -3
  9. package/dist/browser/components/templates/template-filters.js +99 -0
  10. package/dist/browser/components/templates/template-tag-visibility.js +40 -0
  11. package/dist/browser/components/templates/useTemplateBrowseState.js +191 -0
  12. package/dist/browser/index.js +301 -121
  13. package/dist/components/templates/TemplatesBrowseControls.d.ts +7 -2
  14. package/dist/components/templates/TemplatesBrowseControls.js +37 -22
  15. package/dist/components/templates/TemplatesCatalogSection.d.ts +4 -1
  16. package/dist/components/templates/TemplatesCatalogSection.js +29 -6
  17. package/dist/components/templates/TemplatesClientPage.js +269 -89
  18. package/dist/components/templates/TemplatesOverlays.d.ts +10 -0
  19. package/dist/components/templates/TemplatesOverlays.js +2869 -0
  20. package/dist/components/templates/index.js +301 -121
  21. package/dist/components/templates/template-catalog.d.ts +1 -0
  22. package/dist/components/templates/template-catalog.js +5 -3
  23. package/dist/components/templates/template-filters.d.ts +12 -0
  24. package/dist/components/templates/template-filters.js +94 -0
  25. package/dist/components/templates/template-tag-visibility.d.ts +10 -0
  26. package/dist/components/templates/template-tag-visibility.js +35 -0
  27. package/dist/components/templates/useTemplateBrowseState.d.ts +22 -0
  28. package/dist/components/templates/useTemplateBrowseState.js +186 -0
  29. package/dist/index.js +301 -121
  30. package/dist/node/components/templates/TemplatesBrowseControls.js +37 -22
  31. package/dist/node/components/templates/TemplatesCatalogSection.js +29 -6
  32. package/dist/node/components/templates/TemplatesClientPage.js +269 -89
  33. package/dist/node/components/templates/TemplatesOverlays.js +2869 -0
  34. package/dist/node/components/templates/index.js +301 -121
  35. package/dist/node/components/templates/template-catalog.js +5 -3
  36. package/dist/node/components/templates/template-filters.js +94 -0
  37. package/dist/node/components/templates/template-tag-visibility.js +35 -0
  38. package/dist/node/components/templates/useTemplateBrowseState.js +186 -0
  39. package/dist/node/index.js +301 -121
  40. package/package.json +82 -26
  41. package/src/components/templates/TemplatesBrowseControls.tsx +59 -35
  42. package/src/components/templates/TemplatesCatalogSection.tsx +29 -4
  43. package/src/components/templates/TemplatesClientPage.tsx +41 -97
  44. package/src/components/templates/TemplatesOverlays.tsx +65 -0
  45. package/src/components/templates/template-catalog.test.ts +96 -0
  46. package/src/components/templates/template-catalog.ts +14 -6
  47. package/src/components/templates/template-filters.ts +57 -0
  48. package/src/components/templates/template-tag-visibility.ts +58 -0
  49. package/src/components/templates/useTemplateBrowseState.ts +101 -0
@@ -38,15 +38,16 @@ function buildLocalTemplateCatalog(examples = listExamples(), templates = listTe
38
38
  }).sort(compareLocalTemplateCatalogItems);
39
39
  }
40
40
  function matchesTemplateFilters(template, search, selectedTag) {
41
+ return matchesTemplateSearch(template, search) && (selectedTag === null || template.tags.includes(selectedTag));
42
+ }
43
+ function matchesTemplateSearch(template, search) {
41
44
  const haystack = [
42
45
  template.title,
43
46
  template.description,
44
47
  template.tags.join(" ")
45
48
  ].join(" ").toLowerCase();
46
49
  const searchTokens = search.trim().toLowerCase().split(/\s+/).filter(Boolean);
47
- const matchesSearch = searchTokens.length === 0 || searchTokens.every((token) => haystack.includes(token));
48
- const matchesTag = selectedTag === null || template.tags.includes(selectedTag);
49
- return matchesSearch && matchesTag;
50
+ return searchTokens.length === 0 || searchTokens.every((token) => haystack.includes(token));
50
51
  }
51
52
  function formatExampleKindLabel(kind) {
52
53
  return kind.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
@@ -69,6 +70,7 @@ function compareLocalTemplateCatalogItems(left, right) {
69
70
  return left.title.localeCompare(right.title);
70
71
  }
71
72
  export {
73
+ matchesTemplateSearch,
72
74
  matchesTemplateFilters,
73
75
  formatStabilityLabel,
74
76
  formatExampleKindLabel,
@@ -0,0 +1,94 @@
1
+ import { createRequire } from "node:module";
2
+ var __require = /* @__PURE__ */ createRequire(import.meta.url);
3
+
4
+ // src/components/templates/template-new.ts
5
+ var NEW_TEMPLATE_IDS = [
6
+ "minimal",
7
+ "messaging-agent-actions",
8
+ "policy-safe-knowledge-assistant",
9
+ "visualization-showcase"
10
+ ];
11
+ var NEW_TEMPLATE_ID_SET = new Set(NEW_TEMPLATE_IDS);
12
+ function isNewTemplateId(templateId) {
13
+ return NEW_TEMPLATE_ID_SET.has(templateId);
14
+ }
15
+
16
+ // src/components/templates/template-catalog.ts
17
+ import { listExamples, listTemplates } from "@contractspec/module.examples";
18
+ var NEW_TEMPLATE_INDEX = new Map(NEW_TEMPLATE_IDS.map((templateId, index) => [templateId, index]));
19
+ function buildLocalTemplateCatalog(examples = listExamples(), templates = listTemplates()) {
20
+ const templatesById = new Map(templates.map((template) => [template.id, template]));
21
+ return examples.filter((example) => example.meta.visibility === "public" && example.surfaces.templates).map((example) => {
22
+ const template = templatesById.get(example.meta.key);
23
+ const tags = Array.from(new Set(example.meta.tags.map((tag) => tag.trim()).filter(Boolean))).sort((left, right) => left.localeCompare(right));
24
+ return {
25
+ id: example.meta.key,
26
+ title: example.meta.title ?? template?.name ?? example.meta.key,
27
+ description: example.meta.summary ?? example.meta.description,
28
+ tags,
29
+ kind: example.meta.kind,
30
+ stability: example.meta.stability,
31
+ previewUrl: template?.preview?.demoUrl ?? `/sandbox?template=${encodeURIComponent(example.meta.key)}`,
32
+ featureList: [...template?.features ?? []],
33
+ sandboxModes: example.surfaces.sandbox.modes,
34
+ renderTargets: [...template?.renderTargets ?? []],
35
+ isNew: isNewTemplateId(example.meta.key),
36
+ packageName: example.entrypoints.packageName
37
+ };
38
+ }).sort(compareLocalTemplateCatalogItems);
39
+ }
40
+ function matchesTemplateFilters(template, search, selectedTag) {
41
+ return matchesTemplateSearch(template, search) && (selectedTag === null || template.tags.includes(selectedTag));
42
+ }
43
+ function matchesTemplateSearch(template, search) {
44
+ const haystack = [
45
+ template.title,
46
+ template.description,
47
+ template.tags.join(" ")
48
+ ].join(" ").toLowerCase();
49
+ const searchTokens = search.trim().toLowerCase().split(/\s+/).filter(Boolean);
50
+ return searchTokens.length === 0 || searchTokens.every((token) => haystack.includes(token));
51
+ }
52
+ function formatExampleKindLabel(kind) {
53
+ return kind.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
54
+ }
55
+ function formatStabilityLabel(stability) {
56
+ return stability.split("_").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
57
+ }
58
+ function compareLocalTemplateCatalogItems(left, right) {
59
+ const leftNewIndex = NEW_TEMPLATE_INDEX.get(left.id);
60
+ const rightNewIndex = NEW_TEMPLATE_INDEX.get(right.id);
61
+ if (leftNewIndex !== undefined || rightNewIndex !== undefined) {
62
+ if (leftNewIndex === undefined) {
63
+ return 1;
64
+ }
65
+ if (rightNewIndex === undefined) {
66
+ return -1;
67
+ }
68
+ return leftNewIndex - rightNewIndex;
69
+ }
70
+ return left.title.localeCompare(right.title);
71
+ }
72
+
73
+ // src/components/templates/template-filters.ts
74
+ function buildTemplateFilterState(templates, search, selectedTag, getCandidate) {
75
+ const searchScopedTemplates = templates.filter((template) => matchesTemplateSearch(getCandidate(template), search));
76
+ const finalTemplates = selectedTag === null ? searchScopedTemplates : searchScopedTemplates.filter((template) => getCandidate(template).tags.includes(selectedTag));
77
+ return {
78
+ searchScopedTemplates,
79
+ finalTemplates,
80
+ tagFacets: buildTemplateTagFacets(searchScopedTemplates, getCandidate)
81
+ };
82
+ }
83
+ function buildTemplateTagFacets(templates, getCandidate) {
84
+ const counts = new Map;
85
+ for (const template of templates) {
86
+ for (const tag of new Set(getCandidate(template).tags)) {
87
+ counts.set(tag, (counts.get(tag) ?? 0) + 1);
88
+ }
89
+ }
90
+ return [...counts.entries()].map(([tag, count]) => ({ tag, count })).sort((left, right) => right.count - left.count || left.tag.localeCompare(right.tag));
91
+ }
92
+ export {
93
+ buildTemplateFilterState
94
+ };
@@ -0,0 +1,35 @@
1
+ import { createRequire } from "node:module";
2
+ var __require = /* @__PURE__ */ createRequire(import.meta.url);
3
+
4
+ // src/components/templates/template-tag-visibility.ts
5
+ var DEFAULT_VISIBLE_TEMPLATE_TAGS = 10;
6
+ function getVisibleTemplateTagFacets(tagFacets, selectedTag, expanded, visibleCount = DEFAULT_VISIBLE_TEMPLATE_TAGS) {
7
+ if (expanded) {
8
+ return {
9
+ visibleTagFacets: pinSelectedTagFacet(tagFacets, selectedTag),
10
+ hiddenTagFacets: []
11
+ };
12
+ }
13
+ const visibleTagFacets = pinSelectedTagFacet(tagFacets.slice(0, visibleCount), selectedTag, tagFacets);
14
+ const visibleTags = new Set(visibleTagFacets.map((facet) => facet.tag));
15
+ return {
16
+ visibleTagFacets,
17
+ hiddenTagFacets: tagFacets.filter((facet) => !visibleTags.has(facet.tag))
18
+ };
19
+ }
20
+ function pinSelectedTagFacet(tagFacets, selectedTag, fallbackTagFacets = tagFacets) {
21
+ if (selectedTag === null || tagFacets.some((facet) => facet.tag === selectedTag)) {
22
+ return [...tagFacets];
23
+ }
24
+ return [
25
+ ...tagFacets,
26
+ fallbackTagFacets.find((facet) => facet.tag === selectedTag) ?? {
27
+ tag: selectedTag,
28
+ count: 0
29
+ }
30
+ ];
31
+ }
32
+ export {
33
+ getVisibleTemplateTagFacets,
34
+ DEFAULT_VISIBLE_TEMPLATE_TAGS
35
+ };
@@ -0,0 +1,186 @@
1
+ import { createRequire } from "node:module";
2
+ var __require = /* @__PURE__ */ createRequire(import.meta.url);
3
+
4
+ // src/components/templates/template-new.ts
5
+ var NEW_TEMPLATE_IDS = [
6
+ "minimal",
7
+ "messaging-agent-actions",
8
+ "policy-safe-knowledge-assistant",
9
+ "visualization-showcase"
10
+ ];
11
+ var NEW_TEMPLATE_ID_SET = new Set(NEW_TEMPLATE_IDS);
12
+ function isNewTemplateId(templateId) {
13
+ return NEW_TEMPLATE_ID_SET.has(templateId);
14
+ }
15
+
16
+ // src/components/templates/template-catalog.ts
17
+ import { listExamples, listTemplates } from "@contractspec/module.examples";
18
+ var NEW_TEMPLATE_INDEX = new Map(NEW_TEMPLATE_IDS.map((templateId, index) => [templateId, index]));
19
+ function buildLocalTemplateCatalog(examples = listExamples(), templates = listTemplates()) {
20
+ const templatesById = new Map(templates.map((template) => [template.id, template]));
21
+ return examples.filter((example) => example.meta.visibility === "public" && example.surfaces.templates).map((example) => {
22
+ const template = templatesById.get(example.meta.key);
23
+ const tags = Array.from(new Set(example.meta.tags.map((tag) => tag.trim()).filter(Boolean))).sort((left, right) => left.localeCompare(right));
24
+ return {
25
+ id: example.meta.key,
26
+ title: example.meta.title ?? template?.name ?? example.meta.key,
27
+ description: example.meta.summary ?? example.meta.description,
28
+ tags,
29
+ kind: example.meta.kind,
30
+ stability: example.meta.stability,
31
+ previewUrl: template?.preview?.demoUrl ?? `/sandbox?template=${encodeURIComponent(example.meta.key)}`,
32
+ featureList: [...template?.features ?? []],
33
+ sandboxModes: example.surfaces.sandbox.modes,
34
+ renderTargets: [...template?.renderTargets ?? []],
35
+ isNew: isNewTemplateId(example.meta.key),
36
+ packageName: example.entrypoints.packageName
37
+ };
38
+ }).sort(compareLocalTemplateCatalogItems);
39
+ }
40
+ function matchesTemplateFilters(template, search, selectedTag) {
41
+ return matchesTemplateSearch(template, search) && (selectedTag === null || template.tags.includes(selectedTag));
42
+ }
43
+ function matchesTemplateSearch(template, search) {
44
+ const haystack = [
45
+ template.title,
46
+ template.description,
47
+ template.tags.join(" ")
48
+ ].join(" ").toLowerCase();
49
+ const searchTokens = search.trim().toLowerCase().split(/\s+/).filter(Boolean);
50
+ return searchTokens.length === 0 || searchTokens.every((token) => haystack.includes(token));
51
+ }
52
+ function formatExampleKindLabel(kind) {
53
+ return kind.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
54
+ }
55
+ function formatStabilityLabel(stability) {
56
+ return stability.split("_").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
57
+ }
58
+ function compareLocalTemplateCatalogItems(left, right) {
59
+ const leftNewIndex = NEW_TEMPLATE_INDEX.get(left.id);
60
+ const rightNewIndex = NEW_TEMPLATE_INDEX.get(right.id);
61
+ if (leftNewIndex !== undefined || rightNewIndex !== undefined) {
62
+ if (leftNewIndex === undefined) {
63
+ return 1;
64
+ }
65
+ if (rightNewIndex === undefined) {
66
+ return -1;
67
+ }
68
+ return leftNewIndex - rightNewIndex;
69
+ }
70
+ return left.title.localeCompare(right.title);
71
+ }
72
+
73
+ // src/components/templates/template-filters.ts
74
+ function buildTemplateFilterState(templates, search, selectedTag, getCandidate) {
75
+ const searchScopedTemplates = templates.filter((template) => matchesTemplateSearch(getCandidate(template), search));
76
+ const finalTemplates = selectedTag === null ? searchScopedTemplates : searchScopedTemplates.filter((template) => getCandidate(template).tags.includes(selectedTag));
77
+ return {
78
+ searchScopedTemplates,
79
+ finalTemplates,
80
+ tagFacets: buildTemplateTagFacets(searchScopedTemplates, getCandidate)
81
+ };
82
+ }
83
+ function buildTemplateTagFacets(templates, getCandidate) {
84
+ const counts = new Map;
85
+ for (const template of templates) {
86
+ for (const tag of new Set(getCandidate(template).tags)) {
87
+ counts.set(tag, (counts.get(tag) ?? 0) + 1);
88
+ }
89
+ }
90
+ return [...counts.entries()].map(([tag, count]) => ({ tag, count })).sort((left, right) => right.count - left.count || left.tag.localeCompare(right.tag));
91
+ }
92
+
93
+ // src/components/templates/template-source.ts
94
+ function isRegistryConfigured(registryUrl) {
95
+ return Boolean(registryUrl?.trim());
96
+ }
97
+ function getAvailableTemplateSources(registryUrl) {
98
+ return isRegistryConfigured(registryUrl) ? ["local", "registry"] : ["local"];
99
+ }
100
+
101
+ // src/components/templates/template-tag-visibility.ts
102
+ var DEFAULT_VISIBLE_TEMPLATE_TAGS = 10;
103
+ function getVisibleTemplateTagFacets(tagFacets, selectedTag, expanded, visibleCount = DEFAULT_VISIBLE_TEMPLATE_TAGS) {
104
+ if (expanded) {
105
+ return {
106
+ visibleTagFacets: pinSelectedTagFacet(tagFacets, selectedTag),
107
+ hiddenTagFacets: []
108
+ };
109
+ }
110
+ const visibleTagFacets = pinSelectedTagFacet(tagFacets.slice(0, visibleCount), selectedTag, tagFacets);
111
+ const visibleTags = new Set(visibleTagFacets.map((facet) => facet.tag));
112
+ return {
113
+ visibleTagFacets,
114
+ hiddenTagFacets: tagFacets.filter((facet) => !visibleTags.has(facet.tag))
115
+ };
116
+ }
117
+ function pinSelectedTagFacet(tagFacets, selectedTag, fallbackTagFacets = tagFacets) {
118
+ if (selectedTag === null || tagFacets.some((facet) => facet.tag === selectedTag)) {
119
+ return [...tagFacets];
120
+ }
121
+ return [
122
+ ...tagFacets,
123
+ fallbackTagFacets.find((facet) => facet.tag === selectedTag) ?? {
124
+ tag: selectedTag,
125
+ count: 0
126
+ }
127
+ ];
128
+ }
129
+
130
+ // src/components/templates/useTemplateBrowseState.ts
131
+ import { useRegistryTemplates } from "@contractspec/lib.example-shared-ui";
132
+ import { useEffect, useMemo, useState } from "react";
133
+ "use client";
134
+ var REGISTRY_URL = process.env.NEXT_PUBLIC_CONTRACTSPEC_REGISTRY_URL;
135
+ function useTemplateBrowseState() {
136
+ const [selectedTag, setSelectedTag] = useState(null);
137
+ const [search, setSearch] = useState("");
138
+ const [source, setSource] = useState("local");
139
+ const [showAllTags, setShowAllTags] = useState(false);
140
+ const registryConfigured = isRegistryConfigured(REGISTRY_URL);
141
+ const availableSources = getAvailableTemplateSources(REGISTRY_URL);
142
+ const localTemplates = useMemo(() => buildLocalTemplateCatalog(), []);
143
+ const localTemplateById = useMemo(() => new Map(localTemplates.map((template) => [template.id, template])), [localTemplates]);
144
+ const { data: registryTemplates = [], isLoading: registryLoading } = useRegistryTemplates();
145
+ const localFilterState = useMemo(() => buildTemplateFilterState(localTemplates, search, selectedTag, (template) => ({
146
+ title: template.title,
147
+ description: template.description,
148
+ tags: template.tags
149
+ })), [localTemplates, search, selectedTag]);
150
+ const registryFilterState = useMemo(() => buildTemplateFilterState(registryTemplates, search, selectedTag, (template) => ({
151
+ title: template.name,
152
+ description: template.description,
153
+ tags: template.tags
154
+ })), [registryTemplates, search, selectedTag]);
155
+ const activeFilterState = source === "registry" ? registryFilterState : localFilterState;
156
+ const suppressTagRail = source === "registry" && (registryLoading || registryTemplates.length === 0);
157
+ const { visibleTagFacets, hiddenTagFacets } = useMemo(() => getVisibleTemplateTagFacets(activeFilterState.tagFacets, selectedTag, showAllTags), [activeFilterState.tagFacets, selectedTag, showAllTags]);
158
+ const showTagFilters = !suppressTagRail && (visibleTagFacets.length > 0 || hiddenTagFacets.length > 0);
159
+ useEffect(() => {
160
+ setShowAllTags(false);
161
+ }, [search, showTagFilters, source]);
162
+ return {
163
+ selectedTag,
164
+ setSelectedTag,
165
+ search,
166
+ setSearch,
167
+ source,
168
+ setSource,
169
+ showAllTags,
170
+ setShowAllTags,
171
+ registryConfigured,
172
+ availableSources,
173
+ localTemplates,
174
+ localTemplateById,
175
+ registryTemplates,
176
+ registryLoading,
177
+ localFilterState,
178
+ registryFilterState,
179
+ visibleTagFacets,
180
+ hiddenTagFacets,
181
+ showTagFilters
182
+ };
183
+ }
184
+ export {
185
+ useTemplateBrowseState
186
+ };